SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor ・更新日 2026-11-18

WireGuardの仕組みとAllowedIPsの読み方

WireGuardのAllowedIPsは、ルーティングテーブルとアクセス制御リストを兼ねます。cryptokey routing、Noiseハンドシェイク、鍵のローテーションを理解し、wg0.confを正しく読めるようにします。

WireGuard の仕組みを 1 つの考え方で理解する

WireGuard は、すべてのパケットを公開鍵に結び付けて動作します。この仕組みには cryptokey routing という名前があり、WireGuard の設計そのものです。ピアの隣にある AllowedIPs 行は、マシンから送信するパケットのルーティングテーブルであると同時に、そのピアから受信するパケットのアクセス制御リストでもあります。1 つの設定が 2 つの役割を担います。AllowedIPs をこのように読むと、WireGuard の設定ファイルはすべて理解しやすくなります。

IP アドレスをキーにしたセッションテーブルや、ユーザーデータベースはありません。ピアは、公開鍵と、その鍵が使用できるアドレスの集合です。ハンドシェイクとタイマーは、下位のネットワークが変化してもこの対応関係を維持するために存在します。理論より先に動作するトンネルが必要なら、自分の VPS でセルフホストする WireGuard VPN を構築してください。その後、設定行の意味に疑問を持ったときに、ここへ戻ってきてください。

AllowedIPs はルーティングテーブルであり、アクセスリストです

まず送信方向を見てみます。カーネルは通常どおり、メインルーティングテーブルを介してパケットを wg0 デバイスへルーティングします。次に WireGuard は、そのパケットの 宛先 アドレスを、すべての peer の許可プレフィックスを保持する 1 つのテーブルと照合します。照合は最長プレフィックスから行われます。一致すると peer が特定され、その peer から公開鍵、セッション鍵、UDP エンドポイントが特定されます。パケットはその peer 向けに暗号化され、送信されます。

どの peer の AllowedIPs にも宛先が含まれない場合、送信されません。送信に使用できる鍵がないためです。

ping: sendmsg: Required key not available

このエラーが示す原因は 1 つです。到達しようとしたアドレスが、どの peer にも登録されていません。別のエラーである ping: sendmsg: Destination address required は、peer には一致したものの、その peer のエンドポイントが WireGuard にないことを示します。エンドポイントが設定されておらず、まだ学習もされていないためです。

次に受信方向を見てみます。UDP パケットが listen port に到着します。WireGuard はヘッダー内の receiver index からセッションを特定し、ペイロードを復号して認証します。その後、カウンターをスライディングリプレイウィンドウと照合します。これらが完了して初めて内部パケットを読み取り、送信元 アドレスの最長プレフィックス検索を行います。この検索で、認証済みの送信元 peer が特定されなければ、パケットは破棄されます。動的デバッグを有効にすると、カーネルはその理由を次のような行で出力します。

wg0: Packet has unallowed src IP (10.8.0.9) from peer 2 (203.0.113.10:51820)

これが、サーバー側の peer に /32 が発生する理由です。AllowedIPs = 10.8.0.2/32 を設定した peer は、10.8.0.2 からのパケットだけを送信できます。それ以外のアドレスからは送信できません。代わりにそこへ 0.0.0.0/0 と記述すると、そのクライアントは、最長プレフィックス一致で自身が選択される任意の IPv4 送信元アドレスを使用できます。ただし、より具体的なプレフィックスによって別の peer に割り当てられたアドレスは使用できません。

プレフィックスが重複する場合、検索が最長プレフィックス一致で行われるため、より具体的なプレフィックスが優先されます。同一のプレフィックスを 2 つの peer に設定した場合の動作は異なります。そのエントリは最後に設定された peer に移動し、最初の peer はそのトラフィックを受信しなくなります。このとき、どこにもエラーは出力されません。wg show wg0 allowed-ips は、実際にカーネル内に存在するテーブルを出力します。ディスク上のファイルと実行中の状態が異なっている場合に重要なのは、こちらのテーブルです。

暗号鍵ルーティングを意識して設定ファイルを読む

サーバー側:

[Interface]
Address = 10.8.0.1/24
ListenPort = 51820
PrivateKey = <server private key>

[Peer]
PublicKey = <laptop public key>
AllowedIPs = 10.8.0.2/32

クライアント側:

[Interface]
Address = 10.8.0.2/32
PrivateKey = <laptop private key>

[Peer]
PublicKey = <server public key>
Endpoint = vpn.example.com:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25

同じキーワードでも、両側では意味が正反対になります。クライアント側では「すべての宛先をこの peer に送信する」という意味です。サーバー側では「この peer からは、この 1 つのアドレスだけを受け入れる」という意味です。この非対称性は役割ではなく、値にあります。

これらのキーの半分は、プロトコルの設定ではありません。Address、DNS、MTU、PostUp、SaveConfigは、インターフェースを起動するシェルスクリプトである wg-quick に属します。これらは WireGuard のプロトコル設定ではなく、wg-quick が個別に処理します。wg-quick strip wg0は、wg ツールが実際に読み込む、不要な項目を除いた設定を表示します。この分離を確認する最も手早い方法です。

ハンドシェイクで実際に行われる処理

WireGuard のハンドシェイクは、Noise Protocol Framework の Noise_IKpsk2 です。sysadmin にとって重要なのは IK の部分です。responder の静的公開鍵は initiator が事前に知っています。これは [Peer] ブロックの PublicKey です。initiator は最初のメッセージ内で自身の静的公開鍵を暗号化して送信します。そのため、証明書の交換も、識別情報を往復させる処理もありません。受動的な盗聴者は responder の秘密鍵を持っていない限り、どの鍵が接続しているかを判別できません。

コストは 1 往復です。開始メッセージは 148 bytes、応答は 92 bytes で、その直後からデータが流れます。各側はハンドシェイクごとに新しい一時 Curve25519 key pair を生成します。セッションキーは、静的鍵と一時鍵を組み合わせた Diffie-Hellman の結果を連鎖させて生成されます。一時秘密鍵はその後破棄されます。これにより forward secrecy が実現します。今日の通信を記録した攻撃者が、来年サーバーの秘密鍵を盗んでも、記録した通信を復号できません。

ハンドシェイクの開始メッセージには TAI64N timestamp が含まれます。各 peer は相手から受信した最大の timestamp を記憶するため、リプレイされた開始メッセージは拒否されます。データパケットには nonce として使用する 64-bit counter が含まれます。受信側は最近受信した counter の sliding window を保持するため、TCP のような接続状態を持たずに、リプレイや大幅な順序入れ替わりを処理できます。

セッションキーの有効期間は短く、タイマーは設定変更可能な値ではなく、コンパイル時に組み込まれています。

グラフWireGuard protocol timers, in seconds
このグラフのデータ
[
  {
    "label": "REKEY_TIMEOUT",
    "seconds": 5,
    "notes": "resend a handshake initiation that got no answer, plus up to 333 ms of random jitter"
  },
  {
    "label": "KEEPALIVE_TIMEOUT",
    "seconds": 10,
    "notes": "send a keepalive after receiving data and sending none back"
  },
  {
    "label": "REKEY_ATTEMPT_TIME",
    "seconds": 90,
    "notes": "stop retrying the handshake and drop the packets queued for that peer"
  },
  {
    "label": "REKEY_AFTER_TIME",
    "seconds": 120,
    "notes": "the peer that initiated the current session begins a fresh handshake when it next sends"
  },
  {
    "label": "REJECT_AFTER_TIME",
    "seconds": 180,
    "notes": "the old session key is refused and traffic stops"
  }
]

これらは測定値ではなく、プロトコル仕様で定められた定数です。この 5 個のタイマーが、セッションのライフサイクルを制御します。セッションキーの経過時間が 120 秒になると、そのハンドシェイクを開始した peer は、次に送信するときに新しいハンドシェイクを開始します。responder はこのタイマーでは rekey しません。180 秒が経過すると、古いキーは完全に拒否されます。そのため、新しいハンドシェイクが完了するまで通信は停止します。応答がない開始メッセージは、5 秒後に、最大 3 分の 1 秒のランダムな jitter を加えて再送されます。再試行は約 90 秒後に停止します。これが、wg show が latest handshake を相対的な経過時間として表示する理由です。また、正常に動作しているトンネルで通信が継続している場合、この経過時間が小さく保たれる理由でもあります。通信を実際に送信しているのに経過時間が増える場合、トンネルが idle なのではなく、ハンドシェイクに失敗しています。

ピアにクライアントまたはサーバーの役割がない理由

両端は同一のコードと同じ形式の設定を使用します。サーバーモードはありません。感じられる非対称性は Endpoint によるもので、Endpoint は任意です。

endpoint が設定されたピアはハンドシェイクを開始できます。endpoint が設定されていないピアは待機し、正しく認証された最初のパケットから相手側のアドレスとポートを取得します。取得した endpoint は保存され、有効なパケットが新しいアドレスから届くたびに更新されます。これがローミングの仕組みです。ノート PC が Wi-Fi からモバイルネットワークへ移動しても、セッションは同じまま維持されます。セッションは IP アドレスではなく、鍵とインデックスによって識別されるためです。TCP の意味で接続されていたわけではないため、再接続も発生しません。

この同じ仕組みから、知っておくべき事実が導かれます。公開アドレスを持つピアは、相手側の最後に確認されたパブリック IP を常に保持しており、wg show で表示できます。

固定されたプリミティブで、ネゴシエーションは不要

WireGuard には暗号スイートのリストがありません。認証付き暗号化には ChaCha20-Poly1305、鍵合意には Curve25519、ハッシュには BLAKE2s、鍵導出には HKDF を使用します。すべての構成でこれらを使用するため、解析が必要なネゴシエーションフェーズはなく、より弱い方式へダウングレードされる経路もありません。代償は明確です。これらのプリミティブのいずれかが破られた場合、必要になるのは設定変更ではなく、プロトコル全体の新しいバージョンと両端での更新です。この判断により、TLS ベースのトンネルが抱えるコードの大部分と障害要因の大部分が取り除かれます。WireGuard と OpenVPN の比較での比較も、主にこの点に帰着します。

ポートがスキャナーに応答しない理由

Handshake の開始メッセージと応答メッセージには、mac1というフィールドが含まれます。cookie reply には含まれません。これは、受信側の静的公開鍵から導出した鍵を使ってメッセージに対して計算する MAC(message authentication code)です。その公開鍵を知らない送信側は、有効な mac1 を生成できません。受信側は、そのようなパケットを一切応答せずに破棄します。エラーも、reset も、ICMP メッセージも返しません。

外部から確認できる結果は、UDP スキャンに対して何も返らないことです。

sudo nmap -sU -p 51820 vpn.example.com

nmap は open|filtered と報告します。これは、ファイアウォールがパケットを黙って破棄するポートに対する応答と同じです。何も待ち受けていない、フィルタリングされていない UDP ポートは、通常、ICMP port-unreachable エラーを返します。この場合、nmap は closed と報告します。

2 つ目のフィールドである mac2 は、DoS 攻撃による負荷に対処します。受信側が高負荷になると、開始メッセージまたは応答メッセージに対して、有効な mac1 は含めるものの、有効な mac2 は含めない 64-byte の cookie reply を返します。この cookie reply は送信元アドレスに関連付けられています。送信側がその cookie を使って有効な mac2 を計算するまで、受信側は高コストな公開鍵処理を実行しません。これにより、高コストな公開鍵処理を行う前に、送信元アドレスへの到達性を確認できます。この機能は高負荷時にのみ有効になります。

0.0.0.0/0 によってピアがデフォルトルートになる理由

AllowedIPs はルーティングテーブルなので、AllowedIPs = 0.0.0.0/0, ::/0 によって、別のピアに割り当てられた、より具体的なプレフィックスに一致しない宛先がそのピアへ転送されます。これがフルトンネル設定の全体です。

この設定を機能させるルーティングは、行そのものよりも興味深いものです。wg0 経由の単純なデフォルトルートではループが発生します。トラフィックを運ぶ暗号化済みの UDP パケット自体もマシンから送信する必要があり、そのパケットが自身のデフォルトルートに一致するためです。wg-quick はポリシールーティングによってこの問題を回避します。WireGuard 自身の送信パケットに fwmark を付け、トンネルのデフォルトルートを別のルーティングテーブルに配置し、マークされていないトラフィックだけがそのテーブルに到達するようルールを追加します。ip rule show を実行すると、結果を確認できます。

32764:	from all lookup main suppress_prefixlength 0
32765:	not from all fwmark 0xca6c lookup 51820
32766:	from all lookup main

0xca6c は 16 進数で 51820 を表し、51820 はテーブル番号でもあります。suppress_prefixlength 0 ルールによって、main テーブルは自身のデフォルトルートを使用しなくなります。そのため、ローカルサブネットなどの具体的なルートは引き続き優先され、それ以外のトラフィックはトンネルテーブルに送られます。スプリットトンネルでは、この設定は必要ありません。AllowedIPs = 10.8.0.0/24, 10.20.0.0/16 のような、より限定されたリストが main テーブルの通常のルートになります。

フルトンネルだけでは、名前解決の問題は解決しません。通常、クライアントがローカルネットワークから取得した resolver はそのまま使用され、そのルートのほうが具体的だからです。これは別の作業であり、WireGuard トンネルの外部に漏れる DNS で説明します。

PersistentKeepalive の実際の用途

通信がないとき、WireGuard は何も送信しません。ハートビートも、セッションの更新も、ネットワーク上の通信もありません。この無通信はバッテリーの節約に役立ち、前述のスキャナー対策にもなります。一方で、特定の構成では問題になります。

NAT (network address translation) またはステートフルファイアウォールの背後にある peer は、その機器にマッピングが存在する間だけ外部から到達できます。このマッピングは、外向きパケットによって作成されます。一般的な UDP マッピングの有効期間は、約 30 秒から始まります。マッピングの有効期限が切れると、パブリック側からのパケットはミドルボックスによって破棄されます。NAT 背後の peer が何かを送信するまで、トンネルは停止したように見えます。PersistentKeepalive = 25 は、その peer との間で認証済みパケットが 25 秒間通過しないたびに、認証済みの空パケットを送信します。実際の通信がカウントダウンをリセットするため、通信量の多いトンネルでは空パケットがほとんど送信されません。アイドル状態のトンネルでも間隔は、一般的な最短の有効期間を超えないため、マッピングが維持されます。

NAT 背後の peer に設定してください。パブリックアドレスと開放された UDP ポートを持つサーバーには必要ありません。サーバー側に設定すると、通信量が増えるだけです。これを自動 keepalive と混同しないでください。自動 keepalive は、peer がデータを受信した後、10 秒間自身から返信するデータがない場合に送信されます。これは常に有効で、設定変更できません。

トンネル経由で LAN をルーティングする機能は WireGuard にはない

ピア B がホームネットワーク 192.168.50.0/24 上にあり、ピア A からそこへ到達する必要があるとします。この構成には 2 つのシステムが関与し、そのうち WireGuard が担当するのは一方だけです。

WireGuard が担当する設定は、A 上で B の AllowedIPs に 192.168.50.0/24 を追加することです。これにより、A はそのプレフィックス宛ての通信に B を選択し、B から届いた送信元アドレスがそのプレフィックスに含まれるパケットを受け入れます。ただし、より具体的なプレフィックスによって別のピアが選択される場合を除きます。これを設定しないと、cryptokey routing には宛先に対応する鍵がなく、送信元に対する許可もありません。

カーネルが担当する設定は、B 上で net.ipv4.ip_forward を 1 にすることです。そうしないと、B 自身宛てではない復号済みパケットをカーネルがすべて破棄します。B のファイアウォールの forward chain では、この通信を許可する必要があります。LAN 上のホストには 10.8.0.0/24 宛ての通信を B に戻すルートが必要です。これがない場合は、B で source NAT を適用して、応答が B 経由で戻るようにします。

WireGuard の処理は、復号済みパケットをカーネルに渡した時点で終わります。その後は通常の Linux のルーティングとフィルタリングであるため、この問題は nft list ruleset のカウンターや ip -s link show wg0 に現れ、wg show には現れません。Web インターフェースでピアを管理する場合は、Docker で wg-easy を実行することでピアエントリを生成できます。ただし、転送処理は引き続きホストのカーネルとファイアウォールのサポートに依存します。調整レイヤーによってプレフィックスを配布する場合も、この分担は変わりません。Tailscale subnet router を使って VPS からプライベートネットワークを広告すると、すべてのピアで手動で AllowedIPs を編集する必要はなくなりますが、ルーターでは引き続き IP forwarding を有効にする必要があります。Tailscale はデフォルトで独自のファイアウォールルールを管理します。

WireGuard がカーネル内で動作する理由

wg0 はネットワークデバイスドライバーです。パケットは通常のルーティングスタックを経由して wg0 に到達し、カーネルワーカーによって暗号化されます。その後、ユーザー空間に移ることなく UDP ソケットから送信されます。WireGuard は 2020 年 3 月に Linux 5.6 の mainline に統合されました。Ubuntu 24.04 と Debian 13 には含まれているため、不足しているのは wireguard-tools パッケージだけです。

通常のインターフェイスとして動作することには、実用上の意味があります。tcpdump -ni wg0 には暗号化前の内部パケットが表示され、tcpdump -ni eth0 udp port 51820 には暗号化後の外部パケットが表示されます。両者を比較すれば、どちらの方向に問題があるかをすぐに判断できます。netfilter とトラフィックシェーピングは、wg0 を他のリンクと同じように扱います。コンテナ仮想化など、ホストのカーネルを共有してカーネルモジュールを利用できない環境では、wireguard-go が TUN デバイス上のユーザー空間で同じプロトコルを実装します。ただし、すべてのパケットがカーネル境界を 2 回通過するため、スループットが実際に低下します。

WireGuard が保護しないもの

脅威モデルは意図的に限定されています。また、このように静かなプロトコルは、都合のよい期待を招きます。明確に理解してください。

  • WireGuard を使用している事実は隠れません。ハンドシェイクメッセージのサイズは固定され、先頭バイトでメッセージ種別が示され、トランスポートには UDP が使用されます。ディープパケットインスペクションで容易に識別でき、VPN を好まないネットワークではブロックされる可能性があります。難読化は設計上含まれていません。
  • 通信量やタイミングは隠れません。ペイロードは 16-byte 境界までしかパディングされないため、監視者には送信した時刻と、おおよその通信量が分かります。
  • 最後に確認されたエンドポイントを保持します。パブリックアドレスを持つ peer は、相手側の現在のパブリック IP を保存し、wg show に表示します。設定内で固定されたトンネルアドレスと組み合わせると、ネットワークを移動するユーザーを追跡できる安定した識別子になります。自分の VPS では問題ありません。商用サービスがプロトコルの上にレイヤーを追加する理由もここにあります。
  • 認証するのは人物ではなく key です。private key ファイルを保持する者が peer になります。/etc/wireguard は mode 700 にし、key ファイルは 600 にしてください。
  • 失効リストも有効期限もありません。アクセスを終了するには、その peer エントリを保持しているすべてのサーバーから削除します。static key は削除するまで有効です。

これらは WireGuard が脆弱だという意味ではありません。WireGuard が小さく設計されているという意味です。重要なのはその点です。WireGuard は認証と暗号化を担い、identity management と address allocation は、その上に構築する仕組みに任せます。WireGuard と Tailscale の比較で説明したような coordination layer は、まさにこの不足を補うために存在し、ここまで説明してきたものと同じ data plane を使用します。そのような layer を導入した後は、トンネル内で運用するサービスにアクセスできるユーザーを決める必要があります。単一の port については、Tailscale serve と funnel の選択がこの判断を定めます。

FAQ

WireGuard の cryptokey routing とは何ですか?

Cryptokey routing は、すべてのパケットを公開鍵に関連付けるルールです。各 peer のエントリには、AllowedIPs にプレフィックスのリストが含まれます。送信時、WireGuard はパケットの宛先を各 peer のリストと照合し、最長一致のプレフィックスを優先して peer を選択します。そのため、このリストはルーティングテーブルとして機能します。受信時は、パケットを復号して認証した後、内部の送信元アドレスに対する最長一致検索で同じ peer が選択されなければ、パケットを破棄します。そのため、このリストはアクセス制御リストとしても機能します。WireGuard に個別のルーティング設定や内部ファイアウォールがないのは、1 つのリストで両方の役割を担うためです。

PersistentKeepalive は両方の peer に必要ですか?

いいえ。NAT (network address translation) の内側、またはステートフルファイアウォールの内側にある側に設定します。通常はクライアント側です。WireGuard はアイドル中に何も送信しないため、相手側からその peer へ到達するためのマッピングが失効します。多くの場合、1 分以内に失効し、トンネルが一方向だけ停止したように見えます。PersistentKeepalive = 25 は、その peer との間で認証済みトラフィックが 25 秒間ない場合に、認証済みの空パケットを送信します。これにより、マッピングを維持します。公開アドレスがあり、UDP ポートを開放している peer には必要ありません。

トンネル経由の ping で「Required key not available」と表示されるのはなぜですか?

宛先アドレスがどの peer の AllowedIPs にも含まれていないためです。cryptokey routing がパケットの暗号化に使用する鍵を見つけられず、カーネルが送信を拒否しています。wg show wg0 allowed-ips を実行し、その出力を ping の宛先アドレスと比較してください。よく似たエラー Destination address required は別の問題です。peer は一致しましたが、WireGuard にその peer の endpoint がありません。endpoint が設定されておらず、その peer から認証済みパケットもまだ到着していないためです。

ファイアウォールで WireGuard を検出してブロックできますか?

はい。WireGuard はトラフィックを認証して暗号化しますが、自身を偽装しようとはしません。ハンドシェイクの開始メッセージと応答メッセージはそれぞれ固定長の 148 バイトと 92 バイトです。Cookie 応答は 64 バイトで、すべてのメッセージの先頭 1 バイトが種類を示します。さらに、トランスポートには UDP を使用するため、ディープパケットインスペクションでプロトコルを容易に特定できます。UDP をブロックするネットワークや、プロトコルのフィンガープリントを調べるネットワークでは停止します。トンネルを隠すには、別の仕組みでトンネルを包む必要があります。これは WireGuard の設定ではなく、別のツールによって行います。

この記事は役に立ちましたか?