設定 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 | 在本機產生並完成伺服器登記的配套私鑰,或服務商分配的用戶端私鑰。 | 填入伺服器私鑰、漏掉末尾字元,或複製時混入空格與換行。 |
PublicKey | Peer 欄位填入伺服器公鑰;伺服器端另行登記用戶端公鑰。 | 把用戶端自己的公鑰填入遠端 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 個字元。但長度正確不代表金鑰正確,也不代表兩端已配對。請逐字核對原始資料,不要為了湊足長度而補字元。
三、在 Home 新增 WireGuard 並進行初步驗證
備妥本機 PrivateKey、分配的位址、遠端 PublicKey、Endpoint,以及服務商要求的其他欄位後,再開始編輯。Home 用於管理連線項目,Config 用於管理規則設定檔;將規則檔匯入 Config,不代表已建立可用的 WireGuard 項目。
-
整理資料
將原始設定保存在安全的位置,並分別標示本機與遠端參數。記下目前的 Global Routing 狀態;若已有可用項目,請保留,不要直接覆蓋。
-
選擇類型
開啟 Home → 點選右上角「+」→ Type → WireGuard。以下依欄位意義填寫;不同平台與介面版面可編輯的項目可能不同,請以實際顯示為準。
-
填入參數
將 Endpoint 對應到伺服器位址與通訊埠,並將本機 PrivateKey、本機位址、遠端 PublicKey 填入各自欄位。只有原始設定要求 PresharedKey 時才填寫。
-
儲存並選取
儲存後返回 Home,選取剛建立的 WireGuard 項目。為減少規則干擾,可暫時將 Home → Global Routing 設為 Proxy,然後啟用連線;若系統要求新增 VPN 設定,請依系統提示確認。
-
分階段驗證
先存取已知可用的目標,再觀察是否持續有資料收發。若有伺服器管理權限,請確認最近的握手時間與收發計數;驗證完成後,將 Global Routing 還原為日常使用的狀態。
四、AllowedIPs 與 Global Routing 屬於不同層級的規則
AllowedIPs 是 WireGuard 的 IP 前綴集合:傳送方向會將目標位址對應到 Peer;接收方向則用來檢查解密後封包的來源位址是否屬於該 Peer。此欄位不接受網域規則,不能填入 DOMAIN-SUFFIX,example.com,PROXY。
0.0.0.0/0表示涵蓋所有 IPv4 目的位址,不包含 IPv6。::/0表示涵蓋所有 IPv6 目的位址;填寫前,請確認伺服器具備相應的轉送能力。192.0.2.0/24僅代表一個示範用 IPv4 網段,不會自動涵蓋其他網段。- 部分用戶端整合方式不會直接顯示 AllowedIPs 編輯欄位。若沒有此欄位,不要把它填進 PublicKey 或位址欄,也不要假設貼上任意標準設定檔就能完整匯入。
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 所需的服務資料請自行準備。