ss://、vmess://、vless://、trojan:// 分享链接格式说明及与订阅链接的区别

单节点分享链接和订阅链接,在 Shadowrocket 里的导入方式不同。本文拆解四种 URI 前缀的结构,说明扫码、粘贴与 Subscribe 三种导入方式分别适用于哪种链接。

本文速览

先判断链接承载的是服务器参数,还是用于获取服务器列表的地址,再选择导入方式。本文适合已经持有自己服务商提供的链接、需要在 Shadowrocket 中核对导入结果的用户;读完可区分四种 URI、识别订阅入口,并按字段检查导入失败和更新失败的原因。以下操作以 iPhone / iPad 界面为参照,其他平台以实际界面为准。

先看前缀:单节点 URI 与订阅 URL 的区别

ss://、vmess://、vless://、trojan:// 通常直接承载一条服务器记录所需的参数。复制整条链接后,客户端在本地解析地址、端口、认证与传输设置;解析出记录,不等于已经连接成功,也不表示服务器当前可用。

订阅链接通常是一个 https:// 地址。Shadowrocket 需要访问这个地址,读取返回的内容,再生成或更新服务器列表。地址中可能包含访问令牌;它不是普通的公开网页,也不是某种代理协议。仅凭 HTTPS 前缀仍不能断定它就是订阅,必须结合链接用途与返回格式确认。

4 种
本文拆解的单节点前缀:ss / vmess / vless / trojan
3 种
导入操作:扫码、剪贴板导入、Subscribe
2 层
分别核对:链接解析与服务器连接

结论:先识别内容,再选导入入口

看到协议前缀,按单节点参数处理;拿到服务商明确标注的订阅地址,再使用 Subscribe。不要把订阅 URL 的域名填进单节点的 Address,也不要把整条协议 URI 当作订阅下载地址。

ss://:认证信息可能经过 Base64 编码

ss:// 用于 Shadowsocks 分享。常见的 SIP002 形式将加密方法与密码作为用户信息,再连接服务器地址和端口;用户信息通常使用 URL-safe Base64。较早的分享形式还可能把“认证信息、地址、端口”整体进行 Base64 编码,因此不能用是否能直接看见服务器域名判断链接是否完整。

组成部分核对方法
ss://表示 Shadowsocks 分享格式,不是订阅更新地址。
用户信息解码后通常包含加密方法、冒号与密码;Base64 本身不提供保密能力。
服务器与端口例如演示地址 node.example.com:8388;8388 只是示例,并非固定端口。
?plugin=可选插件参数;不能假设客户端支持任意插件,不能为了导入而直接删除。
# 后的内容通常是备注名称;包含空格或非 ASCII 字符时可能经过百分号编码。

导入后,在 Home 打开该记录的编辑页,重点比对 Type、Address、Port、加密方法和 Password。加密方法与密码必须分别对应,不能将整段 Base64 文本填入 Password。若原文已经缺失字符,应重新复制源链接,而不是根据编码外观补写内容。

vmess://:先区分编码 JSON 与其他分享变体

常见的 vmess:// 分享采用“前缀加 Base64 编码 JSON”的形式。解码后的 JSON 通常含有 add、port、id、net、tls 等字段。不同生成端可能采用不同分享变体,因此不能假定所有 VMess 分享都具有完全相同的外层结构。

下面是用于理解字段的演示 JSON,不是可用服务器,也不是可以直接粘贴导入的完整链接。域名为示例域名,UUID 为全零演示值。只有实际服务配置中的对应值才能用于连接。

{
  "v": "2",
  "ps": "Example",
  "add": "node.example.com",
  "port": "443",
  "id": "00000000-0000-0000-0000-000000000000",
  "aid": "0",
  "scy": "auto",
  "net": "ws",
  "type": "none",
  "host": "edge.example.com",
  "path": "/demo",
  "tls": "tls",
  "sni": "edge.example.com"
}

能解析出名称但连接失败,常见原因是传输参数缺失,而非名称写错。不要仅因 Address 正确就忽略 Host、Path 或 TLS;也不要在无法确认原始设置时,将 ws 随意改成其他传输方式。

vless:// 与 trojan://:外观相似,认证字段不同

这两类链接常采用带用户信息、地址、端口和查询参数的 URI 结构。VLESS 的用户信息通常是 UUID;Trojan 的用户信息通常是密码。二者不能只改前缀就互相转换。以下两行仅展示结构,示例域名、全零 UUID 与演示密码均不用于连接。

vless://[email protected]:443?encryption=none&security=tls&type=ws&host=edge.example.com&path=%2Fdemo&sni=edge.example.com#Example

trojan://[email protected]:443?security=tls&type=tcp&sni=edge.example.com#Example
字段含义与检查重点
@ 之前VLESS 通常为 UUID,Trojan 通常为密码;特殊字符需要按 URI 规则编码。
security=tls指示 TLS 相关设置;需要与实际服务一致,不能仅根据端口推断。
type=ws / type=tcp表示传输方式;不同传输方式需要核对的附加字段不同。
sniTLS 握手使用的服务器名称,应与服务配置及证书验证要求一致。
host / path常见于 WebSocket 设置;%2Fdemo 解码为 /demo。

encryption=none 描述 VLESS 协议自身的加密字段,不等于整条连接一定没有加密;是否使用 TLS 需要另外检查。Trojan 通常依托 TLS 传输,遇到证书错误应核对设备时间、SNI 与证书,不应将关闭证书验证作为常规处理方法。

解析器对扩展参数的支持可能不同。若分享链接包含本文未列出的参数,应保留原文并核对编辑页,不要认为导入成功就代表每个扩展参数都已生效。

扫码、剪贴板与 Subscribe:按链接类型操作

二维码只是文本的另一种载体。二维码里可以放单节点 URI,也可以放订阅 URL,扫描不会自动把单节点变成可更新的订阅。应先确认来源说明,再查看识别结果。

Subscribe:保留订阅更新关系

推荐

已有订阅且需要后续更新时,在 Home → + → Type 选择 Subscribe,按页面字段填写订阅 URL 并保存。首次获取成功后,检查生成的记录与订阅分组。

适合:已确认是订阅地址,需要持续同步自己的服务器列表

剪贴板导入:解析完整 URI

复制从协议前缀到末尾备注的整条文本,返回 Home;出现剪贴板访问或导入提示时,确认后再检查解析结果。没有出现提示时,可通过 + 按原参数手动建立记录。

适合:已有一条或多条完整单节点分享文本

扫码:读取二维码里的原始内容

在 Home 使用扫描入口,允许相机访问后扫描已有二维码。若识别内容是网页或普通文本,应先确认用途,不要直接当作服务器记录保存。

适合:链接显示在另一块屏幕上,手工复制不便

订阅地址的外观示例为 https://example.com/sub?token=xxxx,它只用于说明 URL 形态,不提供可用内容。查询参数中的 token 应完整保留,不能将其替换为单节点密码,也不要把包含 token 的地址发到公开讨论区。

  1. 先保存已有记录和正在使用的参数,避免排查过程中丢失原配置。
  2. 完成导入后,检查记录数量、Type、Address、Port 以及 TLS 和传输设置。
  3. 使用应用内对应订阅的更新操作,确认更新能完成,再考虑自动更新设置。
  4. 如果手动编辑了订阅内记录,后续更新可能重新写入服务端返回的参数;需要保留的修改应单独记录。

订阅响应可能包含一组分享 URI,也可能使用客户端可识别的其他格式。服务器列表订阅与 Config 中的配置文件不是同一种对象:导入节点不会自动替你设置所有规则、DNS 或 Global Routing。

导入失败、订阅失败与连接失败要分开检查

先按故障发生的阶段定位。完全没有生成记录,优先检查链接格式;记录已生成但订阅无法更新,检查 URL 请求;记录能选中却打不开网页,再检查连接与分流。不要在没有识别故障阶段时反复删除全部配置。

复制了链接,为什么没有识别出来?

确认文本从 ss:// 等前缀开始,没有混入引号、中文说明或聊天软件插入的换行。检查是否只复制了显示文字而不是完整内容;若剪贴板访问被拒绝,检查系统对该应用的粘贴权限,或在 Home → + 手动填写已知参数。

二维码扫出来是 https://,能直接当节点用吗?

不能只凭前缀决定。先确认它是订阅地址、配置地址还是普通网页;只有明确用于服务器列表的订阅 URL,才放进 Type 为 Subscribe 的记录。扫码后的预览内容若与来源说明不符,先停止保存。

订阅能保存,但更新时提示失败怎么办?

保存只说明本地记录建立,不表示远端请求成功。核对 URL 是否完整、token 是否仍有效及网络能否访问该地址。HTTP 401 或 403 通常涉及访问授权,404 涉及路径或资源,超时则需检查网络与目标响应;不要通过修改单节点的 Port 来处理订阅请求错误。

节点已经导入,为什么打开网页仍失败?

在 Home 确认所选记录和连接状态,再检查 Global Routing。Direct 不会用所选代理转发流量;Proxy 可用于临时隔离规则因素,Config 则按当前配置处理。记录原有模式,测试后恢复;同时核对 Address、Port、认证、TLS、SNI 与传输参数。

Settings → On Demand 管理按条件触发连接的行为,不负责把错误的分享链接修复为有效记录。排查导入问题时,先完成一条记录的手动核对与连接测试,再单独检查 On Demand,避免自动连接行为与格式问题混在一起。

分享前检查:链接中的编码不是脱敏

Base64、百分号编码和二维码都不是隐藏认证信息的安全措施。分享链接可能包含密码、UUID、服务器地址,订阅 URL 可能包含允许读取整份列表的 token。即使截图里看不到明文密码,二维码与整段编码仍可能被还原。

Shadowrocket 官方下载