WireGuardのクライアント設定を受け取り、Shadowrocketに手動で追加する方を対象にしています。まず [Interface] と [Peer] で自分側と相手側を区別し、通信対象がトンネルを経由する設定か確認しましょう。接続できない場合は、ハンドシェイク、接続先IP、名前解決、パケットサイズの順に確認します。一度に複数の項目を変更する必要はありません。
HomeからWireGuardを追加する
iPhone / iPadでの操作を例に説明します。作業前に、利用中のサービスの管理者へ、手元の設定が現在の端末に割り当てられたクライアント設定であり、サーバー用や別の端末用ではないことを確認してください。どちらの設定にも [Interface] と [Peer] が含まれる場合がありますが、鍵とアドレスの割り当て先は異なります。
- Homeの右上にある+をタップし、Add Serverを開いて、TypeからWireGuardを選択します。
- 元の設定を見ながら、自分側のアドレス、鍵、接続先の情報を入力します。画面でホストとポートが別々の欄になっている場合は、
Endpointを2項目に分けて入力してください。ホスト欄にポートを付けたまま入力しないでください。 - 保存したらHomeに戻り、追加したWireGuardの項目を選んで接続スイッチをオンにします。VPN構成の追加を求められた場合は、端末の案内に従って許可してください。スイッチがオンでも、ローカルで接続が有効になったことを示すだけで、相手とのハンドシェイクが完了したとは限りません。
- 管理者がその項目経由で転送されると確認した接続先にアクセスします。Global RoutingでConfigを使っている場合は、その接続先がルールによって
DIRECTや別のアウトバウンドに振り分けられていないか確認してください。
フィールド入力
アウトバウンド選択
本端末:[Interface]
PrivateKey- 現在の端末の秘密鍵です。本端末に割り当てられた値を省略せずに入力してください。本端末の公開鍵を入力したり、末尾の
=を削除したりしないでください。 Address- 本端末に割り当てられたトンネルアドレスです。例:
192.0.2.10/32。元のプレフィックス長を維持し、サーバーのパブリックアドレスは入力しないでください。 DNS- 以下の項目名は、一般的なWireGuardクライアント設定ファイルの表記に基づいています。各プラットフォームの入力欄が同じ名前とは限りません。例に使うアドレスはドキュメント用に予約されたもので、接続先としては使えません。
MTU- トンネルインターフェースの最大転送単位(バイト単位)です。元の設定に値があればそのまま使い、指定がなければクライアントの既定値を維持してください。
管理者に登録してもらうのは本端末の公開鍵です。秘密鍵ではありません。
自分側に割り当てられたトンネルアドレスです。例:192.0.2.10/32。元のプレフィックス長を維持し、サーバーのグローバルIPアドレスは入力しないでください。
PublicKey- 元の設定で指定されたリゾルバーです。リゾルバーが相手側のプライベートネットワーク内にある場合は、リゾルバー宛ての通信が適切な経路を通ることも確認してください。
Endpoint- ピアの到達可能なアドレスと UDP ポートです。例:
192.0.2.20:51820。IPv6 を1つのフィールドに入力する場合は、[2001:db8::20]:51820の形式にします。 AllowedIPs- このピアに割り当てるアドレスプレフィックスです。例:
198.51.100.0/24。本端末のAddressとは異なり、ドメイン名は入力しません。 PresharedKey- 任意の事前共有鍵です。元の設定にこの項目がある場合、ピア側の設定と一致させてください。公開鍵で代用することはできません。
PersistentKeepalive- キープアライブの間隔(秒単位)です。設定で指定されている場合、または NAT マッピングの維持が必要な場合にのみ使用します。たとえば
25は、25秒ごとにキープアライブを送信する設定です。
51820 はよく使われる例示用ポートで、固定値ではありません。ピアが実際に待ち受けている UDP ポートを指定してください。
PrivateKey を変更した場合は、管理者に依頼して、ピアに登録されている本端末の公開鍵も更新してください。クライアント側だけで鍵を変更し、ピア側を更新しなければ、アドレスとポートが正しくてもハンドシェイクは完了しません。トラブルシューティングの際は、PrivateKey や PresharedKey を含む設定ファイルやスクリーンショットを送らないでください。
任意の事前共有鍵です。元の設定に含まれている場合は、相手側の設定と一致させてください。公開鍵で代用することはできません。
AllowedIPs は、WireGuard がどの宛先アドレスへの送信をそのピアに渡すかを決めるとともに、ピアから受信した内部パケットの送信元アドレスの検証にも使われます。一方、Global Routing は、Shadowrocket が接続をその送信先へ振り分けるかどうかを決めます。両方の条件を満たす必要があります。宛先ネットワークを AllowedIPs に追加しても Shadowrocket のルールは変わりません。また、ルールで WireGuard が選ばれても、その宛先がピアのアドレス範囲に自動追加されるわけではありません。
/32/1280.0.0.0/0::/0単一のIPv4アドレス
たとえば、宛先が 198.51.100.0/24 の範囲外にある場合は、まずその宛先をピア経由にする必要があるか確認してください。テストを通すためだけに 0.0.0.0/0 に変更しないでください。ドメインが IPv4 と IPv6 の両方のアドレスを返す場合は、実際に使われているアドレスファミリーも確認します。
- 指定したネットワークだけにアクセスする場合:許可されたネットワークをそのまま使います。例:
198.51.100.0/24。リモート DNS リゾルバーがそのネットワークに含まれない場合は、リゾルバーのアドレスプレフィックスを別途追加する必要があるか、管理者に確認してください。トンネル内の DNS アドレスと、トンネル外でEndpointを名前解決するための経路を混同しないでください。 - デフォルトルートのプレフィックスを使う場合:
0.0.0.0/0は IPv6 を含みません。ピア側で対応する転送が設定されており、IPv6 も対象にする必要がある場合に限り、元の設定に従って::/0を使ってください。デフォルトルートのプレフィックスは、アプリの Proxy モードと同じ意味ではありません。
結論:まず宛先IPを確認し、次にプレフィックスを見直す
テストでは宛先とネットワークを固定し、一度に変更する項目は1つだけにしてください。Endpoint にドメイン名を指定する場合、トンネルの確立前に名前解決できる必要があります。トンネル経由でしかアクセスできない DNS リゾルバーでは、初回接続時の名前解決はできません。
| 症状 | ハンドシェイク失敗・ドメインに接続できない・MTUのトラブル対処 |
|---|---|
| 宛先にリクエストを送ってもハンドシェイクしない | クライアントにハンドシェイクの状態が表示されない場合は、管理者にピア側の最終ハンドシェイク時刻を確認してもらってください。Endpoint のホスト名と実際の UDP ポート、ピアの公開鍵と事前共有鍵を確認し、ピアに本端末の公開鍵が登録されていることも確認します。通常のWebページにアクセスできても、その UDP ポートに到達できるとは限りません。 |
| 症状 | アプリで選択されている送信先と、宛先が本端末の AllowedIPs に含まれているかを確認してください。また、ピア側で本端末のトンネルアドレスに正しいプレフィックスと戻り経路が設定されているかも確認します。ハンドシェイクが成功していても、宛先ネットワークへの転送が設定済みとは限りません。 |
| 接続先にリクエストしてもハンドシェイクしない | まずドメイン名を解決できるか、リゾルバーに到達できるかを確認し、返されたアドレスと振り分け結果を照合してください。ブラウザーで HTTPS の IP アドレスに直接アクセスする方法だけを比較基準にしないでください。証明書や接続先サイトの選択が原因で失敗することもあります。 |
| ハンドシェイクするが、宛先IPに接続できない | 宛先サービスに問題がないことを確認してから、経路 MTU をテストしてください。元の値を記録し、たとえば 1420 から 1380 に一時的に変更して、同じリクエストで再テストします。この差分は原因の切り分けに使うもので、一般的な推奨値ではありません。改善しない場合は元の値に戻してください。 |
まずドメイン名を名前解決できるか、リゾルバーに到達できるかを確認し、返されたアドレスと通信の振り分け結果を照合してください。ブラウザーでHTTPSのIPアドレスに直接アクセスする方法だけを比較に使わないでください。証明書やサイトの振り分けが原因で接続に失敗することもあります。
小さなリクエストは通るが、大きな応答が何度も止まる