配置
分享链接
3x-ui 的分享链接格式(vless、vmess、trojan、ss、hysteria2、mtproto)、备注模板变量,以及一个浏览器内的链接检查器。
3x-ui 会为每个客户端生成一个分享链接(以及二维码)。v2rayNG、Hiddify、Mihomo 等客户端应用通过导入这些链接来完成自身配置。
链接格式
| Scheme | Shape |
|---|---|
vless:// | vless://<uuid>@<host>:<port>?<params>#<remark> |
vmess:// | vmess://<base64-json> (a base64-encoded JSON object) |
trojan:// | trojan://<password>@<host>:<port>?<params>#<remark> |
ss:// | ss://<userinfo>@<host>:<port>?<params>#<remark> (SIP002; Shadowsocks-2022 uses percent-encoded userinfo) |
hysteria2:// | hysteria2://<auth>@<host>:<port>?<params>#<remark> |
tg://proxy | tg://proxy?server=…&port=…&secret=… (MTProto) |
查询参数承载传输和安全设置——security、sni、fp、pbk、sid、spx、flow、
type、path、host、alpn 等。
检查链接
粘贴任意分享链接即可解码出每一个字段。解析完全在你的浏览器中进行——链接绝不会通过网络发送出去。
Share-link inspector
Paste a vless / vmess / trojan / ss link to decode every parameter. It is parsed entirely in your browser — nothing is sent over the network.
分享链接包含以客户端身份连接所需的一切信息,其中包括客户端的凭据。请像对待密码一样对待它们。
备注模板变量
每个链接中 # 之后的文本(即备注)由你在面板设置中控制的模板(remarkTemplate)生成。默认值为:
{{INBOUND}}-{{EMAIL}}|📊{{TRAFFIC_LEFT}}|⏳{{DAYS_LEFT}}D占位符使用 {{UPPER_CASE}} 语法。模板会按 | 拆分成若干段;若某一段的唯一值是无限标记 ∞
(用于 TRAFFIC_LEFT、TRAFFIC_TOTAL、DAYS_LEFT 或 TIME_LEFT),该段会被丢弃,
这样不限量的客户端就不会显示空白的修饰内容。
可用的占位符
| Token | Value |
|---|---|
{{EMAIL}} / {{USERNAME}} | 客户端电子邮箱(标识符) |
{{INBOUND}} | 入站备注 |
{{HOST}} | 主机行备注(受管主机) |
{{ID}} / {{SHORT_ID}} | 客户端 UUID / 其前 8 个字符 |
{{TELEGRAM_ID}} · {{SUB_ID}} · {{COMMENT}} | Telegram ID、订阅 ID、备注 |
{{STATUS}} / {{STATUS_EMOJI}} | active/expired/depleted/disabled(或 ✅⏳🚫) |
{{DAYS_LEFT}} / {{TIME_LEFT}} | 剩余天数,或 Xd Xh Xm(不限量时为 ∞) |
{{EXPIRE_DATE}} / {{JALALI_EXPIRE_DATE}} / {{EXPIRE_UNIX}} | 到期时间,分别为公历 / 波斯历日期 / Unix 秒数 |
{{CREATED_UNIX}} | 创建时间(Unix 秒数) |
{{TRAFFIC_USED}} / {{TRAFFIC_LEFT}} / {{TRAFFIC_TOTAL}} | 人类可读的用量(不限量时为 ∞) |
{{TRAFFIC_USED_BYTES}} / {{TRAFFIC_LEFT_BYTES}} / {{TRAFFIC_TOTAL_BYTES}} | 同上,以字节为单位 |
{{UP}} / {{DOWN}} | 上传 / 下载(人类可读) |
{{RESET_DAYS}} · {{USAGE_PERCENTAGE}} | 重置周期(天)· 已用百分比 |
{{PROTOCOL}} / {{TRANSPORT}} / {{SECURITY}} | 例如 VLESS / ws / REALITY |
用量类占位符(流量、天数、状态)会出现在订阅正文中,但会从显示 / 二维码视图中剥离,
这样分享出去的二维码就不会泄露客户端的剩余配额。日期类占位符遵循 datepicker 设置(公历或波斯历)。

3x-ui