订阅转换器怎么选？从订阅链接到客户端导入的完整指南
简答：订阅转换器的作用，是把一份原始订阅或节点链接整理成目标客户端能读取的配置格式。最快做法是：先确认客户端需要的格式，再选择可信的在线或本地转换方式，生成结果后检查响应类型、节点数量和客户端日志；如果涉及真实订阅令牌，优先使用本地部署或确认服务端的隐私边界。
定义：订阅转换器是一类负责解析订阅链接、合并或筛选节点，并输出 Clash/Mihomo、Sing-box、V2Ray 等客户端配置的工具。
先看结论：订阅转换器并不会改变套餐或线路
如果你已经拿到订阅链接，但当前客户端提示格式不支持、导入后没有节点，或者需要合并多条订阅，订阅转换器通常可以解决的是格式整理、节点筛选、重命名、合并和配置生成。它不会自动增加流量、延长有效期、修复失效节点，也不会把原服务商没有提供的协议字段凭空补齐。
截至 2026-11-03，公开项目文档显示，SubConv主要面向 mihomo 兼容配置，并支持解析 Clash 配置与 V2Ray Base64 链接；Sub-Store 文档则覆盖订阅处理、格式转换、节点过滤、排序和重命名。不同项目的输出目标和协议实现并不相同，不能仅凭工具首页列出的格式名称判断所有节点都能转换。
| 你的情况 | 优先选择 | 转换后先验证什么 | 低风险回退 |
|---|---|---|---|
| 只想把远程订阅导入 mihomo 客户端 | 先尝试客户端直接添加订阅 | 是否能更新、是否出现节点和策略组 | 保留原订阅，不删除原配置 |
| 多个订阅需要合并或筛选 | 支持合并、过滤和重命名的转换器 | 节点数量、名称、协议类型是否仍在 | 只保留一条源订阅重新生成 |
| 需要 Sing-box JSON | 选择明确输出 Sing-box 的工具 | 用客户端或命令检查 JSON 结构 | 改用原始节点链接逐条导入 |
| 订阅含真实令牌或长期自动更新 | 本地部署或自建后端 | 请求路径、访问控制、日志和更新行为 | 撤销旧订阅链接并重新生成 |
三步完成订阅转换：复制、选择、验证
- 复制源订阅，但不要先公开粘贴。从服务商提供的订阅入口复制完整地址，先确认地址仍能在浏览器或客户端中返回内容。订阅链接通常可能包含身份令牌，不能把真实地址发到公开 issue、群聊或截图中。
- 按客户端选择目标格式。使用 mihomo 兼容客户端时，通常选择 Clash/Mihomo YAML；使用 sing-box 时选择 Sing-box JSON。V2Ray Base64 更像是节点列表或编码后的分享内容，不等同于完整的客户端配置。sing-box 官方文档明确说明其配置文件使用 JSON，并提供
sing-box check检查配置的方式，见sing-box 配置文档。 - 生成后进行三层验证。第一层看 HTTP 状态是否成功、Content-Type 是否匹配、返回内容是否是配置而不是 HTML 错误页；第二层统计节点数量并检查关键字段；第三层在客户端内更新配置、选择一个节点并查看日志。转换接口的成功状态码不代表所有节点都能连接，相关响应检查方法可参考SubConverter-Extended 的转换说明。
如果结果为空，先不要反复点击生成。把问题拆成“源订阅无法读取”“转换器无法解析”“目标格式不兼容”“客户端无法加载”四类，按下面的排查顺序处理。
按客户端选择格式：兼容性不要只看名称
| 目标客户端或场景 | 常见目标格式 | 可以确认的边界 | 需要自行核验的部分 |
|---|---|---|---|
| mihomo 及其兼容客户端 | Clash/Mihomo YAML 或 Proxy Provider | mihomo 文档明确支持 HTTP、file、inline 类型的 Proxy Provider，以及更新间隔、过滤和自定义请求头等字段，见mihomo Proxy Providers 文档 | 客户端是否完整支持模板中的规则、TUN、DNS、特殊协议字段 |
| sing-box | Sing-box JSON | 官方配置结构包括 DNS、入站、出站、路由和实验功能等字段，见sing-box 配置文档 | 转换器是否把源节点的 TLS、Reality、传输层和路由字段正确映射 |
| V2Ray/Xray 类客户端 | V2Ray Base64 或客户端专用 JSON | 部分转换器能读取 V2Ray Base64 分享内容；输入格式和输出格式并不是同一概念 | 客户端具体接受 Base64、JSON、远程订阅还是单节点链接 |
| Surge、Quantumult X、Loon、Shadowrocket | 各自的远程配置或节点格式 | 本次检索到的通用转换项目文档列出这些目标，但不同实现的字段保留规则不同 | 需以目标客户端当前文档和导入界面为准，不把“列表中出现”视为全部兼容 |
协议兼容矩阵的正确读法：SS、VMess、Trojan 等常见节点，即使能被识别，也可能在输出端因字段缺失而无法连接；VLESS Reality、Hysteria2、TUIC、AnyTLS 等协议更不能只看“转换成功”。如果转换结果出现节点被跳过、导入后节点数量减少、客户端提示字段缺失，或者节点存在但握手失败，应直接比较源节点与输出节点中的服务器、端口、UUID或密码、TLS、SNI、传输方式、Reality 公钥/Short ID、UDP和证书校验字段。缺少任一关键字段时，优先回退到客户端原生支持的订阅或单节点导入。
在线转换、本地文件和自建后端怎么选
| 方式 | 适合场景 | 主要风险 | 验证与回退 |
|---|---|---|---|
| 公共在线转换 | 一次性测试格式、没有长期保存需求 | 源订阅可能经过服务端；是否保存原文、日志和生成链接要看该站说明 | 使用脱敏或测试订阅；完成后删除生成链接，必要时撤销旧令牌 |
| 本地文件转换 | 已有 YAML、JSON、Base64 或节点文本，不希望上传远程令牌 | 本地工具仍可能读取文件中的完整凭据；配置备份也可能泄露 | 转换前复制一份只读备份；转换失败就恢复原文件，不覆盖源文件 |
| 自建后端 | 长期自动更新、多人使用、需要固定域名或统一模板 | 公网暴露、日志、访问控制、HTTPS和令牌管理需要自行负责 | 先用内网或本机验证，再上线；失败时切回原订阅地址 |
自建后端的核心不是“把链接变长”，而是控制谁能访问转换接口、后端是否实际下载源订阅、是否保存请求参数，以及客户端更新时请求经过哪里。mihomo 的 Proxy Provider 支持自定义请求头、更新间隔和过滤条件，但这些字段由客户端处理；转换后端生成成功，不等于客户端更新一定成功。相关行为应分别查看mihomo Proxy Provider 文档和目标客户端日志。
如果要在长期订阅管理中使用边界云加速，适用边界是自建后端、固定域名 HTTPS、订阅接口访问控制和连接问题诊断等基础设施场景；它不是订阅转换器本身，也不会替代转换器对格式和协议的解析。
隐私与令牌：转换前、转换后各做一次检查
- 识别令牌位置：检查订阅 URL 的路径、查询参数或短路径中是否包含随机字符串、token、key、uuid 等身份信息。不要把完整 URL 放入工单、公开仓库或聊天记录。
- 判断请求由谁发起：有些目标格式由客户端直接拉取源订阅，有些转换方式会由后端先下载再生成配置。两者会影响源服务商看到的请求 IP、User-Agent和请求时机，不能混为一谈。
- 转换后撤销旧令牌：如果链接已经公开、粘贴到陌生网站，或者无法确认服务端是否保存，请在原服务商账户中重新生成订阅链接；如果没有重新生成入口，联系服务商要求重置订阅链接。不要只删除浏览器历史记录，因为那不会让旧令牌失效。
- 分离验证与长期使用：先用临时或低权限订阅验证格式，再决定是否启用自动更新。若“生成失败”，看转换器返回的状态码和错误信息；若“生成成功但客户端失败”，看客户端是否能访问转换链接、Content-Type是否正确、配置中是否有节点；若“节点存在但连接失败”，逐项核对协议字段和客户端日志。
转换结果中不要只看“有多少行文本”。对 mihomo 配置，还要确认节点名称唯一、服务器和端口存在、Proxy Provider 的 URL可访问；对 sing-box，则应检查 JSON 能否通过客户端或命令行校验。任何无法解释的字段丢失，都应回退到源订阅，而不是直接修改大量参数。
转换失败排查：按现象定位，不要先改 DNS 或 MTU
| 现象 | 优先判断 | 操作 | 停止条件 |
|---|---|---|---|
| 返回 401、403 或订阅失效 | 源链接过期、权限限制或 User-Agent 要求 | 在不公开令牌的前提下，用原客户端测试源链接；核对服务商是否要求特定请求头 | 确认源链接失效后，重新生成订阅，不继续调整模板 |
| 返回 200，但内容是网页 | 接口地址错误、被重定向或服务端异常 | 检查 Content-Type、最终响应地址和响应前几行；HTML 不应当导入客户端 | 确认不是配置文本后，切回原地址或更换转换方式 |
| 转换成功但节点为零 | 解析失败、筛选条件过严或协议未被目标支持 | 关闭 include/exclude、规则模板和重命名，先生成最小结果；再逐项恢复 | 源订阅本身也为空时，停止排查转换器 |
| 导入后提示 YAML 或 JSON 错误 | 目标格式不匹配、转义错误或文件被截断 | 重新下载原始结果；YAML 用文本编辑器检查缩进，JSON用客户端或 sing-box check 检查 | 仍无法校验时，不手工批量修复，保留错误文件供定位 |
| 节点显示但无法连接 | 关键协议字段丢失、客户端不支持或节点本身失效 | 对比源节点和输出节点的服务器、端口、TLS、SNI、传输、认证和UDP字段，查看客户端日志 | 多个客户端都失败时，优先怀疑源节点或服务端，而不是继续改本机网络 |
| 首次可用，自动更新失败 | 转换链接过期、客户端访问不到后端、更新请求被拦截 | 复制转换链接到浏览器检查响应，再查看客户端更新日志和代理路径 | 临时改回原订阅，避免在故障期间丢失可用配置 |
不要在没有证据时先重置网络、修改 MTU、关闭安全软件或开启 TUN。订阅转换失败首先是内容和格式问题；只有当配置已经成功加载、单节点也能正常工作，但特定系统或网络环境仍出现连接异常时，才进入 Windows、macOS、iOS 或 Android 的网络排查流程。
多订阅合并、筛选和自动更新有什么区别
- 合并：把多条输入整理成一个输出，方便客户端只维护一个入口。合并后应检查重名节点、重复节点和来源变化。
- 筛选：按名称、地区、协议或正则表达式保留或排除节点。筛选条件过严会造成“转换成功但空节点”，调试时应先关闭筛选。
- 重命名：只改变展示名称，不等于改变服务器、延迟或协议能力。重命名后仍要保留能识别来源的标记。
- 自动更新：通常是客户端按间隔重新请求远程地址，或者后端定期处理源订阅。自动更新不保证源节点一直有效，也不保证客户端保留原有选择。
- 短链接：只是缩短或隐藏较长的请求地址，不等于增加安全性。只要短链接仍能访问真实订阅，就应按敏感凭据管理。
Sub-Store 处理文档明确列出正则筛选、协议筛选、排序、重命名、去重和脚本处理等能力，并说明处理顺序会影响最终结果。因此，排错时应先生成未经筛选的最小配置，再按“筛选—重命名—排序—规则模板”的顺序逐项启用。
新手可以直接照做的安全流程
- 保留原始订阅，不覆盖客户端现有配置。
- 确认客户端和目标格式：mihomo优先检查 Clash/Mihomo，sing-box优先检查 JSON。
- 第一次只转换一条订阅，不启用筛选、重命名和复杂规则。
- 检查响应不是 HTML，节点数量大于零，服务器、端口和协议字段存在。
- 导入客户端后先看配置加载结果，再测试单个节点和客户端日志。
- 确认可用后再开启自动更新，并记录转换地址、更新时间和回退用的原始订阅。
- 如果订阅令牌曾经公开或提交到不明在线工具，重新生成订阅链接。
这个流程的目标不是保证所有协议都能转换，而是把失败范围缩小：先证明源订阅有效，再证明转换结果可解析，最后才判断目标客户端和节点本身是否兼容。
推荐阅读：按具体任务继续排查
如果你已经确定要处理哪一种格式，可以继续查看站内对应指南：先看订阅转换有什么用理解是否需要转换；使用 Clash 或 mihomo 时参考Clash 订阅转换步骤；需要长期部署后端时查看订阅转换后端的 API 与自建排错；如果只想生成 YAML，可看订阅转换 YAML 的导入与排错。
常见问题
订阅转换器有什么用？
它主要用于把订阅或节点整理成目标客户端能读取的格式，也可以合并多条订阅、筛选节点、重命名和生成自动更新地址。它不会改变原订阅的流量、套餐有效期、节点质量或服务权限。
订阅转换后导入成功，但节点无法连接怎么办？
先区分“配置加载成功”和“节点连接成功”。逐项对比源节点与输出节点的服务器、端口、认证信息、TLS、SNI、传输方式、Reality参数、UDP和证书校验字段，再查看客户端日志。如果多个客户端都失败，应优先检查源节点是否已经失效。
在线订阅转换会泄露订阅吗？
风险取决于请求由谁发起、服务端是否保存原始 URL、是否记录日志以及生成链接是否公开。无法确认这些边界时，不要提交真实长期令牌；优先用本地转换、临时订阅或自建后端。已经公开的订阅链接应在原服务商处重新生成。
为什么转换结果是 200，但客户端仍然无法更新？
HTTP 200 只说明请求得到响应，不代表内容一定是正确配置。还要检查 Content-Type、响应是否为 HTML 错误页、配置中是否有节点，以及客户端是否能访问转换地址。客户端更新失败时，查看其更新日志和实际请求路径。
VLESS Reality、Hysteria2、TUIC、AnyTLS 都能转换吗？
不能只凭工具列出的协议名称下结论。转换器、目标格式和客户端可能只保留部分字段，表现可能是节点被跳过、导入后字段缺失或握手失败。应以具体项目文档和目标客户端文档为准，并对比输出中的关键协议字段；无法核实的组合应标记为需核实。
本地文件转换和在线转换怎么选？
只有本地文件且不需要长期自动更新时，本地转换更容易控制数据流向；需要固定远程地址和定期更新时，可以考虑自建后端，但必须同时处理 HTTPS、访问控制、日志和令牌撤销。