homeport — 特定サイトの通信を住宅IPプロキシへ振り分けるルーティング構成ツール
0xkaka/homeport
★ 587 ・ HTML
概要
homeport は、Claude や Google、Stripe などのアクセス元 IP に敏感な Web サービスへ接続する際、すべての端末から同一の「固定住宅プロキシ(Static Residential IP)」を経由させるためのルーティング構成スクリプト群です。
データセンターなどの共有プロキシや頻繁に IP アドレスが切り替わる環境からアクセスすると、認証の要求や決済エラー、アカウント停止といったセキュリティ制限にかかるケースがあります。homeport は、指定された対象ドメインへの通信のみを固定住宅プロキシへ振り分け、その他の一般的な通信は普段使用している通常のプロキシ経路のまま維持する構成を簡単に作成・導入できるように設計されています。複数デバイスから同一の出口 IP で AI ツールや決済サービスを利用したいユーザーに向いています。
主な特徴
-
対象サービスのみを住宅プロキシへ分離
Claude や Google、Stripe といったリスク検知の厳しいサービスのみを固定住宅プロキシ経由にし、通常の Web ブラウジングは一般的なプロキシ経路のまま運用できます。 -
中継(踏み台)ノードを挟む二段構成
住宅プロキシへ直接接続するのではなく、手元の通常プロキシノードを経由して住宅プロキシに接続する連鎖ルーティングを採用しており、接続の安定化を図っています。 -
Web ベースの一括設定ジェネレーターを提供
GitHub Pages 上で動作する設定ツールが用意されており、プロキシの接続情報(ホスト、ポート、認証情報)を入力するだけで各クライアント向けのスクリプトや設定用リンクを生成できます。 -
主要なマルチプラットフォームクライアントに対応
macOS や Windows で利用される Clash Verge Rev や Clash Party、Android 向けの FlClash、iOS / iPadOS / macOS 向けの Shadowrocket など、幅広くサポートしています。 -
Claude の IPv6 トラブルを自動回避
住宅プロキシ経由で Claude にアクセスする際にエラー(502)が発生しやすい IPv6 通信をルール側で遮断し、自動的に IPv4 でフォールバックさせる設定があらかじめ組み込まれています。
使い方
最も手軽な方法は、GitHub Pages で提供されている Web 設定ツールを利用する手順です。
1. 住宅プロキシ情報の準備
あらかじめ外部のプロキシサービス等で取得した、固定住宅プロキシ(Static Residential、HTTP または SOCKS5)の接続情報を用意します。
- ホスト(Proxy Address)
- ポート番号
- ユーザー名
- パスワード
2. 設定ツールの利用
Web ブラウザで https://0xkaka.github.io/homeport/ にアクセスし、以下の手順を実行します。
- 画面の入力欄に住宅プロキシのホスト、ポート、ユーザー名、パスワードを入力します(README によると、認証情報はブラウザ内でのみ処理され、外部には送信されません)。
- 使用するデバイスおよびクライアントソフト(Clash Verge Rev、Clash Party、FlClash、Shadowrocket 等)を選択します。
- 生成されたスクリプトをコピーするか、Shadowrocket の場合は QR コードやリンク経由でインポートします。
3. クライアント側の設定(Clash Verge Rev の例)
手動またはジェネレーターで生成した JavaScript スクリプトを Clash クライアントへ組み込みます。
- Clash Verge Rev の「サブスクリプション(Subscriptions)」画面を開きます。
- 利用中のプロキシ構成カードを右クリックし、「拡張スクリプト(Extension Script)」を開きます。
- エディタの内容を削除し、生成されたスクリプトを貼り付けて保存します。
- サブスクリプションカードを再読み込みし、ルーティングモードを「ルール(Rule)」に設定します。
- システムプロキシを有効化します。Claude などのデスクトップアプリにも適用させたい場合は TUN(仮想 NIC)モードを有効にします。
// スクリプト内で設定される住宅プロキシ情報の定義例
const HOME = {
server: "p.webshare.io",
port: 80,
username: "abcd1234-1",
password: "xyz789",
};
4. 接続の確認
各端末のブラウザやターミナルから https://ipv4.webshare.io/ などの確認用エンドポイントにアクセスし、表示される IP アドレスが住宅プロキシの出口 IP と一致しているか確認します。
# macOS(Clash Party / Clash Verge Rev 等のローカルプロキシ経由)
curl -x http://127.0.0.1:7890 https://ipv4.webshare.io/
# Windows PowerShell(ポート番号は環境設定に合わせる)
curl.exe -x http://127.0.0.1:7897 https://ipv4.webshare.io/
技術的なポイント
-
プロキシ連鎖(Proxy Chaining)による接続安定化
住宅プロキシへのハンドシェイクを安定させるため、クライアントが直接住宅プロキシを叩くのではなく、「端末 → 通常のプロキシノード(中継) → 住宅プロキシ(出口) → ターゲット Web サイト」という連鎖構造をプロキシソフトのルーティングルール側で構成しています。中継ノードを変更しても、最終的な出口 IP は住宅プロキシ側の IP に固定されます。 -
Clash の JavaScript 拡張(Override)を活用した構成注入
Clash 互換クライアント(Clash Verge Rev、Clash Party、FlClash)向けには、設定ファイルを直接書き換えるのではなく JavaScript のオーバーライド機構を利用して動的にプロキシーノードとルーティングルールを追加する設計になっています。これにより、基盤となるプロキシサブスクリプションの自動更新を妨げずに運用できます。 -
Shadowrocket 用のモジュール構成
iOS 向けの Shadowrocket では、ルール部分を外部.moduleファイルとして切り離し、認証情報を含む住宅プロキシノードのみをローカルに保持する構造を採用しています。モジュールを更新しても接続設定が上書きされないように配慮されています。 -
UDP / QUIC 迂回の抑制
Google Chrome 等のブラウザでは QUIC(HTTP/3)プロトコルが使用されると UDP 経由でプロキシ設定が意図せずバイパスされることがあるため、README ではブラウザ側の QUIC 無効化(chrome://flags/#enable-quic)手順についても言及されています。
注意点
-
ライセンスの明記なし
リポジトリには 2026 年 11 月時点で LICENSE ファイルが含まれておらず、ライセンス形態は不明です。業務用途や再配布を行う際は取り扱いに注意が必要です。 -
別途プロキシ契約が必要
本ツール単体でプロキシサービスを提供するものではありません。動作には既存のプロキシ契約および外部の固定住宅プロキシ(Static Residential Proxy)契約が別途必要となります。 -
ポート番号とクライアント依存の差異
使用するクライアントによってデフォルトの混在ポート(Mixed Port)が異なります(例: Clash Verge Rev は 7897、標準的な Clash は 7890 など)。接続確認や CLI からの利用時にはポート設定の確認が必要です。 -
「住宅出口」ノードを直接選択しない運用規則
ルーティングの仕組み上、生成された「住宅出口」プロキシをクライアントの主ノードとして手動選択すると全トラフィックが住宅プロキシ経由となり、通信制限や接続不能に陥る可能性があります。常にルール(Rule)モードで運用し、選択ノードは中継用ノードに設定しておく必要があります。
まとめ
homeport は、Claude や Stripe といった IP アドレスの変動に厳しい Web サービスへの接続を、固定の住宅プロキシ経由に自動集約するルーティング構成ツールです。Clash 系の JavaScript 拡張や Shadowrocket モジュールを活用することで、普段のネットワーク環境を維持しながら必要な通信のみを柔軟に迂回させることができます。





