本文速览

如果已有服务商提供的连接参数、分享链接或订阅,添加配置时先以服务端标注的协议为准,再核对认证、传输和 TLS 设置。本文用 iPhone / iPad 的 Add Server 说明各字段如何对应,并给出排查顺序,帮助区分参数填错、网络不通和规则未走代理三类问题。

协议对照:Add Server 需要哪些参数

同一个域名可以在不同端口提供不同服务,同一个数字端口也可以对应不同的传输。地址和端口只告诉客户端去哪里连接;Type、认证资料和传输设置才决定双方能不能建立会话。下表列的是需要向原服务商核对的参数,不是跨平台统一的字段标签。

协议原理与手动填写时的核对项
协议基本原理需要核对的参数
Shadowsocks按约定的加密方式封装代理流量。服务端地址、端口、加密方式和密码或密钥。若原配置带插件,还要核对插件类型及参数。
VMess使用用户 ID 认证;代理协议和承载它的传输需分别对齐。地址、端口、UUID、传输类型。若使用 WebSocket,核对 Host 与 Path;若启用 TLS,另核对服务器名称。
VLESS使用用户 ID 认证;常见的 encryption=none 配置由外层安全传输提供保护。地址、端口、UUID、传输与安全设置;原配置指定 flow 时一并核对。
Trojan通常在 TLS 连接内完成密码认证并转发流量。地址、端口、密码、TLS 服务器名称;如果服务端指定了额外的传输参数,按原配置填。
HTTP通过 HTTP 代理转发请求;访问 HTTPS 目标时通常使用 CONNECT 建立隧道。代理地址与端口;仅在代理要求认证时填写用户名和密码。目标站点使用 HTTPS,不代表到代理的链路也启用了 TLS。
SOCKS5代理可转发 TCP;UDP 是否可用取决于客户端和服务端对 UDP 转发的支持。代理地址、端口及服务端要求的认证资料;不要用网页能打开来判断 UDP 是否可用。
WireGuard使用公私钥识别对端,在 UDP 上传输 IP 数据包。本端私钥和隧道地址、对端公钥、Endpoint、AllowedIPs;原配置使用预共享密钥时也要保留。
Hysteria2以基于 UDP 的 QUIC 承载代理流量。地址、UDP 端口、认证值和 TLS 服务器名称;只有服务端启用了混淆时,才填写对应类型和密钥。

端口、传输和 TLS:名称相近不等于设置相同

443/TCP
HTTPS 的默认 TCP 端口;不能据此推定代理端口。
443/UDP
Hysteria2 可以配置在此端口;与同号 TCP 端口独立。
2 个密钥角色
WireGuard 分清本端私钥与对端公钥。

结论:先确认服务端监听的传输

如果服务商给的是 443/UDP,但检查结果只显示 443/TCP 可达,就不能据此排除 UDP 网络问题。保留原参数,在允许 UDP 的另一网络上复测,不要把端口号相同的配置换成另一种协议。

使用 WebSocket 的 VMess 或 VLESS 配置可能同时出现连接地址、HTTP Host 和 TLS 服务器名称(SNI)。连接地址决定连接到哪台主机,Host 供 HTTP 层识别站点,SNI 供 TLS 层选择站点及证书。三者可以相同,也可以不同。遇到证书名称不匹配,先核对 SNI 与证书所覆盖的域名,不要把跳过证书校验当作修复方法。

WireGuard 的 Endpoint 是对端对外监听的地址和端口,不是本端隧道地址。AllowedIPs 则关联对端可承载的 IP 前缀,不是端口白名单。如果握手能完成但访问不了隧道内的目标,应核对目标地址是否落在相应前缀内,再检查对端路由。不要为排查而发布本端私钥或完整配置。

手动添加与首次连通测试

手动填写适合手头有一份完整的单条连接参数时使用。如果已有订阅,在 Home → + → Add Server → Type 选 Subscribe,填入自己的订阅地址并保存。订阅地址用于获取列表,不是某条连接的服务端地址,不需要把它拆进 Address 和 Port。

  1. 选择协议

    进入 Home → + → Add Server → Type,按原始资料选择协议。VMess 和 VLESS 都可能使用 UUID,仅凭 UUID 无法判断该选哪一个。

  2. 填写连接端点

    在 Address 和 Port 填入服务端主机名或 IP 与端口。不要把完整分享链接填进 Address。如果在填写 WireGuard 配置,对端连接地址和端口对应 Endpoint,不要与隧道地址混填。

  3. 核对认证与传输

    对照原始资料填写密码、UUID 或密钥,再核对加密方式、传输类型和 TLS 参数。若指定了 WebSocket 的 Path,例如 /edge,保留开头的斜杠;不要把 Path 当作地址的一部分。

  4. 保存后单独测试

    保存并回到 Home,选中刚添加的条目并打开连接开关。先用 Connectivity Test 记录该条目的测试结果,再试一个已知能正常访问的目标。测试通过只说明测试请求成功,不代表所有网站都可达,也不代表 UDP 转发可用。

  5. 恢复原路由设置

    如果需要区分规则问题,可在允许使用代理的测试环境里短暂选择 Home → Global Routing → Proxy,用同一目标复测。完成后恢复先前的模式;在 Config 模式下仍需按当前配置判断实际走向。

协议已连通,但请求没有走代理

Add Server 定义的是如何连接服务端,Global Routing 决定请求按什么方式走。Direct 直连,Proxy 用于通过代理转发,Config 按当前配置匹配;Scene 则按已设置的场景选用路由方式。开启连接开关并不等于每条请求都会使用刚添加的协议。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

以上是用于说明匹配顺序的配置片段,不是需要覆盖现有配置的模板。在 Config 模式下,已识别到的 www.example.com 域名可以命中第一条,按 PROXY 处理;直接访问 192.168.1.1 时可命中第二条,按 DIRECT 处理。先前规则均未命中的请求由 FINAL,DIRECT 直连。排查时在 Config 确认正在使用的文件,再从上往下找第一条命中目标的规则,不能只看文件里是否出现过 PROXY。

常见问题:超时、证书错误与订阅更新

Hysteria2 在 Wi-Fi 一直超时,换蜂窝就能连?

用同一条目、同一目标在两个网络分别复测,确保没有同时更改端口或 TLS 设置。如果故障只出现在一个网络,先检查该网络是否允许访问服务端指定的 UDP 端口。能通过该网络访问 HTTPS 网站,并不能证明同号 UDP 端口可达。

Trojan 填的是 IP,为什么会报证书名称不符?

回到 Home 编辑相应条目,检查 TLS 服务器名称是否为服务商给出的、受证书覆盖的域名。即使连接地址按要求使用 IP,证书也可能只对域名有效;若名称正确仍报错,再核对设备时间和服务端证书状态。

同一个 UUID,为什么用 VLESS 能连,换 VMess 就不行?

UUID 是认证参数,不是协议标识。回到 Add Server → Type,按原始配置选择 VLESS,再逐项比对传输、安全设置及服务端指定的 flow。只保留 UUID 并切换 Type 不会把一份配置转换成另一种协议。

订阅里一条连接超时,要删掉订阅重加吗?

先在 Home 测试同一订阅下的另一条已有连接。如果只有一条失败,记下失败条目的名称和网络环境,检查订阅是否已更新到服务商提供的当前参数。若整个列表为空,再核对 Type 是否为 Subscribe、链接是否复制完整且仍有效。反馈时遮住订阅链接中的令牌和认证资料。

获取 Shadowrocket 与查看配置教程

iPhone / iPad 版在 App Store 获取,$2.99 一次性付费,开发者为 Shadow Launch Technology Limited,应用 ID 为 932747118,系统要求以 App Store 页面标注为准。Mac(Apple 芯片 / Intel)、Windows、安卓和 Linux 版免费,安装包通过本站下载页获取。