Shadowrocket WireGuard 参数详解:PrivateKey、PublicKey、Endpoint 与 MTU 怎么填

逐项解释 WireGuard 在 Shadowrocket 里各字段的含义与填写来源,说明 Address、DNS、MTU 填错时的常见表现和核对方法。

本文速览

本文适合已有 WireGuard 服务参数、准备在 Shadowrocket 中填写或核对配置的用户。先区分客户端 PrivateKey 与服务端 PublicKey,再检查 Endpoint、隧道 Address 和 DNS,最后通过路由对照与 MTU 单变量测试定位故障。订阅链接和连接参数均从你的服务商处获取;不要把不同设备、不同 Peer 的字段混在一起使用。

WireGuard 参数来源与填写顺序

Shadowrocket(小火箭)中的 WireGuard 连接需要一组相互对应的参数,不是只填地址与端口即可。常见原始配置使用 [Interface] 描述本机身份与隧道地址,使用 [Peer] 描述远端身份与连接目标。看到两个区块时,应先确认字段属于哪一端,再映射到 Shadowrocket 的编辑项。

用户已有自己的服务商与订阅是本文的操作前提。Subscribe 更新用于取回服务商发布的内容,不等于自动修复错误密钥;普通订阅是否包含 WireGuard 条目,取决于服务商实际提供的格式。手动修改订阅生成的条目前,先确认下次更新是否会覆盖修改。

  1. 核对来源

    从你的服务商处获取同一份 WireGuard 参数,区分 [Interface] 与 [Peer]。记录是否包含 PresharedKey、IPv6 Address 和指定 DNS,不公开完整配置。

  2. 选择类型

    进入 Home → 右上角“+”→ Type → WireGuard。已有条目则在 Home 打开对应条目的编辑页,避免误改当前使用的其他连接。

  3. 填写身份

    先填写客户端 PrivateKey、客户端 Address、服务端 PublicKey;若原配置有 PresharedKey,也必须原样对应填写,不能拿 PublicKey 代替。

  4. 填写目标

    按 Endpoint 核对服务器地址与端口,再填写服务商指定的 DNS 和 MTU。界面若把地址与端口分为两个输入框,应拆开填写。

  5. 单独验证

    保存后在 Home 选择该条目,临时用 Global Routing → Proxy 验证实际网页请求。测试期间避免 Settings → On Demand 中的自动连接条件干扰;完成后恢复原有设置。

PrivateKey 与 PublicKey:先分清客户端和服务端

PrivateKey 是本机身份的秘密部分,PublicKey 是可以交给对端登记的公开部分。客户端 PrivateKey 可以推导出客户端 PublicKey,但不能从 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。

32 字节
PrivateKey 与 PublicKey 各自的原始密钥长度
UDP
WireGuard 外层传输使用的协议
51820
本文示例端口,不是所有服务的固定端口

下面只展示字段格式,不是一份可导入或可连接的配置。example.com 是示例域名,文档地址 2001:db8::10 不是实际服务入口。真实地址、端口和前缀必须使用分配给当前客户端的值。

Endpoint = example.com:51820
Address = 10.66.66.2/32

IPv6 Endpoint 格式:
[2001:db8::10]:51820

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/0Peer 的 IPv4 范围覆盖全部 IPv4 地址不能据此推断 IPv6 也已覆盖
AllowedIPs = ::/0Peer 的 IPv6 范围覆盖全部 IPv6 地址仍需服务端和隧道地址具备对应能力
DOMAIN-SUFFIX,example.com,PROXYConfig 中按域名后缀选择 PROXY 策略只在请求实际采用 Config 规则时参与匹配

原始配置出现 AllowedIPs 时,应保留其语义,并确认当前导入方式是否承载该设置,不要把它粘贴到 Address。若编辑页没有对应输入项,应查明该导入格式的支持范围,而不是猜测字段映射。DNS 也可能由当前 Config 的解析设置共同影响;条目内填写了 DNS,不代表所有系统解析请求必定使用它。

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 调得很低。

  1. 记录基线:保存当前 MTU、网络类型和测试目标,在同一 Wi-Fi 或蜂窝网络下重复访问同一页面与同一较大文件。
  2. 只改一个值:例如原配置为 1420 时,可以临时测试 1380,再视结果测试 1280。这些是诊断试验值,不是服务端要求或实测结论。
  3. 重新连接:保存修改并重新建立连接,让测试使用新的参数;不要同时更换 DNS、Endpoint 和 Global Routing。
  4. 对照表现:若降低后大响应稳定而小请求原本就正常,记录结果供服务商确认路径问题;若没有改善,恢复原值,继续排查其他层。

底层使用 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、安卓、Linux 版免费。客户端获取费用与服务商的连接服务费用分别计算。前往下载页选择平台,或先阅读导入与连接步骤。

下载 Shadowrocket