-
-
Notifications
You must be signed in to change notification settings - Fork 2
Subscriptions.zh_CN
m-ui 为每个有效 Username 分配一个随机的 16 位小写字母和数字 token。不同 Inbound 中具有相同 Username 的 Client 会聚合到同一个订阅中。
普通浏览器地址格式为：
https://example.com:port/<subscription-path>/<username-token>
用浏览器打开时，会显示包含使用量、配额、到期时间、最后在线时间、单节点链接和已启用客户端格式的订阅页面。不要求 HTML 的普通客户端访问裸地址时会得到 Base64 节点列表。
进入 Panel Settings → Subscription。
留空时，订阅使用面板端口。设置专用端口后，公开订阅路由会移动到单独监听器，生成的订阅地址也会使用该端口。
专用监听器只提供订阅，不提供面板、API、Multi-control 或 Inbound Sync 端点。需要在防火墙和反向代理中开放新端口。
首次启动时，m-ui 自动生成 /sub 加 16 位小写字母/数字。可以手动输入符合格式的值，也可以点击右侧按钮重新生成。变更后，原有普通订阅 URL 会失效。
默认后缀是：
/clash
追加后返回 Mihomo/Clash 原生 YAML：
https://example.com:port/<subscription-path>/<username-token>/clash
必须是 /isub 加正好 16 位小写字母/数字，例如：
/isub4ad5kaf479afnbj2
跨面板裸地址打开订阅页；追加 /clash 返回聚合后的 Mihomo YAML。详见 Multi-control。
使用 Manage Tokens 查看或重新生成 Username 的 token。重新生成后，该 Username 的旧地址立即失效。当 Username 不再存在于任何 Inbound 时，对应 token 会被清理。
Client Subscription Conversion 区域控制开放哪些后缀。关闭的后缀返回 404，并从浏览器订阅页隐藏。
可用转换：
| 客户端/格式 | 后缀 | 输出 |
|---|---|---|
| Mihomo / Clash | /clash |
YAML |
| Sing-box | /sing-box |
JSON |
| V2Box | /v2box |
Base64 links |
| V2RayNG | /v2rayng |
Base64 links |
| V2RayTun | /v2raytun |
Base64 links |
| Npv Tunnel | /npvtunnel |
Base64 links |
| HApp | /happ |
Base64 links |
| Shadowrocket | /shadowrocket |
Base64 links |
| Streisand | /streisand |
Base64 links |
| Surge | /surge |
Surge 配置 |
| Surge Mac | /surgemac |
Surge Mac 配置 |
| Surfboard | /surfboard |
Surfboard 配置 |
| Loon | /loon |
Loon 配置 |
| Quantumult X | /qx |
Quantumult X 配置 |
| Stash | /stash |
Stash YAML |
| Egern | /egern |
Egern YAML |
常用格式默认开启，较少使用的格式可能需要手动开启。具体协议能否输出取决于目标客户端的表达能力；不支持的 Inbound/Client 组合会被省略，而不是生成已知无效的配置。
m-ui 会发送常用元数据：
Subscription-Userinfo
Profile-Title
Profile-Update-Interval
流量和到期时间会对全部匹配 Client 聚合。只要其中一个 Client 不限流量，聚合总量就显示为不限；只要其中一个永久有效，聚合订阅就没有到期时间。
进入 Inbounds → General Actions → Export All Subscriptions，可以列出每个 Username 的裸浏览器订阅地址，并复制或下载。这里特意不追加特定客户端后缀。
m-ui 使用 X-Forwarded-Host 和 X-Forwarded-Proto 生成公开链接。Nginx/Caddy 必须转发这些 header。需要固定公网域名时，也应设置 Listen Domain。
设置专用订阅端口后，生成地址会包含该端口。如果反向代理映射到另一个公网端口，请仔细检查生成 URL 和代理 header。
订阅 token 可以读取对应 Username 的连接信息，应当像密码一样保护：
- 只通过 HTTPS 发送。
- 不要粘贴到公开 Issue 或截图中。
- 意外泄露后立即重新生成。
- 必要时通过反向代理或防火墙限制订阅端口。