Shadowrocket WireGuard 設定參數解析:PrivateKey、PublicKey、AllowedIPs 與 MTU

說明在 Shadowrocket 中新增 WireGuard 時各參數的用途與填寫來源,所有範例值皆為虛構,並整理常見填寫錯誤的排查方式。

本文重點速覽

設定 WireGuard 前,先分清本機金鑰、對端金鑰、隧道位址與公開端點,再檢查路由範圍和 MTU。本文以已持有服務商提供的設定或自管伺服器資料為前提,操作步驟以 iPhone/iPad 上的 Shadowrocket(小火箭)為例;Mac/Windows/Android/Linux 使用者可依參數意義核對對應編輯頁,不要直接照搬行動版的按鈕位置。閱讀本文後,可逐項確認設定來源,並分辨握手、分流、DNS 與封包大小問題。

一、先分清本機與對端,再填寫參數

WireGuard 使用 UDP 傳輸,並透過金鑰識別通訊雙方。它不是以使用者名稱和密碼登入:本機持有自己的 PrivateKey,伺服器則登記與該私鑰配對的本機 PublicKey;用戶端的 Peer 欄位填入伺服器的 PublicKey。雙方的 PublicKey 不可因為名稱相同就互換。

參數歸屬:本機 Interface 與遠端 Peer

本機 Interface
  • PrivateKey:本機私鑰,只保留在需要使用它的可信任裝置上。
  • Address:分配給本機的隧道內部位址,不是伺服器的公開 IP 位址。
  • MTU:隧道介面可承載的最大封包大小,依設定與實際網路路徑調整。
  • 本機 PublicKey:由本機私鑰衍生,提供給伺服器端登記。
遠端 Peer
  • PublicKey:伺服器的公鑰,由伺服器管理者提供。
  • Endpoint:可連線至伺服器的網域名稱或 IP 位址,以及 UDP 通訊埠。
  • AllowedIPs:此 Peer 對應的 IP 前綴範圍。
  • PresharedKey:雙方約定的選用附加金鑰,不可自行填入任意值。

核對時,務必確認「這是哪一端的參數」,不可把伺服器設定檔中的 PrivateKey 直接當成用戶端私鑰。

如果服務商提供完整的用戶端設定,請使用其中相互配套的金鑰與 Address。若改在本機重新產生金鑰,必須同步更新伺服器上登記的用戶端 PublicKey;只修改手機上的 PrivateKey,會破壞原有配對。請勿將完整設定截圖或私鑰貼到公開討論區。

二、逐項對照 PrivateKey、PublicKey 與位址欄位

以下使用 WireGuard 設定檔的標準欄位名稱說明其用途,不代表各平台的 Shadowrocket 編輯頁都會顯示完全相同的欄位。編輯頁可能將 Endpoint 拆分為位址與通訊埠,也可能分開填寫本機 IPv4、IPv6;請依欄位意義對應,不要只看排列順序就照抄。

欄位填寫來源與用途常見錯誤
PrivateKey在本機產生並完成伺服器登記的配套私鑰,或服務商分配的用戶端私鑰。填入伺服器私鑰、漏掉末尾字元,或複製時混入空格與換行。
PublicKeyPeer 欄位填入伺服器公鑰;伺服器端另行登記用戶端公鑰。把用戶端自己的公鑰填入遠端 Peer。
PresharedKey選用的預共享金鑰;啟用時,兩端的值必須完全一致。伺服器端未啟用卻自行填入,或誤填 PrivateKey。
Address分配給本機的隧道位址與前綴,例如示範位址 192.0.2.2/32。填入伺服器公開 IP 位址,或直接重複使用其他裝置的內部位址。
Endpoint伺服器公開位址與實際 UDP 通訊埠,例如 example.com:51820。加入網頁通訊協定前綴,或認定所有伺服器通訊埠都是 51820。
DNS若設定中包含此項,這是配套工具約定的 DNS 設定,不屬於 WireGuard 握手本身。把 DNS 位址當成 Address,或以為只修改這項就代表應用程式的 DNS 設定已全部生效。

WireGuard 的 PrivateKey、PublicKey 與 PresharedKey 通常是 32 位元組資料的 Base64 表示,常見文字長度為 44 個字元。但長度正確不代表金鑰正確,也不代表兩端已配對。請逐字核對原始資料,不要為了湊足長度而補字元。

32 位元組
WireGuard 金鑰的原始長度
51820
本文示範 UDP 通訊埠,並非固定必填值
2 組前綴
IPv4 與 IPv6 的預設範圍須分別考量

三、在 Home 新增 WireGuard 並進行初步驗證

備妥本機 PrivateKey、分配的位址、遠端 PublicKey、Endpoint,以及服務商要求的其他欄位後,再開始編輯。Home 用於管理連線項目,Config 用於管理規則設定檔;將規則檔匯入 Config,不代表已建立可用的 WireGuard 項目。

  1. 整理資料

    將原始設定保存在安全的位置,並分別標示本機與遠端參數。記下目前的 Global Routing 狀態;若已有可用項目,請保留,不要直接覆蓋。

  2. 選擇類型

    開啟 Home → 點選右上角「+」→ Type → WireGuard。以下依欄位意義填寫;不同平台與介面版面可編輯的項目可能不同,請以實際顯示為準。

  3. 填入參數

    將 Endpoint 對應到伺服器位址與通訊埠,並將本機 PrivateKey、本機位址、遠端 PublicKey 填入各自欄位。只有原始設定要求 PresharedKey 時才填寫。

  4. 儲存並選取

    儲存後返回 Home,選取剛建立的 WireGuard 項目。為減少規則干擾,可暫時將 Home → Global Routing 設為 Proxy,然後啟用連線;若系統要求新增 VPN 設定,請依系統提示確認。

  5. 分階段驗證

    先存取已知可用的目標,再觀察是否持續有資料收發。若有伺服器管理權限,請確認最近的握手時間與收發計數;驗證完成後,將 Global Routing 還原為日常使用的狀態。

四、AllowedIPs 與 Global Routing 屬於不同層級的規則

AllowedIPs 是 WireGuard 的 IP 前綴集合:傳送方向會將目標位址對應到 Peer;接收方向則用來檢查解密後封包的來源位址是否屬於該 Peer。此欄位不接受網域規則,不能填入 DOMAIN-SUFFIX,example.com,PROXY。

Shadowrocket 的 Global Routing 決定流量在應用程式分流層如何處理。即使 WireGuard 端的 AllowedIPs 涵蓋所有位址,也不會讓 Global Routing 中設為直連的流量自動改走該項目。反過來,選擇 Proxy 也無法修復伺服器缺少轉送路由的問題。

Config:依設定檔核對

建議

依目前 Config 的規則與策略處理流量。檢查 DOMAIN-SUFFIX、GEOIP、IP-CIDR 與 FINAL 的順序和目標策略,確認所需請求確實交由 WireGuard 項目或包含該項目的策略群組處理。

適用情況:連線驗證完成後的日常規則分流。

Proxy:減少分流變因

在全域路由層選擇代理路徑,用來排除 Config 規則造成的差異。仍須確認目前選取的項目、隧道範圍與伺服器可連線狀態;這不代表所有系統流量都一定會進入遠端。

適用情況:短時間確認問題是否由規則分流造成。

Direct:直連對照

在全域路由層選擇直連路徑。可用來比對本機網路能否存取同一目標,但直連成功不代表 WireGuard 設定正確。

適用情況:區分目標本身無法連線或隧道路徑故障。

若目前使用 Scene,請先確認該場景實際採用的路由方式,再進行對照測試。Settings → On Demand 用於管理隨選連線條件;它不是 AllowedIPs,也不負責將網域設為代理規則。排查期間請記錄其狀態,避免自動連線條件干擾手動測試。

五、依實際狀況調整 MTU 與 Keepalive,不套用固定值

MTU 控制隧道介面可承載的 IP 封包大小。外層網路還須承載 WireGuard、UDP 與 IP 標頭,因此隧道 MTU 不能直接照抄實體介面的數值。1420 是常見的起始值,但外層 IPv4/IPv6、行動網路與其他封裝方式都會影響實際可用大小。

觀察到的狀況優先檢查項目調整方式
完全沒有握手Endpoint、UDP 是否放行、金鑰配對、PresharedKey先修正身分與連線可達性;MTU 通常不是優先檢查項目。
小型請求成功,但大型頁面或上傳停滯路徑 MTU、封包遺失與伺服器端轉送記下原始值;若編輯頁支援,可嘗試將 MTU 從 1420 降至 1380,再以相同目標重複測試。
閒置一段時間後,恢復存取較慢NAT 對應逾時、網路切換、伺服器狀態若雙方設定條件允許,可評估使用 PersistentKeepalive,不要反覆重新產生金鑰。
只有網域名稱無法存取DNS 伺服器可連線性、解析結果與 DNS 路徑分辨是解析失敗還是連線失敗;不要先改 MTU 或 PublicKey。

PersistentKeepalive = 25 表示有需要時每隔 25 秒傳送一次保活封包,是位於 NAT 後方的用戶端常見設定之一,並非每條連線都必須啟用。此設定有助於維持對應,但會增加背景網路活動,也無法解決通訊埠遭封鎖或金鑰錯誤。

每輪只調整一個變數,並記錄網路類型、原始值、新值與重現步驟。若降低 MTU 後沒有穩定改善,請還原原值並繼續檢查;不要把單次網頁載入成功當成通用結論。

六、如何閱讀示範設定與常見問題

以下是用來說明欄位位置的標準 WireGuard 格式文字,不代表 Shadowrocket 各平台都支援通用匯入。所有值皆為虛構範例;金鑰刻意使用無效文字,網域與文件位址也不提供實際服務。這份內容無法建立連線,也不能直接儲存為可用設定。

[Interface]
PrivateKey = DEMO_PRIVATE_KEY_NOT_VALID
Address = 192.0.2.2/32
MTU = 1420

[Peer]
PublicKey = DEMO_SERVER_PUBLIC_KEY_NOT_VALID
PresharedKey = DEMO_PRESHARED_KEY_NOT_VALID
Endpoint = example.com:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25

實際填寫時,請逐項核對自己的原始資料。服務商未提供 PresharedKey,就不要照抄示範內容;若未分配 IPv6 位址或未提供 IPv6 轉送,也不要因示範中有 ::/0 就自行啟用。MTU 與保活值同樣需要依實際網路測試。

PublicKey 複製無誤,為什麼仍然沒有握手?

先確認填入的是伺服器公鑰,再請伺服器管理者核對該 Peer 登記的是目前用戶端的公鑰。接著檢查 Endpoint 的實際 UDP 通訊埠與 PresharedKey;格式正確只能排除輸入格式錯誤,無法證明雙方設定相符。

已完成握手但網頁無法開啟,接下來檢查什麼?

先在 Home 確認選取的 WireGuard 項目,再透過 Global Routing → Proxy 進行短時間對照。若仍無法連線,請檢查伺服器端 IP 轉送、出口路由與防火牆;只有網域名稱無法存取時再檢查 DNS,只有大型請求異常時再檢查 MTU。

手機和電腦可以直接複製同一份設定嗎?

先確認服務商是否為每部裝置分配獨立 Peer。多部裝置同時重複使用同一組私鑰與隧道位址,可能導致遠端端點反覆變動;若需同時使用,應分別登記裝置公鑰並分配位址,再各自填寫設定。

訂閱更新後參數改變,需要手動改回來嗎?

先確認該項目是否由自己的訂閱管理。更新可能會重新寫入服務端下發的參數;請區分手動項目與訂閱項目。向自己的服務商確認變更原因後,再決定保留手動設定或繼續使用由訂閱維護的項目。

取得 Shadowrocket 並繼續設定

iPhone/iPad 版在 App Store 一次性付費 $2.99,系統需求請以 App Store 頁面標示為準;Mac(Apple 晶片/Intel)、Windows、Android、Linux 版免費。前往全平台下載頁選擇裝置,再依教學完成基本設定;WireGuard 所需的服務資料請自行準備。

下載 Shadowrocket