手動設定 WireGuard 時,先分清本機與對端,再區分隧道內位址和外部連線位址。本文適合已取得目前裝置專用設定檔的 iPad 或 iPhone 使用者:依欄位逐一填寫,儲存後依序確認握手、路由和實際連線,最後再判斷是否需要調整 MTU 或 Keepalive。
PrivateKey 與 PublicKey:先確認金鑰屬於哪一端
請以用戶端設定為準,[Interface] 描述本機,[Peer] 描述與本機通訊的對端。兩端各自有一組金鑰對。在 Shadowrocket 中,應填入本機的 PrivateKey 和對端的 PublicKey,而不是把同一組公私鑰的兩個值一起填入。
用戶端設定中的本機與對端
[Interface] 本機
PrivateKey是目前裝置的私鑰。填寫時請保留完整字串,不要刪除結尾的等號,也不要連欄位名稱一起貼上。Address是目前裝置在隧道內使用的位址,通常由設定提供者指派,並非目前 Wi-Fi 配發給 iPad 的位址。
[Peer] 對端
PublicKey用來識別對端。伺服器則會使用本機的公開金鑰識別目前裝置。Endpoint是傳送 WireGuard UDP 封包的目的地。若設定也包含PresharedKey,請在對應欄位填入同一份設定提供的值;它不能取代任何公開金鑰或私鑰。
請勿將伺服器設定當作用戶端設定使用;向管理員確認裝置身分時,提供本機公開金鑰即可,切勿傳送私鑰或預共享金鑰。
Address、Endpoint 與 MTU 欄位對照
WireGuard 設定中的 Address,可能與 App 介面中用來填寫伺服器位址的 Address 同名。請依欄位位置和用途判斷:若 Address 與 Port 成對出現,這裡要填的是 Endpoint 的主機部分;隧道內位址則應填入對應用戶端 IP 的欄位。
| 欄位 | 範例值 | 填寫位置與核對方式 |
|---|---|---|
Address | 10.20.30.2/32 | 隧道介面使用的本機 IPv4 位址。若也有配置 IPv6,請依介面上的對應欄位分別填寫。使用設定提供的前綴,不要自行將 /32 改成 /24。 |
Endpoint | 198.51.100.20:51820 | 對端的 IP 或主機名稱,以及 UDP 連接埠。若介面將主機和連接埠分開,請分別填入 198.51.100.20 和 51820,不要加上 https://。 |
MTU | 1420 | 隧道介面可承載的最大內層 IP 封包大小,單位為位元組。外層 IP、UDP 和 WireGuard 封裝也會占用傳輸空間,合適的數值須視實際網路路徑而定。 |
PersistentKeepalive | 25 | 對應 App 內的 Keepalive 設定,單位為秒。當沒有應用程式流量時,可用來維持 NAT 或防火牆中的 UDP 狀態;它不是握手逾時時間,也不是延遲測試頻率。 |
表格中的數值僅供說明格式;範例 Endpoint 使用文件保留位址,無法用於連線。實際填寫請以自己的設定為準,尤其不要將範例連接埠視為協定要求。
在 Shadowrocket 手動新增 WireGuard
請先準備目前裝置的用戶端設定。如果設定列出多個 [Peer],不要從不同區段各抄一個值,拼成同一筆設定;本文的手動填寫步驟以單一對端為例。
選擇協定
開啟 Home →「+」→ Add Server → Type → WireGuard。先確認協定類型,再填寫參數,避免將 WireGuard 連接埠填入其他協定的設定。
填寫對端資訊
從同一個
[Peer]讀取Endpoint和PublicKey。將主機和 UDP 連接埠填入伺服器位址與連接埠欄位,再填入對端公開金鑰。若Endpoint使用網域名稱,請保留設定中的網域名稱,不要將單次解析取得的 IP 當成固定值。填寫本機資訊
將
[Interface]中的PrivateKey填入私鑰欄位,並將隧道內的Address填入對應的用戶端 IP 欄位。若設定提供 IPv4 和 IPv6 位址,請分別填入對應欄位,不要把整行設定貼進單一輸入框。核對選用設定
依原始設定核對
MTU、PersistentKeepalive和預共享金鑰。設定中未提供的值,不要自行上網補填。若原始設定包含AllowedIPs,尤其只列出少數網段時,請先確認預期的存取範圍;這是 WireGuard 的對端設定,不等同於 Shadowrocket 的Config規則。儲存並驗證
儲存後返回 Home,選取剛新增的設定並啟用連線。對一個預期會經由該對端連線的目標發出實際請求。只看到系統 VPN 圖示,僅代表系統已啟用 VPN,並不表示 WireGuard 已與對端完成握手。
Global Routing:區分連線故障與規則未命中
先確認測試目標確實會經由 WireGuard。AllowedIPs 用於比對 WireGuard 對端位址及驗證接收封包;Home → Global Routing 則決定 Shadowrocket 是否將請求交由代理處理。這兩層設定不能互相取代。若伺服器僅能存取特定私有網路,測試目標也應選擇該網路中已知可用的服務,而非任意公網網站。
Config
建議依目前設定檔的規則處理請求。確認目標是否符合預期規則,並確認該規則的輸出策略最後選取了這筆 WireGuard 設定。若請求符合 DIRECT,即使連線成功,也不能證明 WireGuard 可用。
適用情境:已確認規則路由後的日常使用與複測。
Proxy
暫時將 Shadowrocket 接管的測試請求交由目前選取的代理處理,以排除 Config 規則的影響。請先記下原本的選項,測試完成後再恢復。若相同目標在 Proxy 下可用,切回 Config 後卻無法使用,請優先檢查規則及其輸出策略。
適用情境:短時間確認相同目標是否因規則而採用不同的輸出路徑。
握手、MTU 與 Keepalive 常見問題
排查時請保持相同網路、相同設定和相同測試目標,每次只調整一個項目。先確認能否與對端通訊,再檢查網域解析、資料傳輸大小,以及閒置後能否恢復。不同階段的故障不適合用同一個參數處理。
已開啟連線,為什麼對端仍沒有握手紀錄?
先送出確實會經由該對端的請求,再確認 Endpoint 的主機和 UDP 連接埠。請對端管理員確認已登記目前裝置的公開金鑰,並核對用戶端填寫的對端公開金鑰及選用的預共享金鑰。若只在某個 Wi-Fi 網路下失敗,請在另一個已授權的網路使用相同設定複測,以區分設定問題和該網路的 UDP 可達性問題。不要一開始就調整 MTU 或 Keepalive。
已知 IP 的服務可以連線,網域卻無法開啟,該先檢查什麼?
先確認設定指定的 DNS 伺服器在目前路由下是否可連線,以及目標是否需要私有 DNS 才能解析。可使用已知支援以 IP 存取的服務進行對照;不要直接以 HTTPS 網站的 IP 取代網域測試,因為憑證和網站識別也可能因此失敗。
小型請求正常,大型網頁或檔案傳輸卡住,要調整 MTU 嗎?
在相同網路和相同輸出路徑下,重現「小型請求成功、較大傳輸反覆停滯」的情況後,再檢查路徑 MTU。若原值為 1420,可先記下原值,再單獨試用較小的 1380;重新連線後測試相同資源。若沒有改善,請恢復原值。這兩個數值僅用於示範比較方法,並非所有網路都適用的固定設定。
剛連線時可以使用,閒置一段時間後才中斷,要啟用 Keepalive 嗎?
先確認問題是在相同網路、連線仍啟用時發生,而不是切換 Wi-Fi 或系統中斷 VPN 之後。如果初次握手和持續傳輸都正常,只有閒置後回應封包傳送失敗,可依設定提供者建議試用 25 秒,並在相同閒置時間後再次測試。Keepalive 會定期傳送封包;若沒有這類問題且設定也未要求,就不必因此增加背景流量。