本文適合已取得 WireGuard 服務參數,準備在 Shadowrocket 中填寫或檢查設定的使用者。先分清用戶端 PrivateKey 與伺服器 PublicKey,再檢查 Endpoint、隧道 Address 和 DNS,最後透過路由比對與 MTU 單一變數測試找出問題。訂閱連結和連線參數請向你的服務商索取;不同裝置或不同 Peer 的欄位不要混用。
WireGuard 參數來源與填寫順序
Shadowrocket(小火箭)的 WireGuard 連線需要一組彼此相符的參數,並非只填地址和連接埠即可。常見的原始設定會用 [Interface] 描述本機身分與隧道地址,並用 [Peer] 描述遠端身分與連線目標。看到這兩個區塊時,請先確認欄位屬於哪一端,再對應到 Shadowrocket 的編輯欄位。
本文的操作前提是你已擁有自己的服務商與訂閱。Subscribe 更新會取得服務商發布的內容,不會自動修正錯誤的金鑰;一般訂閱是否包含 WireGuard 項目,取決於服務商實際提供的格式。手動修改由訂閱產生的項目之前,請先確認下次更新是否會覆寫修改。
-
確認參數來源
向你的服務商索取同一份 WireGuard 參數,並區分
[Interface]與[Peer]。確認是否包含 PresharedKey、IPv6 Address 和指定的 DNS;不要公開完整設定。 -
選擇類型
前往 Home → 點選右上角「+」→ Type → WireGuard。若已有項目,請在 Home 開啟該項目的編輯頁,避免誤改目前使用的其他連線。
-
填寫身分資訊
先填寫用戶端 PrivateKey、用戶端 Address 和伺服器 PublicKey;若原始設定包含 PresharedKey,也必須填入相符的值,不可用 PublicKey 代替。
-
填寫連線目標
依照 Endpoint 確認伺服器地址與連接埠,再填入服務商指定的 DNS 和 MTU。若介面將地址和連接埠分成兩個欄位,請分開填寫。
-
單獨測試
儲存後,在 Home 選取該項目,暫時使用 Global Routing → Proxy 測試實際網頁請求。測試期間,避免 Settings → On Demand 中的自動連線條件造成干擾;完成後請還原原有設定。
PrivateKey 與 PublicKey:先分清用戶端和伺服器
PrivateKey 是本機身分的秘密部分,PublicKey 則是可提供給對端登錄的公開部分。用戶端 PublicKey 可由用戶端 PrivateKey 推導,但無法從 PublicKey 反推出 PrivateKey。Shadowrocket 連線項目中的遠端 PublicKey 應對應伺服器,而非填入由用戶端 PrivateKey 推導出的公鑰。
| 欄位與所屬端 | 應填入的內容 | 常見錯誤 |
|---|---|---|
[Interface] PrivateKey | 分配給目前用戶端的私鑰 | 誤填伺服器公鑰,或複製時多帶空格 |
[Peer] PublicKey | 遠端伺服器的公鑰 | 誤填用戶端自己的公鑰 |
[Peer] PresharedKey | 雙方約定的額外預共享金鑰,僅在原始設定要求時填寫 | 一端有設定、另一端留空,或誤用其他金鑰 |
WireGuard 的 PrivateKey 與 PublicKey 都是 32 位元組原始金鑰的 Base64 表示,通常為 44 個字元,末尾帶有 =。長度只能用來發現明顯截斷,無法證明金鑰正確。複製時請保留大小寫、+、/ 和 =,不要把設定行前面的 PrivateKey = 一併貼進金鑰欄位。
更換私鑰需同步更新對端設定只在本機重新產生 PrivateKey,也會改變用戶端 PublicKey。若伺服器仍登錄舊公鑰,新身分便無法完成驗證。需要更換金鑰時,請依照服務商的裝置重設流程同步更新,不要反覆產生金鑰碰運氣。PrivateKey、PresharedKey 和完整訂閱連結都應視為敏感資訊。
Endpoint 與 Address:公開連線入口不等於隧道地址
Endpoint 是用戶端最先連線的遠端 UDP 地址,包含主機和連接埠;Address 則是用戶端進入隧道後使用的內部地址,通常帶有 CIDR 前綴。兩者用途不同:不可將伺服器網域填入 Address,也不能用用戶端隧道 IP 取代公開 Endpoint。
以下僅展示欄位格式,並非可匯入或可連線的設定。example.com 是示例網域,文件專用地址 2001:db8::10 並非實際服務入口。實際地址、連接埠和前綴,必須使用分配給目前用戶端的值。
Endpoint = example.com:51820
Address = 10.66.66.2/32
IPv6 Endpoint 格式:
[2001:db8::10]:51820
- 合併的 Endpoint 欄位:網域或 IPv4 地址後接冒號和連接埠;IPv6 字面地址需要加上方括號,才能與連接埠區隔。
- 分開的地址與連接埠欄位:伺服器地址欄不要加上
https://、路徑或連接埠;連接埠欄只填服務商提供的數字。 - Address 前綴:
/32表示單一 IPv4 地址,/128表示單一 IPv6 地址;請保留原始設定中的前綴,不要為了「擴大範圍」自行修改。 - 裝置配置:同一組用戶端身分若同時在多台裝置上連線,伺服器記錄的通訊端點可能會來回變動。若需同時使用,請為各裝置取得獨立設定。
Address 填錯時,外層驗證可能仍會成功,但隧道內的來源地址不符合伺服器對該 Peer 的授權範圍,因而出現請求已送出、卻收不到有效回應的情況。這與 Endpoint 無法連線不同,不能只憑 Home 的連線開關判斷問題所在層級。
DNS 與 AllowedIPs:分別檢查解析、隧道路由和規則
DNS 負責將網域名稱解析為 IP,不會修復金鑰驗證問題。若 Endpoint 使用網域名稱,首次連線到伺服器前也必須能解析該網域;若設定的 DNS 只有在隧道建立後才可連線,請特別檢查啟動階段的解析是否形成依賴。除非服務商明確說明該伺服器也提供解析服務,否則不要直接把 Endpoint 伺服器地址當作 DNS。
AllowedIPs 是 WireGuard Peer 層級的地址範圍,不是網域規則,也不是用戶端 Address。它會影響隧道內的路由選擇與對端地址授權;Shadowrocket 的 Global Routing 和 Config 則決定應用程式請求採用哪種策略。兩層設定都必須符合,不能只檢查其中一層。
| 設定 | 具體含義 | 檢查方式 |
|---|---|---|
Address = 10.66.66.2/32 | 本例中用戶端在隧道內使用的地址 | 確認與伺服器為該用戶端登錄的地址相符 |
AllowedIPs = 0.0.0.0/0 | Peer 的 IPv4 範圍涵蓋所有 IPv4 地址 | 不能據此推斷 IPv6 也已涵蓋 |
AllowedIPs = ::/0 | Peer 的 IPv6 範圍涵蓋所有 IPv6 地址 | 仍需確認伺服器與隧道地址具備相應支援 |
DOMAIN-SUFFIX,example.com,PROXY | 在 Config 中依網域後綴選用 PROXY 策略 | 只有請求實際採用 Config 規則時才會進行比對 |
原始設定包含 AllowedIPs 時,應保留其語意,並確認目前的匯入方式是否支援這項設定;不要把它貼到 Address 欄位。若編輯頁沒有對應欄位,請先確認該匯入格式支援的範圍,不要自行猜測欄位對應方式。DNS 也可能受目前 Config 的解析設定影響;項目中填了 DNS,不代表所有系統解析請求一定會使用它。
- 網域解析逾時,但隧道內已知地址可連線:優先檢查 DNS 地址是否可連線、是否只能透過隧道存取,以及目前 Config 的解析設定。
- 只有 IPv6 目標連線失敗:檢查 Address、Peer 地址範圍和伺服器的 IPv6 對外連線,不要先修改 PrivateKey。
- 只有特定網域沒有使用預期的連線方式:檢查 Config 中的規則順序與最終策略,並分辨是解析失敗還是策略選擇錯誤。
比對 Global Routing:先測試連線,再還原規則
確認 WireGuard 欄位無誤後,還要確認測試請求確實經過該項目。Home → Global Routing 中的 Proxy、Direct、Config 分別用於不同的流量處理模式;Scene 可依情境套用預設行為,並不是第四種 WireGuard 加密方式。測試前先記下原有設定,結束後還原,避免將暫時模式當成長期設定。
Config
建議依照目前 Config 的規則與策略處理請求。DOMAIN-SUFFIX、IP-CIDR、GEOIP 等規則會影響比對結果,FINAL 則處理先前未匹配的請求;最終流向取決於規則寫法,不能保證其餘請求一定直連。
適用情況:連線測試通過後,恢復日常依規則分流。
Proxy
讓由 Shadowrocket 接管的請求採用代理模式,以減少 Config 分流對測試的影響。先選取要測試的 WireGuard 項目,再觀察同一個目標是否恢復連線;DNS 仍須另外檢查。
適用情況:暫時確認 WireGuard 資料路徑是否可用。
Direct
採用直連模式,不會將一般請求交由選取的 WireGuard 項目處理。此時網頁能開啟,只能作為本機網路的對照,不能證明 WireGuard 已建立有效通訊。
適用情況:比對本機網路是否正常,並排除隧道因素。
若 Proxy 可用但 Config 失敗,請先檢查命中的規則與策略目標,不要立即重新建立金鑰。若兩者都失敗,再回頭檢查 Endpoint、金鑰和 Address。延遲測試結果只代表該測試方法收到的回應,不能取代實際服務請求;同樣地,系統顯示連線已啟用,也不代表遠端驗證已成功。
MTU 怎麼填:只在特定症狀下逐步測試
MTU 限制隧道內單一資料封包的最大尺寸。WireGuard 外層還會增加 IP、UDP 和加密封裝的額外負擔,因此隧道可用尺寸通常小於底層連線的 MTU。若服務商提供數值,請先使用原值;若未提供,優先保留應用程式的預設處理方式,不要把網路上看到的單一數字當成適用所有網路的標準答案。
MTU 不符的典型線索是:小型請求可以完成,但較大的回應、檔案傳輸或部分 TLS 連線容易卡住。這種情況也可能是封包遺失或伺服器問題所致,因此需要比對測試。若完全沒有有效通訊,應先檢查金鑰、Endpoint 和 UDP 是否可連線,而不是直接把 MTU 調得很低。
- 記錄基準:記下目前 MTU、網路類型和測試目標,在同一個 Wi-Fi 或行動網路下,重複開啟同一個頁面並傳輸同一個較大的檔案。
- 一次只改一個值:例如原始設定為
1420,可暫時測試1380,再視結果測試1280。這些數值僅用於診斷測試,不代表伺服器要求或實測結論。 - 重新連線:儲存修改並重新建立連線,讓測試套用新參數;不要同時更改 DNS、Endpoint 和 Global Routing。
- 比對結果:若降低 MTU 後,大型回應變得穩定,而小型請求原本就正常,請記錄結果供服務商確認路徑問題;若情況沒有改善,請還原原值並繼續檢查其他層。
底層使用 IPv4 或 IPv6、是否存在額外隧道,以及網路路徑是否過濾必要的控制封包,都會影響結果。尤其隧道需要承載 IPv6 時,任意設定低於 1280 的數值並不適當。MTU 過小也會增加分段與處理負擔,不應把「越小越穩定」當成長期調整原則。
常見問題:依照症狀檢查對應欄位
已開啟連線,為什麼還是無法存取?
先在 Home 確認選取的是要測試的 WireGuard 項目,再使用 Global Routing → Proxy 測試實際請求。依序檢查 Endpoint 的網域與 UDP 連接埠、用戶端 PrivateKey、伺服器 PublicKey;也可請服務商確認是否收到該用戶端的握手,以及登錄的用戶端公鑰是否相符。
PrivateKey 可以直接用 PublicKey 代替嗎?
不可以。回到 Home 的項目編輯頁,對照原始的 [Interface] 與 [Peer] 分別填寫。若私鑰已遺失,請依照服務商流程重設用戶端身分並同步登錄新公鑰,無法從現有公鑰還原私鑰。
手機可以用,另一台裝置同時連線就時斷時續?
先中斷其中一台裝置,再進行比對。若單獨連線都正常、只有同時連線時才輪流中斷,請檢查是否重複使用相同的 PrivateKey 與 Address。向你的服務商索取各裝置專用的獨立參數,不要只修改 Address 最後一位來嘗試解決。
小型網頁能開啟,但下載總是卡住,該先改什麼?
先固定網路、項目和測試檔案,記錄目前 MTU,再依 1420、1380、1280 這類逐步降低的方式進行單一變數比對;測試起點以原始設定為準。若小型請求也失敗,先檢查基本連線。若只有網域無法連線,請回頭檢查 DNS,不要將所有問題都歸因於 MTU。
向服務商回報時,請保留網路類型、失敗時間、使用的 Global Routing 模式,以及「網域解析失敗」「小型回應成功但大型回應卡住」等可重現的現象。可提供已遮蔽敏感欄位的設定截圖,但不要傳送完整的 PrivateKey、PresharedKey 或訂閱連結。若要回顧 Config 與 Home 的基本操作,請參閱使用說明。
取得 Shadowrocket 與基本操作
iPhone / iPad 版請從 App Store 取得,價格為 $2.99 一次性付費,開發者為 Shadow Launch Technology Limited;系統需求以 App Store 頁面標示為準。Mac(Apple 晶片 / Intel)、Windows、Android、Linux 版免費。用戶端取得費用與服務商的連線服務費用分開計算。前往下載頁選擇平台,或先閱讀匯入與連線步驟。