3x-ui3x-ui
配置

订阅

运行 3x-ui 订阅服务器 —— base64/JSON/Clash 格式、端口与路径、TLS、响应头以及自定义模板。

订阅是一个返回客户端全部配置的单一 URL。客户端应用会定期刷新它,因此当你修改某个入站时,客户端会自动获取这些变更。订阅服务器作为一个独立于面板的服务器运行。

启用与配置

订阅服务器默认开启subEnable)。在面板的订阅设置中进行配置:

设置默认值含义
subPort2096监听端口(与面板分开)。
subListen(全部)绑定地址。
subPath/sub/原始订阅 URL 的基础路径。
subDomain(无)公开主机名;若设置,服务器仅响应该 Host。
subCertFile / subKeyFile(无)TLS 证书 + 密钥 —— 设置后,服务器以 HTTPS 提供服务。
subEncrypttrue对原始订阅内容进行 base64 编码。
subUpdates12发送给客户端的建议刷新间隔(小时)。

一个订阅 URL 形如:

https://<sub-host>:<sub-port>/sub/<sub-id>

其中 <sub-id> 是客户端的 Sub ID

输出格式

格式由路径决定,每种格式都有各自的启用开关:

格式路径启用方式输出
原始链接/sub/始终(若已开启)一组 vless://vmess:// 等链接的列表(当 subEncrypt 开启时进行 base64 编码)。
JSON/json/subJsonEnable完整的 Xray 客户端配置。
Clash / Mihomo/clash/subClashEnableYAML 配置文件。

只有使用 VLESS、VMess、Trojan、Shadowsocks 或 Hysteria2 的已启用入站才会出现在订阅中,并按其订阅排序索引排列。使用 Accept: text/html 头(或 ?html=1)请求 /sub/ 会返回一个人类可读的信息页面,而非原始内容。

响应头

订阅会返回兼容应用可读取的标准响应头:

  • Subscription-Userinfo —— uploaddownloadtotal(字节;total=0 表示无限制)以及 expire(Unix 秒)。
  • Profile-Update-Interval —— 刷新间隔,以小时为单位(subUpdates)。
  • Profile-TitleSupport-UrlProfile-Web-Page-UrlAnnounce —— 部分客户端会显示的可选品牌信息。

自定义页面模板

subThemeDir 指向一个包含自定义信息页模板的文件夹,即可为 HTML 订阅页面定制品牌。每条链接上的客户端备注完全支持模板化 —— 参见分享链接 → 备注变量

将订阅服务器置于 TLS 之后(设置 subCertFile/subKeyFile,或使用 反向代理),以免订阅内容在传输过程中被暴露。

On this page