订阅转换配置文件：格式选择、导入与更新方法
简答：订阅转换配置文件的关键不是修改文件名，而是让转换结果匹配客户端所需格式：Clash/Mihomo 通常使用 YAML，sing-box 使用完整 JSON，其他客户端应选择对应输出格式。先确认客户端，再生成、导入并验证；格式不匹配时不要强行改后缀。
定义：订阅转换配置文件，是把原始订阅链接或节点列表整理成目标客户端能够读取的配置格式，可能包含节点、分组、路由、DNS 和更新地址。
先看结论：订阅链接、配置文件和节点链接不是一回事
如果你手里只有一个订阅地址，最短路径是：确认客户端→选择目标格式→生成远程订阅或配置文件→导入客户端→刷新并验证。不要把单个 ss://、vmess://、vless:// 链接当成完整配置文件，也不要只修改文件后缀来解决格式不兼容。
| 你手里的内容 | 通常包含什么 | 适合怎么处理 |
|---|---|---|
| 订阅链接 | 一个远程地址，客户端或转换服务需要再次访问它 | 选择目标客户端格式后生成远程订阅 |
| 节点链接 | 单个节点的协议、地址和参数 | 使用客户端的单节点导入入口 |
| Clash/Mihomo 配置 | YAML 配置，可能包含代理、分组、规则和 DNS | 导入支持该格式的客户端 |
| sing-box 配置 | 完整 JSON，可能包含入站、出站、路由和 DNS | 使用 Remote 或 Local profile 导入 |
| Surge、Shadowrocket、Quantumult X、Loon 配置 | 各自客户端的订阅或配置格式 | 选择对应目标格式，不要默认与 YAML 或 JSON 通用 |
Mihomo 官方文档明确说明其配置文件使用 YAML，并且缩进、大小写和空格都会影响解析；sing-box 官方文档则将 Remote profile 定义为通过 URL 更新的远程配置，客户端需要读取兼容的完整配置。可分别参考 Mihomo 配置语法 与 sing-box Profile 说明。
按客户端选择目标格式
先按客户端反向选择格式，再决定是否需要外部规则、节点筛选或自定义 DNS。不同客户端的界面名称会随版本变化，下面的表格只用于确定方向，具体导入入口应以当前客户端界面为准。
| 客户端或内核 | 优先尝试的格式 | 导入后的检查重点 |
|---|---|---|
| Clash 或 Mihomo | Mihomo/Clash YAML | 检查代理节点、代理组、规则、DNS 和端口字段是否完整 |
| sing-box | sing-box JSON | 必须是完整 JSON；Clash YAML 或单纯节点列表不能直接当成完整配置 |
| Surge | Surge 订阅或配置 | 检查策略组、规则、脚本和证书相关功能是否确实被转换结果支持 |
| Shadowrocket | 客户端支持的订阅或节点格式 | 检查协议、节点参数和远程更新是否被当前版本接受 |
| Quantumult X | Quantumult X 对应订阅或模块格式 | 区分节点订阅、重写、分流规则和任务模块 |
| Loon | Loon 对应订阅或插件格式 | 区分节点内容与插件、脚本、定时任务 |
| v2rayN | 标准协议链接或 v2rayN 支持的订阅格式 | 检查订阅地址是否可访问，以及协议字段是否被当前核心识别 |
Sub-Store 的公开文档列出了 Surge、Quantumult X、Loon、Stash、Egern 和 Shadowrocket 等客户端的配置入口，但这不等于所有协议或高级字段都能在每个版本中正常工作。具体支持范围仍需结合客户端和转换后内容核验，可查看其 公开项目说明。v2rayN 的订阅说明则列出了 VMess、Shadowsocks、SOCKS、VLESS、Trojan、Hysteria 2、TUIC、WireGuard 和 AnyTLS 等可识别内容，但实际解析仍受客户端核心和订阅返回格式影响，详见 v2rayN 订阅格式说明。
标准操作流程：从订阅链接到可用配置
- 前置条件：准备原始订阅链接、目标客户端名称、设备系统，以及客户端要求的格式。订阅链接属于敏感凭据，不要把完整地址粘贴到公开工单、截图或不明在线检测页。
- 确认返回类型：如果客户端需要 Mihomo，选择 Mihomo/Clash YAML；如果客户端需要 sing-box，选择完整 sing-box JSON；如果是 Surge、Shadowrocket、Quantumult X 或 Loon，则选择对应格式。没有对应格式时，先确认客户端是否支持其他输入方式。
- 选择转换参数：初次转换建议只设置目标格式和必要的节点筛选。外部配置、规则集、Node List、Emoji、UDP、TLS 校验等参数不要一次全部开启，否则出现空配置时不容易判断是哪一项造成问题。
- 生成远程订阅或文件：远程订阅适合需要定期更新节点的场景；本地文件适合一次性排查和离线备份。生成后先查看返回内容的开头和结构，不要只看下载是否成功。
- 导入客户端：远程订阅通常添加为 URL 或 Remote profile；本地配置则使用文件导入或本地 Profile。sing-box 的官方说明要求 Remote profile 指向兼容的远程配置 URL，并支持自动更新；Mihomo 则需要符合 YAML 语法的配置文件。
- 验证现象：先确认配置能保存，再确认节点数量、代理组、规则和 DNS 字段是否出现，最后启动客户端并测试一个明确的网站或应用。仅显示“已运行”不代表节点、路由和 DNS 一定正常。
- 回退方式：如果导入失败，删除新生成的配置并恢复原始订阅；如果导入成功但无法连接，先关闭外部规则和高级筛选，重新生成最小配置，再逐项恢复参数。
对于需要脚本、规则或远程配置组合的场景，Sub-Store 文档提供了不同客户端的配置文件和模块入口；但远程内容、脚本和规则可能随项目更新变化，使用前应查看当前公开说明。
即时转换还是自动更新：怎么选
| 方式 | 适用场景 | 优点 | 风险与限制 |
|---|---|---|---|
| 即时转换 | 排查格式、测试少量节点、制作一次性本地文件 | 便于查看完整结果，问题定位更直接 | 后续节点变化不会自动同步，需要重新转换 |
| 自动更新远程订阅 | 节点、分组或规则需要定期刷新 | 客户端可以重新请求同一个地址 | 订阅地址通常含有访问令牌；远程内容变化可能覆盖本地修改 |
| 本地配置加远程节点 | 希望自己控制规则，同时定期获取节点 | 本地规则与远程节点可以分开排查 | 字段合并、引用路径和客户端实现可能不一致 |
sing-box 官方文档区分了 Local profile 与 Remote profile：远程配置以 URL 作为更新来源，本地配置则保存在本机；远程刷新还可能覆盖此前的本地修改。因此，修改前应保留可恢复副本，并把“配置更新”和“客户端升级”当成两项不同操作。
安全上，优先使用 HTTPS 订阅地址；不要启用无法解释的外部配置，不要默认打开“跳过 TLS 验证”，也不要把带令牌的完整 URL发送给第三方测试服务。如果怀疑订阅泄露，应在提供方后台撤销旧链接并重新生成，而不是继续沿用旧地址。
转换失败、配置为空或节点缺失：按阶段排查
- 下载阶段失败：检查 URL 是否完整、是否过期、是否需要登录或额外请求头；用浏览器打开时如果返回登录页、错误页或 HTML 页面，客户端自然无法把它当成订阅配置。回退方式是回到提供方后台重新复制链接。
- 解析阶段失败：确认目标格式是否选错。Clash/Mihomo YAML、sing-box JSON、节点列表和完整配置不是同一种内容。sing-box 官方 FAQ 明确指出，Clash YAML 和节点列表不能直接作为 sing-box JSON 配置使用，可参考 sing-box 官方 FAQ。
- 配置为空或节点减少：暂时关闭节点筛选、关键词排除、外部配置和协议限制，只保留原始订阅与目标格式；如果节点恢复，再逐项添加筛选条件。
- 能导入但无法启动：查看第一条解析错误，重点检查 JSON/YAML 结构、未知字段、引用文件路径、权限和当前核心版本。不要为了消除错误随意删除 DNS 或路由字段，因为这可能改变实际流量处理方式。
- 启动后无法连接：确认已经选择节点或代理组，确认系统代理或 VPN 权限已开启，再检查 DNS、路由和其他网络工具是否冲突。运行状态只说明配置启动，不代表目标网站或应用已经按预期访问。
- 更新后失效：先手动刷新远程订阅，确认返回内容仍是目标格式，再重新选择当前 Profile。若只有某个新协议节点失效，应标记为“当前客户端或核心兼容性需核实”，不要通过改后缀或删除字段强行转换。
排障时建议记录系统、客户端名称、核心版本、失败阶段和脱敏后的首条错误；订阅令牌、节点密码、个人地址和完整配置不应直接公开。
使用前的最小自查清单
- 格式：目标客户端与输出格式对应，不能只看“订阅”两个字。
- 内容：返回的是配置、节点列表还是登录页，先确认内容类型。
- 权限：移动端首次启动可能需要系统 VPN 或网络权限，桌面端可能需要系统代理权限。
- 安全：订阅 URL 当作密码管理，截图和日志中打码，优先使用 HTTPS。
- 更新：远程配置适合自动更新，本地配置适合固定版本和逐项排查，两者不要混为一谈。
- 兼容性：协议、规则集、DNS、TUN、脚本和外部配置均可能受客户端版本限制，未实际验证的组合应标记为“需核实”。
如果你的目标是跨设备使用同一套配置，建议先在一台设备完成最小导入和连通性验证，再复制远程订阅地址到其他设备；不要在所有设备上同时修改多个参数。
常见问题
订阅链接可以直接改成 YAML 或 JSON 文件吗？
不能。订阅链接是远程地址，YAML 或 JSON 是返回内容的格式。需要先选择目标客户端并完成转换；只修改文件后缀不会改变内容结构。
Clash/Mihomo 配置能直接导入 sing-box 吗？
通常不能直接导入。Clash/Mihomo 常见配置是 YAML，sing-box 需要兼容当前核心的完整 JSON。应重新生成 sing-box 格式，并检查 DNS、路由和协议字段。
为什么转换后节点数量变少？
常见原因包括关键词筛选、协议过滤、外部配置限制、目标格式不支持某些节点，或原始订阅本身已变化。先关闭筛选和外部配置，再用最小参数重新转换。
远程订阅和本地配置哪个更好？
需要节点定期更新时选远程订阅；需要固定内容、逐项排查或离线备份时选本地配置。远程刷新可能覆盖本地修改，因此修改前应保留副本。
导入成功但客户端仍然无法连接怎么办？
按“选中节点或代理组→启动系统代理或 VPN 权限→检查 DNS 和路由→更换一个节点”的顺序排查。配置能保存或服务显示运行，并不等于实际连接已经成功。
订阅链接泄露后应该怎么处理？
将完整订阅地址视为访问凭据。若怀疑泄露，优先在提供方后台撤销旧链接并生成新链接，然后删除客户端中的旧地址；不要只修改显示名称或文件名。