Repolode
YTwsy

YTwsy/OpenSurge-for-Mac

MacをSurge風の透過プロキシにするmacOS用ゲートウェイアプリ。デバイスごとのルーティングに対応し、dnsmasqでDHCP/DNS、mihomoでプロキシ処理を行います。

代替できる製品:Surge

スター
2,603
フォーク
184
未解決の Issue
10
最終コミット
3 日前

これは何?

OpenSurge for Macは、Macを家庭内ネットワークのゲートウェイとして動作させます。dnsmasqがDHCPとDNSを提供し、mihomoがプロキシ処理とルーティングを担い、macOSのpfとIP forwardingがIPv4トラフィックを転送します。デフォルトはバイパスルーターモードで、メインルーターのDHCP設定はそのままに、選択したデバイスのゲートウェイとDNSとしてMacを指定します。自動でデバイスを接続できるよう、LANのDHCPを引き継ぐモードと、独自のAP、SSID、またはVLANを使う独立した下流LANモードも利用できます。

登録したデバイスごとに異なる送信先ポリシーを設定できます。たとえば、スマートフォンにはルールベースのルーティング、ゲーム機には米国のノード、テレビにはストリーミング用ノードを割り当てられます。ポリシーはJSONファイルまたはWeb GUIで定義でき、デバイスごとの接続、トラフィック、送信先チェーンをリアルタイムで確認できます。サブスクリプションや既存のmihomoプロファイルをインポートでき、TailscaleやHeadscaleをアウトバウンドとして追加することもできます。

メニューバーアプリとローカルWeb GUIから、ステータスの確認、ネットワーク復旧アラートの表示、起動・停止を行えます。実験的な下流IPv6経路では、BPF packet brokerを通じてIPv6トラフィックをパッチ適用済みのmihomoにルーティングします。また、このリポジトリでは、リスクの高いネットワーク変更をテストする仮想LANラボを使った、AIエージェント向けのワークフローも解説しています。

主な機能

  • 01登録済みのLANデバイスごとに送信先ポリシーを設定。ルール、グローバルプロキシ、拒否の各アクションに対応
  • 02dnsmasqによるDHCPとDNSの提供。バイパスルーター、LAN引き継ぎ、下流LANの各モードに対応
  • 03TUNを使ったmihomoベースの透過プロキシに加え、明示的なmixed-portプロキシを提供
  • 04Web GUIでデバイスごとの接続、トラフィック、送信先チェーンをリアルタイムに表示
  • 05既存のmihomoプロファイルとサブスクリプションをインポートでき、起動失敗時はロールバック
  • 06RA/SLAACとBPF packet brokerを使った実験的な下流IPv6の引き継ぎ

ユースケース

  • アプリごとの設定をせずに、スマートフォン、テレビ、ゲーム機を異なるプロキシノード経由でルーティングする
  • 家庭内LANのDHCPとDNSを引き継ぎ、新しいデバイスをプロキシに自動接続する
  • すべてのトラフィックが指定した送信先を経由する、独立したWi-FiネットワークまたはVLANを追加する
  • ほかのポリシーと併用しながら、MacのトラフィックをTailscaleの出口ノード経由でルーティングする

収録されている特集

トピック

#proxy#gateway#dnsmasq#mihomo#dhcp#dns#policy-routing#transparent-proxy#home-network#macos

よくある質問

OpenSurge-for-Mac とは?
MacをSurge風の透過プロキシにするmacOS用ゲートウェイアプリ。デバイスごとのルーティングに対応し、dnsmasqでDHCP/DNS、mihomoでプロキシ処理を行います。 OpenSurge for Macは、Macを家庭内ネットワークのゲートウェイとして動作させます。dnsmasqがDHCPとDNSを提供し、mihomoがプロキシ処理とルーティングを担い、macOSのpfとIP forwardingがIPv4トラフィックを転送します。デフォルトはバイパスルーターモードで、メインルーターのDHCP設定はそのままに、選択したデバイスのゲートウェイとDNSとしてMacを指定します。自動でデバイスを接続できるよう、LANのDHCPを引き継ぐモードと、独自のAP、SSID、またはVLANを使う独立した下流LANモードも利用できます。
OpenSurge-for-Mac は無料で使えますか?ライセンスは?
OpenSurge-for-Mac は GPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
OpenSurge-for-Mac は今もメンテナンスされていますか?
活発にメンテナンス中。OpenSurge-for-Mac の最終コミットは 2026年11月4日 です。
OpenSurge-for-Mac は何に使えますか?
アプリごとの設定をせずに、スマートフォン、テレビ、ゲーム機を異なるプロキシノード経由でルーティングする 家庭内LANのDHCPとDNSを引き継ぎ、新しいデバイスをプロキシに自動接続する すべてのトラフィックが指定した送信先を経由する、独立したWi-FiネットワークまたはVLANを追加する ほかのポリシーと併用しながら、MacのトラフィックをTailscaleの出口ノード経由でルーティングする
OpenSurge-for-Mac はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/YTwsy/OpenSurge-for-Mac

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト