本文详解Shadowrocket配置WireGuard协议的核心步骤，涵盖隧道建立、密钥生成、节点参数填写及常见连接失败问题的排查方法,帮助iOS用户快速实现WireGuard组网。
WireGuard在Shadowrocket中的定位
Shadowrocket作为iOS平台主流代理工具，支持Shadowsocks、VMess、Trojan等协议，WireGuard是近年来备受关注的轻量级隧道协议，与传统代理协议相比，WireGuard采用内核级加密，性能损耗低，连接速度快,但配置复杂度稍高。
在Shadowrocket中启用WireGuard前，需确保已获取有效的节点信息，包括公钥、私钥、服务器地址及端点端口，部分机场服务商提供专门的WireGuard订阅链接,可直接导入。
配置步骤详解
第一步：获取节点信息
登录机场后台，在节点列表中找到WireGuard类型节点，复制完整配置信息,典型WireGuard节点包含以下参数：
- Endpoint：服务器地址和端口
- Public Key：服务器公钥
- Private Key：本地私钥（首次生成）
- Allowed IPs：流量路由范围，通常为
0.0.0/0或:/0
第二步：生成本地密钥对
打开Shadowrocket，点击右上角“+”添加新节点，选择“WireGuard”类型，点击“生成密钥”自动创建私钥和公钥,将生成的公钥提交给服务商添加到服务器端。
第三步：填写服务器参数
将机场提供的节点信息填入对应字段：
[Interface]
PrivateKey = [本地私钥]
Address = 10.0.0.2/32
DNS = 1.1.1.1
[Peer]
PublicKey = [服务器公钥]
Endpoint = example.com:51820
AllowedIPs = 0.0.0.0/0
PersistentKeepalive = 25第四步：启用连接
返回节点列表，选择刚配置的WireGuard节点，开启全局代理或使用分应用代理模式，建议首次测试时开启全局模式,验证连通性后再切换为分应用模式。
TUN模式与系统代理的区别
Shadowrocket支持两种流量处理模式：
- 系统代理模式：仅处理HTTP/HTTPS流量，兼容性好但无法代理游戏和UDP应用
- TUN模式：创建虚拟网卡接管所有流量，包括UDP数据包，适合游戏和实时通讯
WireGuard本身为UDP协议隧道，建议在TUN模式下运行以获得完整流量代理能力，开启TUN模式后，Shadowrocket会创建虚拟网卡,所有出站流量经由WireGuard隧道。
常见问题排查
现象：连接成功但无法上网
原因：DNS泄漏或路由配置错误
解决方法：检查Allowed IPs是否包含0.0.0/0，尝试更换DNS服务器为1.1.1或8.8.8
现象：连接秒断
原因：防火墙阻断或PersistentKeepalive参数缺失
解决方法：在配置中添加PersistentKeepalive = 25保持心跳，联系服务商确认UDP端口是否开放
现象：私钥生成失败
原因：Shadowrocket版本过旧或系统权限不足
解决方法：更新至最新版本，删除旧节点重新配置
节点选择建议
不同使用场景对WireGuard节点性能要求不同：4K视频需选择高带宽线路，游戏加速需低延迟节点，跨境办公需稳定可靠的长期连接线路，判断节点服务商可靠性可参考其是否提供完整的配置文档、连接成功率和客服响应速度。
