Surge配置转换失败怎么办？从订阅识别到导入排查
简答：Surge配置转换不是简单改文件后缀：节点订阅应转换为 Surge 格式，完整配置则检查 [General]、[Proxy]、[Proxy Group] 和 [Rule]。优先使用 Sub-Store 或本地 subconverter，转换后再验证节点、策略组与规则。
定义：Surge配置转换，是把 Clash、Mihomo、V2Ray、Base64 节点或其他客户端订阅，转换成 Surge 可识别的配置文件或可自动更新的订阅链接。
先判断：你要转换的是配置文件，还是节点订阅
这是 Surge 配置转换最容易混淆的地方。完整配置文件通常包含 [General]、[Proxy]、[Proxy Group] 和 [Rule] 等区块；节点订阅则可能只是 Base64 文本、单节点链接或 Clash YAML，里面只有节点和部分元数据，不能直接等同于完整 Surge 配置。
| 输入内容 | 常见特征 | 建议路径 |
|---|---|---|
| Clash 或 Mihomo YAML | 能看到 proxies、proxy-groups、rules 等字段 | 用 Sub-Store 或 subconverter 输出 Surge |
| Base64 节点订阅 | 打开后是一长段编码文本 | 先作为 url 输入转换器，再检查输出节点数量 |
| V2Ray、Trojan、SS、SSR 链接 | 通常以协议前缀开头 | 批量链接需要 URL 编码后转换 |
| Surge 配置文件 | 包含 [Proxy]、[Rule] 等 INI 风格区块 | 通常不需要再次转换，先检查语法和协议 |
| sing-box JSON | 包含 inbounds、outbounds、route 等字段 | 不能把任意 JSON 直接当作 Surge 配置，应使用明确支持的转换流程 |
Surge 官方说明中，配置文件是纯文本 profile；最小可用配置通常至少需要全局设置、代理、策略组和规则区块。规则按顺序匹配，最后应有 FINAL 兜底。可参考 Surge Quick Start 和 Surge Policies。
三种转换方式怎么选：在线、Sub-Store 还是本地 subconverter
临时转换：适合只转换一次、输入内容不敏感的订阅。在线页面通常是粘贴链接、选择 Surge、生成结果，但订阅链接可能包含 token，不建议把长期有效链接交给不明服务。
持续更新：适合每天使用的订阅。Sub-Store 文档说明，保存订阅后可以通过 /download/<name> 输出不同客户端格式，也可以使用 target=Surge 强制输出 Surge 格式。
https://sub.example.com/download/my-sub?target=Surge上面的域名和订阅名只是示例，实际地址应替换为你部署的 Sub-Store 输出地址。Sub-Store 会根据 User-Agent 自动判断格式，也支持使用 /download/名称/Surge 直接指定目标。
不想上传订阅：使用本地 subconverter。官方 README 给出的调用形式如下：
http://127.0.0.1:25500/sub?target=surge&ver=<版本号>&url=<URL编码后的订阅地址>127.0.0.1 只代表运行 subconverter 的那台设备本机。电脑上的这个地址不能直接被 Surge iOS 访问；如果要让同一局域网内的手机访问，应让服务监听局域网地址，并将地址改为电脑的局域网 IP，例如：
http://192.168.1.5:25500/sub?target=surge&ver=<版本号>&url=<URL编码后的订阅地址>也可以把转换后的配置托管到手机能够访问的 HTTPS 地址，再从 Surge 导入。subconverter 的源类型、目标类型、target、url 和托管配置参数，可核对其 README-cn.md。
Surge配置转换的可照做流程
- 备份原始订阅。不要直接覆盖原链接，先保存原始 URL、原始配置文件和当前客户端中的节点数量。
- 识别输入格式。如果打开后是 YAML，先确认是否有节点字段；如果是一长段编码文本，按 Base64 订阅处理；如果已经有
[Proxy]和[Rule]，先按 Surge 配置检查，而不是重复转换。 - 选择目标。使用 Sub-Store 时选
Surge；使用 subconverter 时使用target=surge，并根据目标客户端需要填写ver。 - 对订阅地址做 URL 编码。原始地址中的
?、&、#等字符会影响调用参数。不要手工替换部分字符，使用可靠的 URL 编码功能生成完整参数。 - 先在电脑端打开转换结果。检查是否返回文本配置，而不是 HTML 错误页、登录页面或空白内容。
- 检查四个关键区块。确认
[General]、[Proxy]、[Proxy Group]、[Rule]存在；策略组引用的代理名称必须在[Proxy]中出现；规则最后应有可用的FINAL策略。 - 导入 Surge。可使用配置 URL 导入，也可先复制配置文本后导入。Surge 官方还提供
surge:///install-config?url=...URL Scheme，传入的配置地址需要进行百分号编码，具体参见 Surge URL Scheme。 - 启动后验证。打开请求列表或 Dashboard，确认请求命中了预期策略组；不要只看“配置导入成功”，因为导入成功不代表每个节点协议都能连接。
如何设置自动更新，以及 MANAGED-CONFIG 到底从哪里来
如果使用托管配置，Surge 配置开头通常会出现类似下面的行：
#!MANAGED-CONFIG https://config.example.com/surge.conf interval=86400 strict=false这行不是普通代理节点，也不是必须手工拼出来的固定文本。使用 subconverter 时，是否自动附加 #!MANAGED-CONFIG 取决于其托管配置设置；README 中的 write_managed_config 默认用于控制是否写入该信息，managed_config_prefix 用于指定更新请求的地址前缀。使用 Sub-Store 的文件功能时，动态配置文件也可以生成完整配置并提供后续更新地址。
如果转换器运行在电脑上，配置中的更新地址不能继续写成电脑本机的 127.0.0.1，因为 Surge iOS 会把它解释为手机自身。应改用手机可访问的局域网 IP，并让服务监听局域网；或者将最终配置托管到可访问的 HTTPS 地址。
Surge 官方说明要求远程配置在更新后仍保留 #!MANAGED-CONFIG 行，否则配置会退回普通配置。interval 是最短更新间隔，strict=true 则表示更新失败后会要求成功更新。详情见 Surge Managed Profile。
协议兼容：为什么转换后节点会减少或无法连接
转换器能读取某种节点格式，不等于 Surge 当前版本、平台和服务端组合一定可用。官方协议列表显示，Surge 支持 HTTP、SOCKS5、Shadowsocks、VMess、Trojan、TUIC、Hysteria 2、AnyTLS、SSH、WireGuard 等类型，但部分协议存在平台或最低版本要求。Hysteria 2、AnyTLS 等版本信息应以 官方 Supported Proxy Protocols 和对应协议页面为准。
| 现象 | 常见原因 | 处理方法 |
|---|---|---|
| 转换后节点数量变少 | 目标格式不支持某些协议，或转换器过滤了不兼容节点 | 保留原订阅，对比节点名称和协议；不要把缺失节点当作连接故障 |
| Hysteria 2 导入但无法用 | 密码、端口、TLS 参数或客户端版本不匹配 | 逐项核对服务端参数，并查 Surge 官方协议页的版本要求 |
| TUIC 连接失败 | TUIC v4 与 v5 的认证字段不同 | v4 使用 token，v5 使用 uuid 与 password，不能混用；参考 Surge TUIC 文档 |
| 节点名称存在但策略组为空 | 策略组引用名称与代理名称不一致 | 检查 [Proxy Group] 中的成员是否逐一存在于 [Proxy] |
| Surge 能导入但请求直连 | 规则没有命中代理策略，或 FINAL 指向 DIRECT | 查看请求日志中的命中规则和最终策略，再检查规则顺序 |
如果你的输入包含新协议、特殊传输层或自定义字段，转换结果只能说明“生成了 Surge 文本”，不能自动证明服务端连通。先用一个已知可用的基础节点测试，再逐个恢复高级参数，便于定位是协议、证书、域名还是规则问题。
转换失败排查清单：空节点、链接失效和 User-Agent
- 返回空内容：先在浏览器或命令行打开原始订阅，确认没有过期、需要登录或被重定向到 HTML 页面。
- 浏览器能打开，转换器为空：检查订阅提供方是否按 User-Agent、请求头或来源地址限制访问。Sub-Store 支持根据 User-Agent 输出不同格式；subconverter 也支持按请求参数和配置处理请求，必要时在其配置中指定合适的 User-Agent。
- 链接包含特殊字符：完整 URL 必须编码后放入
url=，尤其注意&会被误认为下一个转换参数。 - 导入提示格式错误：确认返回内容是纯文本 Surge 配置，而不是 JSON、YAML、网页错误信息或带额外说明的文本。
- 只剩 DIRECT：检查
[Proxy]是否为空、策略组是否引用了不存在的名称，以及规则是否将流量全部指向 DIRECT。 - 配置更新失败：检查更新地址是否能从当前设备访问；局域网地址要确认服务正在监听局域网接口，HTTPS 托管地址则要确认返回内容仍保留
#!MANAGED-CONFIG。
订阅链接通常带有访问凭证。不要把完整链接发布到公开 issue、截图、聊天记录或公共代码仓库；如果怀疑泄露，应在订阅提供方后台重置或重新生成链接。
导入后如何确认 Surge 真的在按配置工作
- 在配置文本中确认策略组名称存在，并且至少包含一个实际代理或 DIRECT。
- 在 Surge 请求列表或 Dashboard 查看目标请求的命中规则、策略组和最终连接状态。
- 分别测试一个明确走代理的域名和一个应直连的域名，确认规则顺序没有覆盖关系。
- 如果怀疑出口没有变化，对比启用配置前后的出口 IP；如果只是节点测速，不能代替真实请求验证。
- 遇到单个协议失败时，先切换到同订阅中的基础协议节点，再判断是节点本身还是 Surge 配置转换问题。
Surge 官方 Quick Start 建议通过请求列表或 Dashboard 检查流量是否被捕获并按规则匹配；因此“能导入”与“流量按预期走策略”应分开验证。
常见问题
Surge配置转换和订阅转换有什么区别？
配置文件转换是把已有完整配置改成 Surge 可读格式；订阅转换是把节点链接、Base64 或其他客户端订阅生成 Surge 节点与配置。前者重点看区块语法，后者重点看协议兼容和节点完整性。
为什么 subconverter 生成的链接在电脑能打开，Surge iOS 却导入失败？
最常见原因是链接使用了 127.0.0.1。这个地址只指向运行转换器的本机，手机访问时应改用电脑局域网 IP，并让服务监听局域网，或改用手机可访问的托管 HTTPS 地址。
Sub-Store 的 Surge 输出链接怎么写？
通用形式是 /download/订阅名?target=Surge，也可以使用 /download/订阅名/Surge。实际域名、订阅名和访问权限以你的 Sub-Store 实例为准。
转换后 VLESS Reality、Hysteria 2 或 TUIC 节点不见了怎么办？
先确认目标客户端和对应平台是否支持该协议，再检查转换器是否过滤不兼容节点。节点被输出不代表一定能连接，仍需核对服务端参数、证书、认证字段和客户端版本。
Surge 导入成功但无法访问网站，应该先查什么？
先看请求日志是否命中预期策略，再检查 [Proxy] 中节点、[Proxy Group] 中引用和 [Rule] 的顺序，最后确认 FINAL 没有错误地指向 DIRECT。
相关阅读
参考资料
- Surge Quick Start（manual.nssurge.com）
- Surge Policy Overview（manual.nssurge.com）
- Surge Managed Profile（manual.nssurge.com）
- Surge URL Scheme（manual.nssurge.com）
- Surge TUIC（manual.nssurge.com）
- Sub-Store 订阅转换文档（sub-store-org.github.io）
- subconverter README-cn.md