本文適合已向自己的服務商取得 WireGuard 設定,準備在 Shadowrocket 逐項核對參數的使用者。先釐清本機身分、隧道位址與遠端 Peer,再說明 Allowed IPs 和應用程式規則的差異,最後依序從握手、小流量到大流量排查 MTU。範例位址僅用於說明欄位,不能作為可連線的伺服器。
一、先分清本機 Interface 與遠端 Peer
Shadowrocket(小火箭)的 WireGuard 設定不能當成「伺服器位址加密碼」。WireGuard 以公鑰識別通訊對端:本機保管自己的 Private Key,並將對應的 Public Key 登記在遠端;本機的 Peer 欄位則填入遠端 Public Key。兩端的金鑰必須相互對應,只有伺服器位址並不足以建立有效隧道。
標準 WireGuard 設定檔通常分為 [Interface] 與 [Peer]。前者描述本機身分、隧道內位址等參數,後者描述通訊對端,以及允許經由該對端傳輸的位址範圍。Shadowrocket 的節點表單可能將這些欄位拆成多個輸入項目;核對時應依欄位用途對應,不要把整份檔案貼進單一金鑰欄位。
二、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,方括號用來區分位址中的冒號與連接埠分隔符號。
- 主機名稱 Endpoint:必須先完成 DNS 解析;若解析失敗,還沒進入 WireGuard 金鑰驗證階段。
- 連接埠:以設定為準。將 51820 改成 443 不會自動建立可用連線,也不會讓 WireGuard 變成 HTTPS。
- UDP 可連通性:目前使用的 Wi-Fi、行動網路、路由器與遠端防火牆都可能影響 UDP;一般網頁能開啟,不代表該 UDP 連接埠可連通。
- 切換網路:從 Wi-Fi 切換到行動網路後若有差異,請分別記錄網路、Endpoint 位址族與測試結果,不要同時更換金鑰。
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 IPs | 10.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 節點,請優先開啟節點編輯頁核對,不要重複建立多個名稱相似、參數卻不同的節點。
準備參數
向你的服務商取得設定,分清 Interface 與 Peer,記下 Endpoint、連接埠、Address、Allowed IPs 和 MTU;不要把金鑰抄進公開筆記。
選擇協定
Home → 右上角「+」→ Type → WireGuard。依表單區分本機參數與 Peer 參數,不要把整份設定貼進 Private Key 欄位。
逐項輸入
輸入本機 Private Key 與 Address,再輸入 Peer 的 Public Key,以及 Endpoint 對應的位址與連接埠;其他選項依原始設定填寫後儲存。
選擇節點
返回 Home,點選伺服器左側的圓點,並檢查 Global Routing。若要排除規則影響,可暫時切換至 Proxy 進行驗證,完成後再恢復原本模式。
驗證流量
開啟連線開關;首次出現新增 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
只有在路徑條件與測試結果支持時才考慮。數值較大不代表速度較快;超出路徑承載範圍反而可能造成分片、封包遺失或連線等待。
適用情況:已有穩定基準,且能控制測試條件的進階除錯
- 使用相同網路、相同目標與相同傳輸工作進行比較;調整 MTU 時不要同時更換 Peer 或 DNS。
- IPv6 的最小鏈路 MTU 為 1280;若需承載 IPv6,不應把降至 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 進行比較 |
| 訂閱更新後恢復原有參數 | 確認節點是否由訂閱管理 | 向服務商確認來源設定,分清訂閱節點與手動節點 |
訂閱更新可能會重新套用服務商提供的節點參數。若為了診斷而手動修改欄位,請記錄修改內容,並確認之後更新是否會覆蓋。不要因為本機暫時調整成功,就忽略來源設定中的錯誤;也不要為了保留一次測試值而長期停止必要的設定更新。