梯子订阅格式:YAML、Base64、JSON各给哪种客户端
梯子的 yaml 文件,是 Clash 一类客户端加载的整份配置;Base64 订阅是把分享链接编码后拼成的一长串;sing-box 那边用的是 JSON。
协议与内核更新约 6 分钟
辨认梯子协议,可看分享链接中 :// 前的字母:ss、vmess、vless、trojan、hysteria2 分别代表五种常见协议;其后按顺序列出凭证、服务器地址及端口、? 后的参数、# 后的备注;仅旧版 vmess 格式用 Base64 打包整段配置。链接内含凭证,拿到完整链接就能连接节点,因此应像账号密码那样保密。
大多数人第一次碰到协议名,是在一长串以 ss:// 或 vless:// 打头的字符里。它也许是朋友发来的,也许是机场后台“复制链接”按钮给的,也可能来自 /jiedian/ 这类免费节点页上的某一条。粘进客户端就能用,可链接里到底写着什么,很少有人拆开看过。
拆开来看有两个好处:一来导入失败时,能定位是哪一段写坏了;二来能明白这串字符为什么不能随便往群里发。这篇只讲链接的格式,协议之间谁快谁慢不在讨论之内。文中的示例链接都用 example.com 和瞎编的凭证,连不上。
分享链接沿用了网址的写法,:// 前面那部分叫 scheme,客户端据此决定拿哪种协议去解析后面的内容。
| 开头 | 协议 | 凭证在哪一段 | 依据的格式文档 |
|---|---|---|---|
| ss:// | Shadowsocks | @ 前面:加密方式加密码 | SIP002 规范 |
| vmess:// | VMess | 老格式整串 Base64;新格式 @ 前面是 UUID | v2rayN Wiki;Xray 社区提案 |
| vless:// | VLESS | @ 前面:UUID | Xray 社区提案 |
| trojan:// | Trojan | @ 前面:密码 | trojan-url 工具文档(还没定稿) |
| hysteria2:// 或 hy2:// | Hysteria 2 | @ 前面:认证串 | Hysteria 2 官方文档 |
除 vmess 老格式外,另外四种结构一样:@ 左边是凭证,右边是服务器域名或 IP 再加端口;问号之后跟着若干“键=值”参数,彼此用 & 隔开;井号之后是客户端里显示的节点名。依照网址的通用规则,IPv6 地址得用方括号括起来。
按 SIP002,格式是 ss:// 后面接 userinfo,然后是 @、主机、端口,再往后可以带 plugin 参数和 # 备注。userinfo 的构成为“加密方式 + 冒号 + 密码”;用传统 Stream 或 AEAD 加密时,这一段既可以做 Base64URL 编码,也可以原样写。
ss://YWVzLTEyOC1nY206bGFiZGVtbzAx@example.com:8388#lab-demo
把 @ 前面那段用 Base64 解开,会得到 aes-128-gcm:labdemo01:冒号左边是加密方式,右边就是密码。可见这层编码只是为了不让特殊字符搅乱格式,谁都能解开。规范另外规定,2022 系列加密(SIP022)的 userinfo 不许用 Base64URL,而是把加密方式和密码分别百分号编码后明文写上。
v2rayN 维护的老格式,是 vmess:// 后面跟一串 Base64,解码出来是一个 JSON 对象,常用字段有这些:
后来 Xray 社区又提出一种网址式写法,长这样:vmess://UUID@主机:端口?参数#备注。它只用于 VMess AEAD,去掉了 alterId。两种写法都以 vmess:// 开头,客户端看后面是不是一整段 Base64 来分辨。
VLESS 链接 @ 左边放的是 UUID。照 Xray 文档,id 可以是合规的 UUID,也可以是不超过 30 字节的任意字符串,后一种会被换算成一个 UUID。常见参数可以归成三类:
| 参数 | 用途 | 不写时 |
|---|---|---|
| encryption | VLESS 的加密设定 | 视为 none |
| flow | 流控方式,如 xtls-rprx-vision | 不开启 |
| type | 传输方式:tcp、ws、grpc、xhttp 等 | 提案没写默认值 |
| security | none、tls 或 reality | none |
| sni、fp、alpn | TLS 握手用的域名、客户端指纹、应用层协议 | sni 默认取服务器地址 |
| pbk、sid、spx | REALITY 的公钥、shortId 与爬虫路径 | 用 REALITY 时必须有 pbk |
| path、host、serviceName | WebSocket 的路径和域名、gRPC 的服务名 | 取决于传输方式 |
提案要求每个参数值都要 URL 编码。security=reality 时漏了 pbk 就会连不上,自己动手改链接时,最容易错在这里。
trojan-url 工具给的基础形式是 trojan://密码@主机:端口,密码中有特殊字符就得 URL 编码,示例端口用的是 443。很多客户端会在问号后再加 sni、type 之类参数,这部分没有统一标准。Trojan-GFW 文档说,握手完成后客户端发出的是密码的 SHA224 十六进制哈希,服务器拿它来验明身份。在我们看来,明文密码本应只存在于本机配置中,链接一旦流出去,这层哈希也就护不住了。
Hysteria 2 官方文档写的格式是 hysteria2://认证@主机:端口/?参数#名称,scheme 写成 hy2 也行。不写端口就默认 443,也可以写成 5000-6000 这样的一段范围,用来做端口跳跃。可用参数有 obfs、obfs-password(混淆),以及 sni、insecure(是否跳过证书校验)和 pinSHA256(锁定证书指纹)等。文档还专门强调,链接里只放连接必需的内容,带宽、本地代理模式之类要在客户端里单独配。Hysteria 2 跑在 QUIC 上,用的是 UDP,网络对 UDP 有什么限制,见 UDP 开关那篇指南。
以上五种格式都有一个共同点:凭证全写在链接里。ss 的密码只不过做了 Base64,vless、vmess 的 UUID 本身就代表身份,trojan、hysteria2 的密码也是直接写出来的。别人拿到链接,用不着登录机场面板,导进客户端就能冒用你的身份连这个节点。
因此截图求助的时候,@ 两边的内容都要打码,服务器地址最好也遮掉。订阅链接风险更高,它一下子把全部节点都交了出去;第三方转换服务能看到些什么,订阅格式那篇指南里写过。机场自身可见的信息,参见机场能看到什么。
echo 字符串 | base64 -d 即可;解码前把 - 和 _ 换回 + 和 /,长度不是 4 的整数倍就在末尾补 =。读到这里想直接用?
装完客户端还差一步:得有一份机场订阅,才连得上。各家套餐资料在梯子推荐页可以对照着看。
Trojan 是一种把自己装扮成 HTTPS 流量的代理协议。照 Trojan-GFW 文档的说法,客户端先和服务器做完 TLS 握手,然后发送密码的 SHA224 哈希和要访问的目标地址;校验失败时,服务器会把这条连接交给事先设好的网页服务,从外面看就是一个普通的 HTTPS 网站。
前者只管一个节点,所需的凭证与参数都在这一串字符里;后者本身是个网址,客户端定期去那里取回一整批节点,取回的内容可能是 YAML、Base64,也可能是 JSON。机场一调整节点,你点一下更新订阅就同步了。不管哪一种,里面都藏着凭证,别在公开场合发。
网址规定空格和绝大多数非 ASCII 字符不能直接写,于是 # 后面的备注要转成百分号编码,一个汉字一般占三组 %XX。导入时客户端会把它还原成中文,看着正常就表示解析无误;如果你要手工改备注,也要按这套规则先编码。
对方一导入,用的就是你的身份,消耗的是你的套餐流量;碰上限制设备数或在线 IP 的机场,你自己还可能被踢下线。能不能共享,得看该机场的用户条款怎么写。确实需要给别人用,最好请对方自己注册一个账号。
软件界面、服务条款和相关法规都可能调整,如果你看到和现在对不上的地方,请照更正与反馈里写的办法通知我们。
梯子的 yaml 文件,是 Clash 一类客户端加载的整份配置;Base64 订阅是把分享链接编码后拼成的一长串;sing-box 那边用的是 JSON。
协议与内核更新约 6 分钟
用梯子安不安全,得先弄明白机场在技术上看得到什么。这篇依据 TLS 1.3、ECH、DoH 的 RFC 与代理协议的说明,把机场看得见和看不见的信…
安全与风险更新约 5 分钟
梯子要不要打开 UDP,取决于你拿它干什么。这篇参考 QUIC、WebRTC 的 RFC 和 mihomo 的说明,讲清楚哪些应用用的是 UDP、客户端和节…
协议与内核更新约 4 分钟