sing-box订阅怎么转换和导入?
简答:先不要把所有订阅都直接粘进sing-box:先判断它是原生sing-box JSON、Clash/Mihomo YAML、V2Ray链接/Base64,还是本地JSON文件。原生JSON可直接作为Remote或Local Profile导入;其他格式先用可信的转换工具生成sing-box JSON,再导入对应平台客户端。导入后至少验证配置能解析、节点能显示、服务能启动;本文只处理“订阅转换与导入”链路,不展开DNS、路由、TUN和速度优化。
定义:sing-box订阅转换,是把其他订阅格式或节点集合转换为sing-box可读取的JSON配置;导入则是将远程URL或本地JSON添加为客户端的Remote、Local或iCloud Profile。
先用这张表判断:你的订阅能不能直接导入
sing-box配置文件使用JSON结构,官方示例包含dns、inbounds、outbounds、route等顶层字段,并提供sing-box check检查配置的命令。看到“能打开链接”并不等于它就是可导入的sing-box配置;浏览器只显示文本,也不能证明客户端一定能解析。
以下判断只用于选择下一步,不代表某种格式一定包含全部协议或规则:
| 你手里的内容 | 常见特征 | 下一步 | 停止条件 |
|---|---|---|---|
| 原生sing-box远程订阅 | 访问后返回JSON,结构中能看到outbounds等配置字段 | 直接添加为Remote Profile | 如果返回HTML、登录页或错误文本,不要继续导入,先核对URL和权限 |
| 完整本地JSON配置 | 文件是JSON,且通常有outbounds、route等配置区块 | 作为Local Profile导入或打开 | 如果只有节点数组、字段不完整或JSON语法错误,先修复或重新转换 |
| Clash或Mihomo订阅 | 常见为YAML文本,包含代理、代理组或规则字段 | 转换输出目标选择sing-box | 不要把YAML文件直接当作sing-box JSON导入 |
| V2Ray链接或Base64订阅 | 以单条链接、编码文本或多条节点链接为主 | 先转换为sing-box JSON | 转换后节点数量、协议和TLS字段必须复核 |
| 本地节点列表JSON | 可能只有节点数组或自定义字段,没有完整配置区块 | 不能直接等同于完整Local Profile;重新生成完整配置 | 客户端提示缺少inbounds、outbounds或其他必需结构时停止 |
官方文档把Local Profile定义为本地sing-box配置,把Remote Profile定义为以URL为更新来源的远程sing-box配置;因此“本地文件”和“远程返回JSON”应分开处理。sing-box.sagernet.org
首屏三步:先转换,再导入,最后验证
- 备份原订阅并识别返回内容。复制原始订阅链接或保存原文件,不要在原链接上反复修改。用浏览器或下载方式观察返回内容:JSON、YAML、编码文本、登录页和错误页要分开记录。浏览器能打开只说明请求有响应,不代表配置有效。
- 选择转换方式。如果服务提供方已经给出sing-box专用订阅,优先使用原生链接;如果只有Clash、Mihomo或V2Ray格式,再选择转换器,并把目标格式明确设为sing-box。Sub-Store文档列出了sing-box输出目标,也说明它可以根据订阅和模板生成完整sing-box配置。sub-store-org.github.io
- 导入后做三层验证。第一层看配置是否成功解析;第二层看节点或出站是否出现;第三层启动服务后观察客户端状态和实际访问结果。不要把“节点显示出来”当成“代理已经可用”,也不要把一次网页访问当成长期稳定性结论。
如果你使用命令行版sing-box,可在本地备份配置后执行官方提供的sing-box check进行结构检查;图形客户端则以其配置预览、错误提示或日志为准。github.com
没有原生sing-box订阅时,在线转换和自建转换怎么选
| 方式 | 适合场景 | 优点 | 需要接受的限制 |
|---|---|---|---|
| 服务提供方原生订阅 | 后台明确提供sing-box或JSON配置 | 少一次转换,字段通常更接近原始配置 | 是否提供、支持哪些协议和规则,以服务提供方页面为准 |
| 在线转换 | 只偶尔转换,想快速验证格式 | 操作步骤少,不需要维护程序 | 订阅URL可能包含认证信息和节点信息,不应随意提交;转换模板和协议覆盖范围需核验 |
| 自建转换器 | 经常转换、需要固定模板或不希望把订阅交给第三方 | 数据处理路径可控,可保留自定义模板 | 需要自行部署、更新模板、处理兼容性和故障;具体安装命令应以项目当前README和发行版为准 |
Sub-Store官方文档明确支持多种格式转换、组合订阅和基于模板生成sing-box配置;其项目说明也提醒,订阅链接和推送URL可能包含敏感信息。subconverter项目的发行说明则记录了生成sing-box配置和导出sing-box节点列表的支持,但具体参数、模板和版本应以项目当前文档为准。github.com
安全做法:优先复制一条可撤销或可重新生成的订阅链接;不要把长期有效的主订阅Token粘贴到不明转换站;转换完成后如服务支持,重新生成订阅Token;导入失败时先删除转换链接,不要把Token公开发到日志、截图或工单中。
Windows、Android、iOS、macOS的最小导入路径
官方客户端页面将平台分为:Android使用sing-box for Android,iOS和macOS使用sing-box for Apple platforms,Windows使用sing-box for Desktop。Windows桌面客户端官方说明支持管理和运行本地或远程sing-box配置文件,系统要求页面列出Windows 10及以上版本。sing-box.sagernet.org
| 平台 | 最小操作路径 | 字段或结果 |
|---|---|---|
| Windows | 安装对应桌面客户端后,进入配置/Profile管理,选择添加Remote或Local;Remote填写订阅URL,Local选择本地JSON文件 | 保存后应能看到配置名称或内容预览;具体按钮名称以当前客户端界面为准 |
| Android | 打开sing-box for Android的Profile管理,选择Remote添加URL,或选择Local导入本地JSON | 保存后先确认配置可解析,再启动服务并观察状态 |
| iOS | 在sing-box for Apple platforms中进入Profile管理,选择Remote填写URL,或使用文件分享导入Local JSON | 系统可能要求VPN权限;授权弹窗未出现或被拒绝时,先处理权限,不要继续改订阅 |
| macOS | 进入客户端Profile管理,选择Remote或Local;远程配置填URL,本地配置选择JSON文件 | 先确认Profile保存成功,再启动服务;不要把服务启动状态等同于网页访问成功 |
官方通用客户端规范使用Local、iCloud和Remote三类Profile,其中Remote以URL作为更新来源,默认自动更新间隔为60分钟;但不同平台的实际按钮位置、权限弹窗和文件选择器可能不同,不能把一个平台的菜单名称硬套到另一个平台。sing-box.sagernet.org
如果客户端支持官方URL Scheme,也可以使用sing-box://import-remote-profile?url=编码后的URL#编码后的名称导入远程Profile;普通用户不需要手写该链接,直接使用客户端的添加Remote入口更稳妥。sing-box.sagernet.org
导入后节点不显示、解析失败、启动无网络:按现象分流
1. 节点列表为空或节点数量明显减少
- 先查看转换后的JSON是否仍包含
outbounds或节点对象。 - 对比原订阅与转换结果的节点数量,只把数量减少视为线索,不直接认定转换器故障。
- 重点检查协议是否被目标格式支持,以及是否启用了过滤、地区筛选或不支持协议排除。
- 如果只剩一个
direct出站,停止启动服务,回到转换模板和输入格式检查。
2. 配置解析失败
- 先确认返回内容不是HTML、登录页、JSON错误对象或空文件。
- 本地JSON先用格式化工具或官方
sing-box check检查语法和字段。 - 如果错误指向旧字段或DNS结构,不要直接套用其他版本教程。官方迁移文档记录了1.12等版本的配置字段变化,例如DNS服务器结构从旧的
address写法迁移到新的type结构;应按配置实际版本处理。github.com
3. Remote Profile无法更新
- 观察客户端显示的HTTP状态或错误提示:401/403优先检查认证、Token和访问权限;404优先核对URL路径;5xx优先检查转换服务或源站返回;超时优先检查当前网络和服务响应。
- 如果浏览器能打开但客户端更新失败,检查是否需要HTTP Basic认证、特殊请求头或客户端不支持的返回格式。
- 官方通用规范要求Remote Profile支持自动更新和HTTP Basic认证,但这只是规范对图形客户端能力的描述,不等于每个第三方客户端都实现完全相同的界面。sing-box.sagernet.org
4. 配置能导入但启动后没有网页访问
- 先看服务是否真正启动,再看当前是否选中了正确的Profile或节点组。
- 区分“节点显示”“服务运行”“代理出站成功”三个状态,逐层验证。
- 本文不继续展开DNS、路由和TUN配置;如果基础导入已经成功,应转到对应的连接问题排查页面。
协议和版本兼容:只检查转换结果,不凭名称猜测
sing-box官方客户端和配置文档列出了VLESS、VMess、Trojan、Hysteria2、TUIC、AnyTLS、WireGuard等出站类型,但“客户端支持该协议”不等于某个转换器一定能正确生成全部字段,也不等于服务端参数与转换结果完全匹配。sing-box.sagernet.org
遇到Reality、Hysteria2、TUIC或AnyTLS节点导入后不可用时,按以下顺序核对:
- 原订阅中是否确实包含该协议和必要参数。
- 转换结果中协议类型、服务器地址、端口、TLS、传输层和认证字段是否仍存在。
- 目标客户端当前版本是否支持该字段,错误日志是否明确指向某个字段。
- 只保留一个节点做最小验证,不要同时修改DNS、规则和TUN。
截至2026年11月1日,官方迁移文档仍持续记录配置字段和弃用项变化;如果配置来自旧模板,优先查看对应版本的迁移说明,不要仅凭文章发布日期判断兼容性。github.com
回滚清单:导入失败时恢复到可复现状态
- 保留原始订阅URL或原始文件,不覆盖备份。
- 删除失败的Remote或Local Profile,避免客户端继续自动更新错误内容。
- 只重新添加一个输入源、一个转换目标和一个节点,记录每次改动。
- 恢复原客户端配置后,确认原配置仍能打开,再判断问题来自输入订阅、转换器还是客户端。
- 如果订阅Token已经暴露,按提供方支持的方式重新生成或撤销;无法确认是否可撤销时,标记为“需核实”,不要继续公开使用。
这样可以把问题限制在“格式识别—转换输出—Profile导入—服务启动”四个环节,避免把DNS、路由、MTU等其他变量混进来。
本文边界与资料核验说明
本文是CreamData上的第三方使用指南,不是sing-box官方页面,也不声称提供官方客户端或官方下载服务。文中的平台归属、Profile类型、JSON配置结构、Remote更新规范和版本迁移说明,均以本次检索到的sing-box官方文档、官方项目仓库或转换项目公开文档为准;具体客户端菜单、转换模板和服务提供方是否提供原生订阅,仍需以当前页面实际显示为准。
常见问题
sing-box可以直接导入Clash订阅吗?
通常不要直接导入。先确认链接返回的是不是sing-box JSON;如果是Clash或Mihomo YAML,应先用可信转换器将目标格式设为sing-box,再把转换结果作为Remote或Local Profile导入。
本地JSON文件为什么导入后没有节点?
本地JSON可能只是节点列表,不是完整sing-box配置。先检查是否存在outbounds等配置区块,再检查节点数组是否为空、协议字段是否完整;必要时重新生成完整配置,而不是只修改文件扩展名。
Remote Profile能打开,为什么客户端仍然启动失败?
能打开只说明客户端或浏览器拿到了内容,不代表JSON结构、字段版本和协议参数都正确。先看配置解析错误,再用最小配置或单个节点验证,最后检查客户端版本与迁移文档。
订阅转换后节点数量变少,是转换失败吗?
不一定。可能是过滤规则、目标格式不支持某些协议、模板主动排除了节点,或源订阅本身返回内容发生变化。应对比原始内容和转换结果,并检查转换器的过滤和兼容选项。
sing-box订阅多久自动更新一次?
官方通用客户端规范给出的Remote Profile默认自动更新间隔是60分钟,但具体客户端是否支持、界面如何设置和实际更新时间,以当前客户端实现为准。sing-box.sagernet.org
导入后应该先改DNS或开启TUN吗?
不建议。本文只处理订阅转换与导入,先确认配置解析、节点显示、服务启动和基础代理出站,再单独排查DNS、路由或TUN问题。
相关阅读
参考资料
- sing-box 官方:通用图形客户端与 Profile 规范
- sing-box 官方:图形客户端与平台对应关系
- sing-box 官方:Desktop 客户端说明与系统要求
- sing-box 官方仓库:JSON 配置结构与检查命令
- sing-box 官方仓库:配置迁移说明
- Sub-Store 官方文档:订阅转换与 sing-box 配置生成(sub-store-org.github.io)
- Sub-Store 官方仓库:格式转换与敏感信息说明
- subconverter 官方仓库:版本发行说明与 sing-box 输出支持