Shadowrocket WireGuard 設定教學:Private Key、Peer、Allowed IPs 與 MTU

逐項說明 Shadowrocket 的 WireGuard 設定欄位:本機私鑰與位址、Peer 公鑰與 Endpoint、Allowed IPs 的設定方式,以及 MTU 錯誤時的症狀。

本文重點

本文適合已向自己的服務商取得 WireGuard 設定,準備在 Shadowrocket 逐項核對參數的使用者。先釐清本機身分、隧道位址與遠端 Peer,再說明 Allowed IPs 和應用程式規則的差異,最後依序從握手、小流量到大流量排查 MTU。範例位址僅用於說明欄位,不能作為可連線的伺服器。

一、先分清本機 Interface 與遠端 Peer

Shadowrocket(小火箭)的 WireGuard 設定不能當成「伺服器位址加密碼」。WireGuard 以公鑰識別通訊對端:本機保管自己的 Private Key,並將對應的 Public Key 登記在遠端;本機的 Peer 欄位則填入遠端 Public Key。兩端的金鑰必須相互對應,只有伺服器位址並不足以建立有效隧道。

標準 WireGuard 設定檔通常分為 [Interface] 與 [Peer]。前者描述本機身分、隧道內位址等參數,後者描述通訊對端,以及允許經由該對端傳輸的位址範圍。Shadowrocket 的節點表單可能將這些欄位拆成多個輸入項目;核對時應依欄位用途對應,不要把整份檔案貼進單一金鑰欄位。

32 位元組
WireGuard 公鑰與私鑰的原始長度;設定檔通常以 Base64 表示
UDP
WireGuard 的外層傳輸協定;判斷握手不以 TCP 連線成功為準
51820
常見範例連接埠,並非所有服務都使用固定連接埠

二、Private Key、Address 與 Peer 各自要填什麼

Private Key 是本機私鑰,不是遠端密碼。它與本機 Public Key 成對。若更換本機私鑰,卻沒有請遠端同步登記新的本機公鑰,遠端就無法依原有身分接受通訊。不要為了「再試一次」就任意產生或更換金鑰;應先確認服務商提供的設定是否完整,以及是否仍適用於目前裝置。

Address 是隧道內的位址,不是 Endpoint。例如 10.66.66.2/32 表示本機在隧道中的 IPv4 位址與前綴。不要在此填入伺服器公網 IP、目前的 Wi-Fi 位址或目標網站位址。如果服務商提供 IPv4 和 IPv6 兩個位址,請依表單支援的輸入方式分別填寫,不要自行推算未分配的位址。

本機 Interface

Private Key
填入服務商設定中的本機私鑰,保留 Base64 字元與末尾填充字元
Address
例如 10.66.66.2/32,僅為隧道位址格式範例
MTU
控制隧道介面允許的 IP 封包大小,優先沿用設定值
DNS
若原始設定包含此項,請另行確認 Shadowrocket 的 DNS 設定是否有對應處理

Address、DNS 和 MTU 是設定參數,不能取代金鑰驗證資訊。

遠端 Peer

Public Key
填入遠端公鑰,不是本機公鑰,也不是任一方的私鑰
Endpoint
例如 192.0.2.10:51820,位址與連接埠皆為教學範例
Allowed IPs
例如 0.0.0.0/0,實際範圍依服務商設定與用途而定
Preshared Key
可選的附加共享金鑰;若遠端有啟用,兩端必須一致

原始檔案中的簡寫欄位名稱如 PublicKey、AllowedIPs,在此依用途拆列。

Preshared Key 與 Private Key 是不同欄位。前者是雙方約定的附加共享密鑰,後者只用於本機身分。原始設定未提供 Preshared Key 時,不要自行填入隨機字串。即使金鑰長度與外觀相似,也不代表欄位可以互換。

三、Endpoint 位址、連接埠與 UDP 條件

Endpoint 指定建立 WireGuard 通訊時使用的外部網路目的地。若表單將欄位拆成 Address 或 Server 與 Port,位址欄只填主機名稱或 IP,連接埠欄填入服務商提供的數字;不要加上 https:// 或網頁路徑。原始檔案使用 IPv6 Endpoint 時,常見組合格式為 [2001:db8::10]:51820,方括號用來區分位址中的冒號與連接埠分隔符號。

Persistent Keepalive 會定期傳送保活封包,協助維持 NAT 對應。設定中的 PersistentKeepalive = 25 是常見的 25 秒間隔範例,並非所有網路都必須使用此數值。它無法修正錯誤的 Public Key、未開放的遠端連接埠或失效的帳戶權限。

四、Allowed IPs 不等於 Global Routing 分流規則

依 WireGuard 的定義,Allowed IPs 會參與選擇用來傳送目標位址流量的 Peer,也會限制從該 Peer 接收的內層來源位址。0.0.0.0/0 涵蓋所有 IPv4 位址,::/0 涵蓋所有 IPv6 位址;只填前者不會自動涵蓋後者。若服務商只提供一個私有網路範圍,通常表示此設定用於存取特定內網;自行擴大範圍,不代表遠端就能轉送整個網際網路的流量。

Shadowrocket 還有另一層流量判斷:Global Routing 與 Config 規則會先決定流量是否交給這個節點。即使 Peer 的 Allowed IPs 包含預設路由,符合 DIRECT 規則的流量也不會因此自動改走該節點。反過來,應用程式規則將目標流量交給 WireGuard,也不代表遠端已設定好對應的轉送、路由與出口。

設定層級具體範例用途
Peer 的 Allowed IPs10.20.0.0/16指定該 Peer 對應的內層位址範圍,不是網域規則
Peer 的預設路由範圍0.0.0.0/0, ::/0涵蓋兩種 IP 位址族;遠端仍須具備相應的轉送能力
Config 的網域規則DOMAIN-SUFFIX,example.com,DIRECT決定符合網域的流量使用 DIRECT 策略
Config 的位址規則IP-CIDR,192.0.2.0/24,DIRECT依目標 IPv4 網段選擇策略,不會修改 Peer 金鑰

Global Routing 中的 Proxy 用於代理路由,Direct 用於直連,Config 依目前設定的規則處理,Scene 則依已設定的情境運作。排查時先記錄目前的模式;若在 Direct 模式下測試外部網站,結果不能用來證明 WireGuard 節點已可用。使用 Config 時,請確認測試目標實際符合的規則與策略。

五、依序在 Shadowrocket 輸入設定並驗證

以下以 iPhone / iPad 的 Home 節點編輯流程為例。先保留服務商提供的原始設定與目前可用的設定,再逐項輸入;介面欄位的排列可能不同,但本機與 Peer 的對應關係不變。若已有透過訂閱匯入的 WireGuard 節點,請優先開啟節點編輯頁核對,不要重複建立多個名稱相似、參數卻不同的節點。

  1. 準備參數

    向你的服務商取得設定,分清 Interface 與 Peer,記下 Endpoint、連接埠、Address、Allowed IPs 和 MTU;不要把金鑰抄進公開筆記。

  2. 選擇協定

    Home → 右上角「+」→ Type → WireGuard。依表單區分本機參數與 Peer 參數,不要把整份設定貼進 Private Key 欄位。

  3. 逐項輸入

    輸入本機 Private Key 與 Address,再輸入 Peer 的 Public Key,以及 Endpoint 對應的位址與連接埠;其他選項依原始設定填寫後儲存。

  4. 選擇節點

    返回 Home,點選伺服器左側的圓點,並檢查 Global Routing。若要排除規則影響,可暫時切換至 Proxy 進行驗證,完成後再恢復原本模式。

  5. 驗證流量

    開啟連線開關;首次出現新增 VPN 設定提示時,依系統指示操作。執行 Connectivity Test,再分別測試一個小型網頁與較大的傳輸,並記錄結果。

Connectivity Test 成功只代表所選測試方法下的連通狀況,不能取代隧道內的實際服務驗證。系統顯示 VPN 已連線,也不代表遠端已成功完成握手。若介面或可用記錄提供握手時間、傳送量與接收量,可一併觀察;只有傳送計數增加,不代表雙向通訊已正常。

六、MTU 設定錯誤的症狀與單一變數調整方式

MTU 限制隧道介面內 IP 封包的大小,單位為位元組。WireGuard 會在內層 IP 封包外加上加密與 UDP/IP 封裝,外部路徑也可能經過其他隧道,因此不能直接套用實體網卡常見的 1500。1420 是常見設定值,但並非適用於所有網路;實際可用值取決於外部位址族與路徑承載能力。

MTU 或路徑 MTU 探測異常的典型現象包括:握手與少量資料似乎正常,小型網頁能開啟,但較大的回應、上傳或持續傳輸停滯。這些現象也可能是封包遺失、DNS、遠端限制或應用程式逾時所致,因此只能作為排查線索。若連握手都未建立,應優先檢查金鑰、Endpoint 與 UDP,而不是先調整 MTU。

沿用設定中的 MTU

建議

先使用服務商明確提供的數值,保留一組可比較的基準。原始設定未指定時,先沿用用戶端預設值,不要依網路速度猜測數值。

適用情況:首次輸入設定,尚未確認有大封包傳輸問題

降低 MTU 進行比較

若原值為 1420,可在其他參數維持不變的情況下,分別以 1380、1280 作為診斷比較值。每次修改後都要儲存並重新連線,不要直接將測試值當成最終最佳值。

適用情況:小流量正常,但較大的傳輸一再停滯

提高 MTU

只有在路徑條件與測試結果支持時才考慮。數值較大不代表速度較快;超出路徑承載範圍反而可能造成分片、封包遺失或連線等待。

適用情況:已有穩定基準,且能控制測試條件的進階除錯

七、依故障階段定位,不要把所有問題都歸咎於金鑰錯誤

排查應由外而內:先確認 Endpoint 可解析且設定正確,再確認 UDP 通訊與身分參數,接著檢查內層位址、路由、DNS 與應用程式分流。不要一次修改五個欄位;即使連線恢復,也無法確認真正有效的變更,還可能留下錯誤的位址範圍或不必要的保活設定。

觀察到的現象優先檢查下一步
Endpoint 主機名稱無法解析主機名稱拼寫、目前使用的 DNS、網路連線先恢復名稱解析,不要更改 Private Key
未見有效握手或雙向流量UDP 連接埠、遠端 Public Key、本機金鑰登記、Preshared Key逐項向服務商核對,不要直接提供私鑰
握手正常,但無法連上目標Address、Allowed IPs、遠端轉送、Global Routing 與規則確認目標位址確實由此節點承載
可用 IP 存取,但網域名稱失敗DNS 解析,以及 DNS 請求實際採用的路由單獨檢查解析路徑,不要先重建 Peer
小型請求正常,大型傳輸停滯MTU、路徑封包遺失、遠端限制固定其他條件,逐次降低 MTU 進行比較
訂閱更新後恢復原有參數確認節點是否由訂閱管理向服務商確認來源設定,分清訂閱節點與手動節點

訂閱更新可能會重新套用服務商提供的節點參數。若為了診斷而手動修改欄位,請記錄修改內容,並確認之後更新是否會覆蓋。不要因為本機暫時調整成功,就忽略來源設定中的錯誤;也不要為了保留一次測試值而長期停止必要的設定更新。

下載 Shadowrocket