WireGuard 配置首先要分清本机密钥、对端密钥、隧道地址和公网端点,再检查路由范围与 MTU。本文以已持有自己服务商配置或自管服务器资料的用户为前提,操作路径以 iPhone / iPad 上的 Shadowrocket(小火箭)为例;Mac / Windows / 安卓 / Linux 用户可按参数含义核对对应编辑页,不把移动端按钮位置直接套用到其他平台。读完可逐项检查配置来源,并区分握手、分流、DNS 与数据包大小问题。
一、先分清本机与对端,再填写参数
WireGuard 使用 UDP 传输,以密钥识别通信双方。它不是用户名与密码登录:本机持有自己的 PrivateKey,服务器登记与该私钥配对的本机 PublicKey;客户端的 Peer 则填写服务器的 PublicKey。双方的 PublicKey 不能因为名字相同就互换。
参数归属:本机 Interface 与远端 Peer
本机 Interface
- PrivateKey:本机私钥,只保留在需要使用它的受信任设备上。
- Address:分配给本机的隧道内部地址,不是服务器公网地址。
- 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、丢包与服务端转发 | 记录原值,在编辑页支持时尝试从 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 / 安卓 / Linux 版免费。到全平台下载页选择设备,再按教程完成基础设置;WireGuard 所需的服务资料由用户自行准备。