Shadowrocket WireGuard 設定教學:Private Key、Public Key、Endpoint 與 MTU 填寫方式

說明如何在 Shadowrocket 新增 WireGuard,逐一解釋金鑰、位址、Endpoint、DNS、MTU 等欄位,並示範如何依服務商提供的設定填寫。

本文速覽

本文適合已向服務商取得 WireGuard 設定的使用者。先分辨用戶端與伺服器端金鑰,再將 Interface、Peer 中的位址、連接埠與 DNS 對應至 Shadowrocket,最後依序排查握手、路由、網域解析及 MTU。文中位址僅用於說明格式,不能作為可連線的服務設定。

一、新增前先分辨 Interface 與 Peer

Shadowrocket(小火箭)的 WireGuard 連線需要一組彼此對應的參數,不是只填入伺服器位址就能使用。常見的 WireGuard 設定檔包含 [Interface] 與 [Peer]:前者描述本機隧道介面,後者描述要連線的遠端。取得檔案後,請先依這兩個區段分類,不要看到 Public Key 就直接複製到任意金鑰欄位。

本文以在 Home 手動新增 WireGuard 為主。若服務商提供的是 Subscribe 連結,請向服務商索取,並依 Home → + → Type → Subscribe 匯入;這與手動填寫 WireGuard 參數是兩種不同的設定方式。請勿將訂閱網址填入 Endpoint,也不要把整段設定文字貼進 Private Key。

2 個區段
Interface 描述本機,Peer 描述遠端
32 位元組
WireGuard 公鑰與私鑰各自的原始長度
UDP
Endpoint 對應的傳輸協定

金鑰通常以 Base64 文字表示,標準編碼常見長度為 44 個字元。長度只能用來發現明顯的複製截斷,不能證明金鑰正確。WireGuard 不使用使用者名稱、密碼或 TLS 憑證進行身分驗證;伺服器必須登錄與本機 Private Key 配對的用戶端 Public Key。

二、Private Key、Public Key 與 Preshared Key 如何對應

Private Key 是本機身分的機密資料;Peer 底下的 Public Key 則用來識別遠端。兩者即使看起來相似,也不能互換。若服務商頁面另外列出「用戶端 Public Key」,那是提供給伺服器登錄的本機公鑰,不是應填入遠端 Public Key 的值。

設定欄位填寫說明常見錯誤
[Interface] PrivateKey填入用戶端的 Private Key,完整保留 Base64 字元。誤填伺服器私鑰,或誤用用戶端公鑰。
[Peer] PublicKey填入伺服器的 Public Key。誤填服務商頁面上的用戶端 Public Key。
[Peer] PresharedKey僅在服務商提供且伺服器已啟用時,才填寫額外的共用金鑰。伺服器未設定卻自行產生,或漏填服務商要求的值。

複製金鑰時,請勿連同 PrivateKey = 這類欄位名稱前綴一起複製,也不要加上引號、換行或尾端空格。若設定來自 QR Code 或匯入檔案,仍應確認它屬於目前裝置;多部裝置共用同一組用戶端身分,可能導致伺服器記錄的 Endpoint 反覆變更,造成連線時斷時續。

三、Address、Endpoint 與 AllowedIPs 的差異

Address 是分配給用戶端的隧道內位址,Endpoint 則是用戶端在公用網路或目前網路中實際連線的遠端位址。兩者用途不同:前者表示「隧道內本機使用哪個位址」,後者表示「加密的 UDP 封包要傳送到哪裡」。請勿將 Endpoint 的公用 IP 填入本機 Address。

欄位格式範例填寫依據
Address10.66.0.2/32使用服務商為此用戶端分配的位址與前綴,請勿自行選擇。
Endpointvpn.example.com:51820包含伺服器主機名稱或 IP,以及實際監聽的 UDP 連接埠。
IPv6 Endpoint[2001:db8::10]:51820在單一 Endpoint 字串中,IPv6 位址須以方括號括住。
AllowedIPs0.0.0.0/0, ::/0表示此 Peer 對應的 IPv4 與 IPv6 位址範圍,不代表已設定好應用程式層級的分流。

連接埠 51820 是常見範例,並非固定要求。服務商提供其他連接埠時,必須依其設定填寫;也不能因為某個網路允許 TCP 443,就推斷 UDP 443 一定可連線。若編輯頁面將位址與連接埠分成兩個欄位,請分別填入主機名稱和數字連接埠,不要把 :51820 一併填入位址欄。

AllowedIPs 在 WireGuard 中會影響 Peer 的位址選擇及接收來源位址限制;Shadowrocket 的 Global Routing 與 Config 則決定哪些請求會送往所選代理。這兩個層面不可混為一談。設定中出現 0.0.0.0/0,不代表 Shadowrocket 中所有請求都已略過規則並選擇此連線。

四、在 Home 新增並測試連線

開始輸入前,先保留服務商提供的原始設定副本。以下路徑使用英文介面名稱說明;不同平台的欄位排列可能不同,標準設定檔中的參數也不一定都會以相同名稱的欄位呈現。若看不到某個項目,請確認該平台實際支援的匯入方式,不要將它填入無關欄位。

  1. 選擇類型

    前往 Home → + → Type → WireGuard,確認目前編輯的是 WireGuard,而不是 Subscribe 或其他協定類型。

  2. 填寫身分資訊

    依據 Interface 的 PrivateKey 與 Peer 的 PublicKey 填入兩端身分;若服務商要求 Preshared Key,也請一併填寫。

  3. 填寫位址

    將 Endpoint 的主機名稱與連接埠分別填入伺服器位址和連接埠欄位,再填入服務商分配的本機隧道位址;DNS、MTU 依原始設定處理。

  4. 儲存並選取

    儲存後回到 Home,選取剛新增的連線。查看 Home → Global Routing 目前的模式,確認測試請求會使用這個連線。

  5. 送出請求

    開啟連線開關,依系統提示允許所需的網路設定;接著造訪已知可用的目標,並搭配連線記錄與收發流量檢查,不要只看開關是否亮起。

疑難排解時,可暫時使用 Global Routing → Proxy,減少 Config 規則帶來的變因;但這不代表系統中的所有類型流量都一定會經過代理。測試完成後,切回日常使用的 Config,並確認目前實際啟用的設定。Direct 不會透過所選代理轉送請求,因此不能用來測試 WireGuard 的出口;Scene 則須依已設定的場景條件檢查,不能視為固定的全域代理模式。

五、DNS、MTU 與 PersistentKeepalive 的設定方式

DNS 決定網域查詢交由哪個解析器處理,MTU 限制隧道介面可承載的封包大小,PersistentKeepalive 則用於維持部分 NAT 對應。三者不能互相取代:修改 DNS 無法修正錯誤的 Public Key,調低 MTU 也無法讓無法連線的 UDP Endpoint 開始回應。

DNS:先確認解析路徑

標準 WireGuard 設定中的 DNS 是常見的用戶端擴充項目,並非 WireGuard 握手協定本身的欄位。匯入後,應確認它在 Shadowrocket 目前的 Config 與 DNS 設定中實際如何運作,不要假設檔案中的 DNS 一定會套用至所有查詢。若設定指定隧道內部的 DNS 位址,通常須等隧道建立後才能連線。

MTU:先沿用設定,再逐項測試

沿用服務商設定或預設值

建議

服務商提供 MTU 時先依其設定填寫;若未提供,先使用用戶端預設行為,建立可重複的測試基準。

適用情況:首次新增、連線後瀏覽網頁與下載皆正常

手動調低 MTU

只有在小型請求正常、大型請求停滯等現象能穩定重現時,才逐步調低,例如從 1420 測試至 1380,每次只修改這個項目。

適用情況:針對疑似路徑 MTU 或封裝額外負擔進行排查

結論:記錄現象後再保留修改

使用相同網路與目標,比較修改前後的開啟結果及傳輸是否中斷;調低 MTU 後若沒有改善,就恢復原值。不要將 1380 或 1420 視為適用所有網路的通用答案。

合適的 MTU 值取決於底層路徑與額外封裝。盲目調低可能增加封包數量;若連握手都尚未建立,通常應先檢查金鑰與 Endpoint,而非反覆調整 MTU。

PersistentKeepalive:改善閒置後的連線能力

PersistentKeepalive = 25 表示每隔 25 秒傳送保活封包,是常見 NAT 情境的範例,不是必填值或效能參數。在標準 WireGuard 設定中,設為 0 代表停用定時保活。若服務商提供此項目,且目前用戶端設定介面支援,請依要求填寫;若介面沒有此欄位,請勿以連接埠、MTU 等欄位代替。

六、依現象排查,別把連線開關當成握手結果

WireGuard 通常會在有待傳送資料時觸發有效握手。開啟 Shadowrocket 的連線開關,只能先確認本機連線流程已啟動,不能證明遠端身分驗證、DNS 與目標連線都正常。請主動送出請求,再搭配可查看的記錄;若服務商能提供伺服器端握手記錄,也可核對同一時間是否收到該用戶端的資料。

現象優先檢查項目下一步
送出請求後仍沒有有效回應金鑰對應關係、Endpoint、UDP 可連線性檢查伺服器 Public Key、用戶端公鑰登錄資料與監聽連接埠,再換個網路重測。
有握手記錄,但服務無法使用Address、AllowedIPs、伺服器轉送確認分配的位址與回程路由,並檢查請求是否確實選用此連線。
部分網域無法使用DNS 與 Config 規則比對解析結果與規則命中情況,確認請求沒有被 Direct 或其他策略接走。
小型請求正常,大量傳輸停滯路徑 MTU、封包遺失與目標狀態固定測試目標,逐項測試 MTU 並保留對照記錄;不要同時修改 DNS。
切換網路後短暫中斷新網路的 UDP、Endpoint 解析與 On Demand分別在 Wi-Fi 與行動網路手動測試,區分網路限制與自動連線條件。

回到 Config 排查時,先確認目前啟用的檔案,再檢查 Rule 的順序。DOMAIN-SUFFIX 比對網域後綴,IP-CIDR 比對位址範圍,GEOIP 依據位址地理資訊比對,FINAL 則處理前面規則都未命中的請求;命中後會執行對應策略。若規則將請求送往 Direct,修改 WireGuard 金鑰不會改變該請求的出口。

七、儲存設定與後續使用

首次測試完成後,請妥善保留一份原始設定,並記下目前使用的 Global Routing 模式與有效 MTU。日後更換網路、更新訂閱或調整 Config 時若發生問題,就能回到這組已知條件重新測試,不必重新隨機填寫參數。若服務商更換伺服器 Public Key 或分配位址,也應一併檢查相關欄位。

Shadowrocket 下載與初次設定

iPhone / iPad 版在 App Store 售價 $2.99,一次性付費;Mac(Apple 晶片與 Intel)/ Windows / Android / Linux 版免費。買斷用戶端不等於購買連線服務;訂閱請向服務商取得。

下載 Shadowrocket