Web 界面¶
subconverter-ng 内置了一个轻量的可视化 Web 界面,已通过 go:embed 打包进二进制,无需任何额外服务或前端构建步骤。
打开¶
服务启动后,用浏览器访问根路径即可:
(端口取决于 --listen / SUBNG_LISTEN,默认 25500。)
使用¶
- 订阅链接:在文本框里粘贴机场订阅地址,一行一个,多个会自动用
|合并。 - 外部配置 config(可选):填入 INI 规则配置的 URL(兼容 subconverter / ACL4SSR)。
- 目标 target:下拉选择输出格式 ——
clash(Clash.Meta / mihomo)、singbox、surge、shadowrocket、quanx、loon、v2ray/mixed。 - 选项:按需勾选
节点排序、节点去重、强制 UDP、TCP Fast Open、跳过证书校验、过滤不兼容节点、节点名加类型、Tailscale 直连、允许 emoji。对应 URL 参数 里的sort/dedup/udp/tfo/scv/fdn/append_type/tailscale/emoji。 - 上游代理 proxy(可选):例如
socks5://127.0.0.1:1080,仅对本次请求生效,覆盖全局配置。 - 点击 生成订阅链接,下方会显示完整的
/sub?...链接。 - 点击 复制,把链接粘贴到 Clash / mihomo 客户端的「配置 URL」即可;也可以点 打开 / 预览 在新标签页直接查看转换结果。
说明¶
- 生成的链接以当前访问的 host 为基准(
window.location.origin),所以无论部署在本地还是服务器上都能正常使用。 - 页面完全自包含:内联 CSS / JS,不依赖任何外部 CDN,适合中国大陆等网络环境。
- 支持深色模式(跟随系统
prefers-color-scheme),移动端自适应。 - 表单缓存:订阅链接、target 与各选项会自动存入浏览器
localStorage,刷新或下次访问自动恢复,无需重填。数据仅保存在本地浏览器,不上传服务器;换浏览器 / 清除浏览数据即失效。 - 链接的参数含义与 URL 参数 一致。