ShadowrocketのWireGuard設定ガイド:PrivateKey・PublicKey・AllowedIPsの意味

ShadowrocketでWireGuardを設定する際の各項目を解説。鍵ペア、Address、DNS、MTU、AllowedIPs、Endpointの意味と、入力ミスが多い箇所を確認できます。

この記事の概要

この記事は、サービス提供元から取得したWireGuard設定を持ち、Shadowrocketで各項目を確認したい方向けです。まずローカル側とリモート側の識別情報を区別し、次にトンネルアドレス、宛先ネットワーク、UDPエンドポイントを確認します。最後にGlobal Routingを使って、プロトコル接続の問題とルール選択の問題を切り分けます。例示用のアドレスは項目の説明にのみ使用しており、接続には使えません。

1. まず[Interface]と[Peer]を区別する

WireGuardの設定は通常、[Interface]と[Peer]の2つのセクションで構成されます。前者はローカルのトンネルインターフェース、後者は通信相手を表します。Shadowrocketに設定を入力する際は、記載順ではなく各項目の意味に合わせて入力してください。以下ではiPhone / iPadの画面を例に説明します。ほかのプラットフォームでは項目の並びが異なる場合があります。

PrivateKeyはローカル側の鍵です。[Peer]内のPublicKeyはリモート側の鍵です。サーバー側にもローカル側の公開鍵を登録し、正しいアドレスを割り当てる必要があります。クライアント側の項目を入力しただけでは、サーバー側の設定も完了したことにはなりません。

32バイト
WireGuardの秘密鍵と公開鍵、それぞれの元データの長さ
UDP
WireGuardの外側の通信に使うプロトコル
51820
この記事の例で使用するポート番号。実際の値は手元の設定に従ってください

WireGuardの秘密鍵、公開鍵、任意の事前共有鍵は通常Base64テキストで表され、標準形式では44文字で、末尾が=になることがあります。長さが同じでも用途は異なり、長さだけで鍵の有効性を確認することはできません。これらの項目をパスワード、サブスクリプションURL、証明書の内容として扱わないでください。

2. PrivateKey・PublicKey・PresharedKeyの対応関係

ローカル側の識別情報

PrivateKey
ローカル側の秘密鍵。ローカル設定内に保持し、トラブル対応の担当者にも送らないでください。
ローカル側のPublicKey
ローカル側のPrivateKeyから生成され、サーバーにローカル側の識別情報を登録するために使います。
Address
サーバーからローカル側に割り当てられるトンネルアドレス。インターネット上のサーバーアドレスではありません。

ローカル側のPrivateKeyを変更した場合は、サーバーに登録されているローカル側の公開鍵も合わせて変更する必要があります。

リモート側の識別情報

[Peer] PublicKey
リモート側の公開鍵。接続先の相手を識別するために使います。
PresharedKey
任意で追加する共有鍵。有効にする場合は、両端で同じ値を設定します。
Endpoint
リモート側に到達するためのアドレスとUDPポート。

手元の設定にPresharedKeyがない場合、自分で生成して入力しないでください。

よくある入力ミスは、ローカル側の公開鍵をリモート側のPublicKeyに入力すること、またはリモート側の公開鍵をローカル側のPrivateKeyとして入力することです。どちらも文字列の形式チェックは通る場合がありますが、正しい暗号化セッションを確立できません。確認時は「どちら側の鍵か」と「公開鍵か秘密鍵か」を両方確認してください。

WireGuardの設定全体を公開しないでください。PrivateKeyとPresharedKeyはいずれも機密情報です。問い合わせる際は、項目名、エラーメッセージ、発生しているネットワークの状態を残し、鍵の内容は削除してください。秘密鍵が漏えいした場合は鍵を変更し、サーバー側の公開鍵も更新してください。

3. Address・DNS・MTUの役割

Addressはトンネル内部で使うローカル側のアドレスで、通常は10.66.0.2/32のようにCIDRプレフィックスを付けて指定します。現在接続中のWi-Fiのローカルアドレスでも、Endpointでもありません。Wi-Fiを切り替えたからといって、このアドレスを新しいローカルアドレスに変更しないでください。

項目例または単位確認ポイント
Address10.66.0.2/32割り当て済みのアドレスを使用し、プレフィックス長を勝手に広げないでください。
DNSDNSサーバーのIPアドレスDNSリゾルバーに到達できることを確認し、Shadowrocketで現在使われているDNS設定も確認してください。
MTUバイト(例:1420)トンネル内のIPパケットサイズを制限する値で、通信速度ではありません。

DNSとAddressは、WireGuardのハンドシェイクで使う識別情報ではありません。一般的な設定ファイルに記載されたこれらの項目は、クライアントや設定ツールによって処理されます。ファイルの内容をShadowrocketに反映する際、ファイル内のすべての項目がアプリの全般設定を自動的に上書きするとは限りません。Settings → DNSで実際に使用されるDNS設定も確認してください。

MTUが大きすぎると、小さなリクエストには応答するものの、大きなデータ転送が止まることがあります。ただし、同じ症状はほかのネットワーク問題でも起こります。外側の通信がIPv4の場合、WireGuardのカプセル化によるオーバーヘッドは一般に60バイト、IPv6の場合は80バイトです。下位ネットワークのMTUが1500であれば、1420はIPv6の外側通信も考慮した一般的な開始値ですが、すべての回線に適用できるわけではありません。

4. AllowedIPsとGlobal Routingは別の設定

WireGuardでは、AllowedIPsを使って相手とIPプレフィックスを対応付けます。送信時は宛先アドレスをどの相手に転送するかの選択に使い、受信時は復号後のパケットの送信元アドレスを検証します。従来型のトンネルツールでは、これをもとにシステムルートを設定することもあります。ルールベースのプロキシクライアントであるShadowrocketには、これとは別に通信を振り分ける層があります。

そのため、AllowedIPs = 0.0.0.0/0, ::/0は、相手側がIPv4とIPv6のアドレス範囲を対象にすることを意味します。端末上のすべての通信がShadowrocketによって選択され、その相手に送られるという意味ではありません。接続スイッチ、現在選択されている接続、Global Routing、設定ルールで使用されるポリシーも確認してください。

# 項目説明用の抜粋です。接続設定一式としてそのままインポートできません。
# 以下のアドレスは説明用の例であり、接続サービスは提供していません。
[Interface]
Address = 10.66.0.2/32
MTU = 1420

[Peer]
Endpoint = 192.0.2.10:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25

この抜粋では鍵を省略しています。0.0.0.0/0はIPv4のみ、::/0はIPv6を対象にします。10.66.0.0/24だけを指定した場合、その相手が対象とするのはこのネットワークだけです。任意のインターネット上の宛先を通せるとは限りません。IPv6を設定するかどうかは、サーバー側の対応状況と既存の割り当てを確認してください。

これらは[Rule]セクションのルールであり、AllowedIPsに貼り付けるものではありません。ルールは上から順に評価されます。先行するDIRECTルールに一致した場合、それ以降のプロキシポリシーはそのリクエストに適用されません。

5. EndpointとPersistentKeepaliveの設定範囲

Endpointは、ローカル側から現在のネットワーク経由で最初にアクセスするリモートアドレスです。IPアドレスまたはホスト名にポート番号を付けて指定します。標準的な設定では192.0.2.10:51820のように記述します。編集画面でアドレスとポートが別の項目になっている場合は、それぞれに入力し、同じ文字列全体を両方の項目に重複して入力しないでください。

  1. アドレス欄にhttps://を付けたり、ウェブページのパスやサブスクリプションのクエリパラメーターを追加したりしないでください。
  2. 標準的な設定でIPv6のEndpointを指定する場合は、[2001:db8::10]:51820のように角括弧で囲みます。アドレス内のコロンがポート区切りと誤認されるのを防げます。
  3. リモート側が設定に指定されたUDPポートで待ち受けていることを確認してください。同じ番号のTCPポートへの接続に成功しても、UDPポートに到達できる証明にはなりません。
  4. ホスト名を使う場合は、接続確立前に名前解決できることを確認してください。まだ確立していないトンネル内のDNSに依存しないようにします。

PersistentKeepaliveの単位は秒です。必要に応じてキープアライブパケットを送信し、NATやファイアウォールの状態を維持します。25は一般的な設定値ですが、必須ではありません。未設定または0の場合、通常は定期的なキープアライブを無効にします。接続タイムアウトではなく、公開鍵の誤りやサーバー側で許可されていないポートを解決するものでもありません。

Wi-Fiとモバイル通信を切り替えた後にのみ切断される場合は、切り替えた時刻、再接続できるか、UDPに到達できるかを記録してから、キープアライブが必要か判断してください。鍵やEndpointの確認をせずに、キープアライブ間隔を際限なく短くしないでください。

6. Shadowrocketへの入力と段階的な検証

以下の手順は、有効な設定をすでに持っていることを前提としています。当サイトでは接続先やサブスクリプションを提供・販売・推奨していません。設定値がご自身のサブスクリプションから取得したものであれば、まずサービス提供元の元情報と照合してください。サブスクリプションの更新で接続項目が再び書き込まれることがあるため、トラブル対応前に現在の値を記録し、手動変更が次回の更新で上書きされないようにしてください。

  1. プロトコルを選択する

    Home →「+」→ Type → WireGuardの順に開きます。既存の接続を編集する場合は、Homeから該当項目を開き、まずTypeを確認してください。ほかのプロトコルのパスワードや識別子をWireGuardの鍵欄に入力しないでください。

  2. 識別情報を確認する

    ローカル側とリモート側の対応関係に従って、PrivateKey、リモート側のPublicKey、設定で必要とされている場合はPresharedKeyを入力します。サーバーにローカル側の公開鍵が登録されていることも確認してください。

  3. アドレスを確認する

    Address、Endpoint、ポートを確認します。元の設定にある項目が編集画面に個別表示されていない場合は、現在のクライアントでその値を設定する場所を確認してください。意味が似ていても異なる項目に入力しないでください。

  4. 一時的にテストする

    保存して接続を選択し、Home → Global Routing → Proxyで、アクセス可能なことが分かっている同じ宛先をテストします。接続状態とログを確認し、一覧に表示される遅延結果だけで通信全体を検証したと判断しないでください。

  5. ルール設定に戻す

    テスト後、Home → Global Routing → Configに戻り、Configで有効になっている設定と、宛先に適用されるポリシーを確認します。自動再接続がテストに影響する場合は、Settings → On Demandも確認してください。

On Demandは、条件に応じた自動接続の動作を制御するもので、AllowedIPsや[Rule]の代わりにはなりません。トラブル対応中に無効にする場合は、元の設定を記録し、テスト完了後に戻してください。自動再接続によって手動のスイッチが効いていないと誤認するのを防げます。

Config

推奨

現在の設定ルールに従って通信を処理します。ルールによってDIRECTが選ばれる場合も、WireGuardを使うポリシーが選ばれる場合もあります。ルールに一致しなかった通信がすべて自動的にプロキシ経由になるわけではなく、最終的な動作はFINALによって決まります。

適した用途:プロトコルの検証後、日常的にルールで通信を振り分ける場合。

Proxy

通信をプロキシとして扱い、ルールによる振り分けがテストに与える影響を抑えられます。選択中の接続がテスト対象を指している必要があります。また、システムの通信対象範囲、リモート側の権限、WireGuardの設定上の制約を回避するものではありません。

適した用途:ルール選択が問題の原因かどうかを一時的に切り分ける場合。

Direct

通信を直接接続として扱い、ローカルネットワークで比較するための条件にできます。この状態で宛先にアクセスできても、テストがその接続を経由していない可能性があるため、WireGuard設定が正しい証明にはなりません。

適した用途:現在のローカルネットワークから宛先へ直接接続できるかを確認する場合。

7. 症状から問題の範囲を絞り込む

接続スイッチがオンになっているだけで、WireGuardのハンドシェイクが完了したと判断しないでください。スイッチが示すのはクライアントの接続状態です。リモート側の識別情報との一致、UDPの双方向通信、宛先との実データ通信は、それぞれ個別に確認する必要があります。以下はトラブルシューティングの順序であり、単一の症状だけで原因を断定するものではありません。

確認された症状優先して確認する項目次の手順
正常に通信できない両端の公開鍵登録、PresharedKey、Endpoint、UDPポートご利用のサービス提供元に、サーバーの待ち受け状態と相手側の登録状況を確認してください。
指定したIPアドレスには接続できるが、ドメイン名では失敗するDNSへの到達性と実際の名前解決経路同じ宛先でドメイン名の名前解決結果を照合し、異なるサービス同士を比較しないようにしてください。
小さなリクエストは正常だが、大きなデータ転送が止まる経路MTU、パケットロス、リモート側の制限ほかの設定は変えず、MTUだけを調整して同じテストを繰り返してください。
Proxyでは正常だが、Configでは問題がある現在の設定、適用されるルール、選択中のポリシー宛先がDIRECTやほかのポリシーに先に一致していないか確認してください。
サブスクリプションの更新後に設定値が変わる更新前後の項目とサーバー側の割り当てサブスクリプションソースの返却内容を確認し、サービス提供元が変更した値を繰り返し上書きしないでください。

ご利用のサービス提供元に問い合わせる際は、OSのプラットフォーム、ネットワークの種類、発生条件、確認済みの項目名、機密情報を除いたエラーログを伝えてください。PrivateKeyやPresharedKeyは送らないでください。サーバー側で公開鍵、ポート、アドレスの割り当てが変更されたことを確認した場合は、該当項目を更新し、プロトコルのテストから再確認してください。

Shadowrocket 公式ダウンロード