3x-ui3x-ui
配置

分享链接

3x-ui 的分享链接格式(vless、vmess、trojan、ss、hysteria2、mtproto)、备注模板变量,以及一个浏览器内的链接检查器。

3x-ui 会为每个客户端生成一个分享链接(以及二维码)。v2rayNG、Hiddify、Mihomo 等客户端应用通过导入这些链接来完成自身配置。

链接格式

SchemeShape
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://proxytg://proxy?server=…&port=…&secret=… (MTProto)

查询参数承载传输和安全设置——securitysnifppbksidspxflowtypepathhostalpn 等。

检查链接

粘贴任意分享链接即可解码出每一个字段。解析完全在你的浏览器中进行——链接绝不会通过网络发送出去。

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_LEFTTRAFFIC_TOTALDAYS_LEFTTIME_LEFT),该段会被丢弃, 这样不限量的客户端就不会显示空白的修饰内容。

可用的占位符

TokenValue
{{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 设置(公历或波斯历)。

相关

On this page