Mac での Happ 設定: インストールからトラフィックのルーティングまで

macOS への Happ のインストール

Happ は Xray コアのクライアントで、Mac ではシステムプロキシを使う通常のアプリとしても、本格的なネットワークトンネルとしても動作します。macOS 版をダウンロードし、アプリを「アプリケーション」フォルダに移動して起動してください。初回起動時、macOS は「インターネットからダウンロードされたプログラム」であるという Gatekeeper の警告を表示することがあります。「システム設定 →プライバシーとセキュリティ」を開き、「このまま開く」ボタンで起動を許可してください。

安定した動作のためには macOS 12 Monterey 以降を推奨します。それより古いバージョンでは、Happ が TUN モードで使用するネットワーク API の一部が利用できません。クライアントは Apple Silicon プロセッサ（M1〜M4）搭載の Mac でも Intel チップ搭載モデルでも同様に正しく動作します。アーキテクチャごとに個別のビルドを探す必要はなく、universal 版が自動的に適切なコードを選択します。

インストール後は、ログイン時に Happ を自動起動する設定と、メニューバーにアイコンを表示する設定をすぐに有効にしておくと便利です。接続、サーバーの切り替え、モードの変更がいつでも手元にあり、アプリのウィンドウを毎回開く必要がなくなります。

キーとサブスクリプション: 接続方法

サーバーへのアクセスはサービスの Telegram ボットが発行します。ボットで試用版、公式版、または有料版のキーを取得すると、サブスクリプション文字列（happ:// または https:// 形式のリンク）か、個別のサーバー設定のいずれかが返されます。Mac 上で長い設定を手動でコピーする必要はありません。サブスクリプションが最新のサーバー一覧を自動的に取得し、サービス側の変更に応じて更新します。

キーを追加する最も速い方法は、サブスクリプションのリンクをコピーして Happ で「クリップボードから追加」を押すことです。アプリがクリップボードの内容を認識し、プロファイルを自動でインポートします。happ:// リンクを macOS で直接開くと、システムが deep-link で Happ に渡すことを提案し、プロファイルがワンクリックで追加されます。

インポート後、サーバー一覧がメインウィンドウに表示されます。最も ping の小さいノードを選び、「接続」を押してインジケーターがアクティブになるまで待ちます。サブスクリプションは一度追加すれば十分で、ボットでキーを更新しても何も再インストールする必要はなく、クライアントが自動で更新を取得します。

プロキシモードと TUN モード: どちらを選ぶか

macOS では Happ はトラフィックを通す方法として本質的に異なる 2 つの方式を提供します。プロキシモードはローカルの SOCKS/HTTP プロキシを立ち上げ、それをシステムのネットワーク設定に登録します。これを通るのは、システムプロキシを尊重するアプリのリクエスト、主にブラウザです。これは軽量なモードで、管理者権限を必要とせず、プロキシを迂回して動作するプログラムのトラフィックには影響しません。

TUN モード（システムトンネルモードとも呼ばれます）は utun という仮想ネットワークインターフェースを作成し、システム全体のレベルでトラフィックを傍受します。この場合、トンネルを通るのはブラウザだけでなく、メッセンジャー、デスクトップクライアント、ターミナル、バックグラウンドサービスも含まれます。TUN を有効化するために Happ は一度だけ特権 helper のインストールと管理者パスワードによる操作の確認を求めます。これはネットワークスタックを管理するアプリに対する macOS の標準的な動作です。

実用的な原則: アプリ全体で「すべてを通したい」なら TUN を有効にします。ブラウザだけアクセスを開き、システムの他の部分には触れないという限定的な用途なら、プロキシモードで十分です。モード間の切り替えは、サブスクリプションを削除したり選択中のサーバーを変えたりせずに、その場で行えます。

ルーティングと split tunneling

Happ 内部の Xray コアは柔軟なルーティングをサポートしており、どのトラフィックをサーバー経由にし、どれを直接通すかというルールを設定できます。Mac ではこれが主に分割トンネリング（split tunneling）に使われます。例えば銀行やローカルのサイトはトンネルを迂回させ、それ以外はすべて選択したサーバー経由にします。ルールはドメイン、IP サブネット、地域ゾーンで構築します。

既製のルーティングリスト（routing lists）を使えば、何百ものドメインを手作業で列挙する必要がなくなります。こうしたリストを接続すると、あらかじめ設定されたルールのセット、例えば「ローカルリソースは直接」や「広告・トラッキングドメインをブロック」などが手に入ります。リストは更新されるため、あなたが手を入れなくてもルールは最新のまま保たれます。

macOS では特に、ローカルネットワークのトラフィックを迂回させるオプションが有用です。プリンターや NAS、ホームネットワーク内の他のデバイスへのアクセスは直接通す必要があり、そうしないとそれらが見つからなくなります。ルーティング設定でプライベート範囲（10.0.0.0/8、192.168.0.0/16 など）をトンネルの外に残してください。これは標準的で安全な運用です。

最適化と Mac でよくある問題

TUN を有効にした後にすべてのアプリでインターネットが失われた場合は、まず特権 helper がインストールされ、Happ が「プライバシーとセキュリティ」でネットワーク構成の変更を許可されているか確認してください。この許可の取り消しは、トンネルは立ち上がるのにトラフィックが通らない最も多い原因です。アプリの設定から helper を再インストールすると、通常は問題が解決します。

速度が遅い場合は、地理的により近いサーバーに切り替え、接続のトランスポートに注目してください。Xray コアの最新のマスキングプロトコルを備えたノードは、不安定な回線でも通常は安定した結果をもたらしますが、混雑した公開ノードはピーク時に速度が落ちます。ping とサーバー負荷は一覧の中で直接確認できます。

プロキシモードでブラウザが接続を無視する場合は、ブラウザに独自のプロキシやネットワークを傍受する拡張機能が設定されていないか確認してください。それがシステム設定を上書きします。また、Mac がスリープに入るときに Happ が切断されないように、起動時の自動接続とトンネルの保持を有効にしてください。そうすればノートパソコンの復帰後に接続が自動的に回復します。