Shadowrocket WireGuard 設定教學:PrivateKey、PublicKey 與 AllowedIPs 參數說明

逐一說明 Shadowrocket 中 WireGuard 的密鑰組、Address、DNS、MTU、AllowedIPs 與 Endpoint 欄位,並整理常見填寫錯誤。

本文摘要

本文適合已取得服務商提供的 WireGuard 設定,並需要在 Shadowrocket 中核對參數的使用者。先分辨本機與遠端身分,再檢查隧道位址、目標網段及 UDP 端點,最後透過 Global Routing 區分協定連線問題與規則選擇問題。範例位址僅供說明欄位,無法用來連線。

一、先區分 [Interface] 與 [Peer]

WireGuard 設定通常分為 [Interface] 和 [Peer] 兩個部分。前者描述本機隧道介面,後者描述通訊對端。將設定輸入 Shadowrocket 時,應依欄位意義逐一對應,而不是照複製順序填寫。以下操作以 iPhone / iPad 為例;其他平台的欄位排列可能不同。

PrivateKey 屬於本機;[Peer] 內的 PublicKey 屬於遠端。伺服器端也必須登錄本機對應的公鑰,並為本機配置正確的位址。只在用戶端填妥欄位,不代表伺服器端已完成配對。

32 位元組
WireGuard 原始私鑰與公鑰各自的長度
UDP
WireGuard 外層傳輸所使用的協定
51820
本文範例使用的連接埠,實際設定請以現有設定為準

WireGuard 的私鑰、公鑰及選用的預共享密鑰通常以 Base64 文字表示,標準編碼為 44 個字元,結尾常是 =。長度相同不代表用途相同,也不能據此證明密鑰有效。請勿將這些欄位當成密碼、訂閱網址或憑證內容。

二、PrivateKey、PublicKey 與 PresharedKey 的對應關係

本機身分

PrivateKey
本機私鑰,保留在本機設定中,不要傳給協助排查的人員。
本機 PublicKey
由本機 PrivateKey 推導而來,供伺服器端登錄本機身分。
Address
伺服器端分配給本機的隧道位址,不是公網伺服器位址。

更換本機 PrivateKey 後,也必須同步更新伺服器端登錄的本機公鑰。

遠端身分

[Peer] PublicKey
遠端公鑰,用來識別本機要連線的對端。
PresharedKey
選用的額外共享密鑰;若有啟用,兩端必須一致。
Endpoint
遠端可連線的位址與 UDP 連接埠。

現有設定若沒有 PresharedKey,請勿自行產生並填入。

最常見的填錯方式,是將本機公鑰填入遠端的 PublicKey,或將遠端公鑰誤填為本機的 PrivateKey。這兩種錯誤可能仍通過文字格式檢查,卻無法建立正確的加密連線。核對時應同時確認「密鑰屬於哪一端」以及「它是公鑰還是私鑰」。

請勿公開完整的 WireGuard 設定。PrivateKey 與 PresharedKey 都是敏感資訊。需要回報問題時,請保留欄位名稱、錯誤訊息及網路狀況,並刪除密鑰內容;若私鑰已外洩,應更換密鑰並請伺服器端更新對應公鑰。

三、Address、DNS 與 MTU 各自的作用

Address 是隧道內部的本機位址,通常會帶有 CIDR 前綴,例如 10.66.0.2/32。它不是目前 Wi-Fi 的區域網路位址,也不是 Endpoint。請勿因裝置切換 Wi-Fi,就將這個位址改成新的區域網路位址。

欄位範例或單位核對重點
Address10.66.0.2/32使用已分配的位址;請勿自行擴大前綴長度。
DNSDNS 伺服器 IP 位址確認解析器可連線,並核對 Shadowrocket 目前的 DNS 設定。
MTU位元組,例如 1420限制隧道內層 IP 封包大小,並非連線速度。

DNS 和 Address 都不是 WireGuard 握手封包中的身分欄位。常見設定檔中的這些項目由用戶端或設定工具處理。將檔案內容對應至 Shadowrocket 時,不能假設檔案中的每個項目都會自動覆寫 App 的全域設定;也應核對 Settings → DNS 中實際使用的解析設定。

MTU 設定過大時,可能出現小型請求有回應、較大傳輸卻停滯的情況,但相同現象也可能是其他網路問題所致。外層使用 IPv4 時,WireGuard 封裝的典型額外負擔為 60 位元組;外層使用 IPv6 時則為 80 位元組。在底層 MTU 為 1500 的情況下,1420 是兼顧 IPv6 外層的常見起始值,但不適用於所有網路鏈路。

四、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 規則已符合,後續的代理策略便不會再接手處理該請求。

五、Endpoint 與 PersistentKeepalive 的填寫原則

Endpoint 是本機首先需要透過目前網路存取的遠端位址,可以是 IP 位址或主機名稱,並附上連接埠。標準設定的寫法為 192.0.2.10:51820;若編輯介面將位址與連接埠分開,請分別填寫,不要把整串內容重複放進兩個欄位。

  1. 位址欄位不需加上 https://,也不要附加網頁路徑或貼上訂閱查詢參數。
  2. 標準設定中的 IPv6 端點應使用方括號,例如 [2001:db8::10]:51820,避免將位址中的冒號誤認為連接埠分隔符號。
  3. 確認遠端正在監聽設定指定的 UDP 連接埠。TCP 連接埠探測成功,不能證明相同編號的 UDP 連接埠可連線。
  4. 使用主機名稱時,先確認它能在連線建立前解析,避免依賴尚未建立的隧道內 DNS。

PersistentKeepalive 的單位是秒,用來視需要傳送保活資料,以維持 NAT 或防火牆狀態。25 是常見設定值,並非必要值;未設定或設為 0 通常代表停用定期保活。它不是連線逾時設定,也無法修正錯誤的公鑰或伺服器端未開放的連接埠。

若只在 Wi-Fi 與行動網路切換後發生中斷,請記錄切換時間、能否重新建立連線及 UDP 可達性,再判斷是否需要保活。不要以不斷縮短保活間隔取代身分與端點檢查。

六、在 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 設定正確,因為測試可能未經過該連線。

適用情境:確認目標在目前本機網路中的直連狀況。

七、依據現象縮小問題範圍

不要只憑「連線開關已開啟」就判定 WireGuard 已完成握手。開關代表用戶端的連線狀態;遠端身分是否相符、UDP 是否雙向可達,以及特定目標的資料傳輸狀況,仍須分別驗證。以下是排查順序,不代表可僅憑單一現象確定故障原因。

觀察到的現象優先核對項目下一步
無法建立有效通訊兩端的公鑰登錄、PresharedKey、Endpoint、UDP 連接埠請聯絡自己的服務商,核對伺服器端監聽狀態與對端登錄資訊。
指定 IP 可連線,網域名稱失敗DNS 可達性與實際解析路徑以相同目標比對網域解析結果,避免比較不同服務。
小型請求正常,大量傳輸停滯路徑 MTU、封包遺失及遠端限制保留其他設定,只調整 MTU,再重複相同測試。
Proxy 正常,Config 異常目前使用的設定、符合的規則與策略選擇檢查目標是否已先符合 DIRECT 或其他策略。
訂閱更新後參數變更更新前後的欄位與伺服器端配置核對訂閱來源傳回的內容,不要反覆覆寫服務商已變更的參數。

向自己的服務商回報時,請提供系統平台、使用的網路類型、發生條件、已核對的欄位名稱及已去除敏感資訊的錯誤記錄。請勿傳送 PrivateKey 或 PresharedKey。若伺服器端確認已更換公鑰、連接埠或位址配置,請同步更新對應欄位,再從協定測試開始重新檢查。

Shadowrocket 官方下載