sing-box怎么导入本地配置?Windows、Android、macOS与iOS步骤
简答:先确认文件是完整的 sing-box JSON,而不是 Clash YAML、Base64 节点列表或单条分享链接;然后在客户端新建 Local/本地配置,选择或粘贴文件,保存后选中该配置并启动服务。导入、保存、启动、实际联网是四个不同阶段,任何一步失败都要分开排查。
定义:sing-box 本地配置是保存在设备上的 JSON 配置文件,客户端读取并校验后,才能作为当前 Profile 启动。
先判断:你的文件能不能直接导入
sing-box 官方配置文档明确说明,配置文件使用 JSON 格式,常见顶层字段包括 dns、inbounds、outbounds、route 和 experimental。因此,文件扩展名是 .json 只是初步判断,真正关键的是内容是否为完整配置。可先查看官方配置结构说明。
- 完整 sing-box JSON:通常以
{开始、以}结束,内部可看到配置对象和数组,例如outbounds、route等字段。 - Clash YAML:常见开头是
port:、proxies:或rules:,不是 JSON,不能直接当作 sing-box 本地配置。 - Base64 节点列表:如果全文没有大括号,主要由字母、数字、
+、/和=组成的连续字符构成,通常是编码后的节点列表,不是完整 JSON。 - 单条分享链接:如果内容以某种协议前缀开头,或只有一行链接,也不是完整配置文件,需要由支持该格式的工具转换或重新生成配置。
不要把含有订阅凭据、节点密码、私钥或证书的完整文件上传到在线转换站。优先在本地查看、备份和校验。
四个平台的本地导入方法
官方图形客户端把本地配置称为 Local Profile,并要求图形客户端提供编辑配置内容的入口;远程配置则以 URL 为更新来源。具体菜单文字会随平台和客户端版本变化,以下路径按官方 Profile 概念整理,若界面不同,应优先寻找“Profiles/配置”“新建”“Local/本地”“导入文件”或编辑器入口。参考官方图形客户端通用说明。
Windows:在桌面客户端中新建本地配置
- 打开 sing-box for Desktop,进入配置或 Profiles 管理区域。
- 选择新建配置,类型选择 Local/本地;如果界面提供“从文件导入”,直接选择本地 JSON。
- 如果只有编辑器,把 JSON 全文粘贴进去,确认首尾大括号完整,再保存。
- 回到配置列表,选中刚保存的 Profile。导入不等于启用,保存也不等于启动。
- 进入 Dashboard 或服务控制区域,启动服务并观察状态、日志和流量变化。
官方桌面客户端页面列出的 Windows 要求为 Windows 10 及以上;具体安装包、架构和当前版本应以官方桌面客户端页面当前显示为准。
Android:在 sing-box for Android 中使用 Local 配置
- 打开客户端的 Profiles/配置区域,选择新增配置。
- 选择 Local/本地类型;如果看到“从文件导入”或文件选择器,选择设备中的 JSON 文件;如果提供编辑器,也可以粘贴完整内容。
- 保存后点选该 Profile,使它成为当前配置。
- 返回 Dashboard,启动服务,并按系统提示授予 VPN 权限。
- 启动后先看服务状态,再用浏览器或其他应用访问一个确定可用的地址验证连接。
Android 客户端通过 Android 的 VpnService 提供非特权 TUN 实现,部分配置项还会受到 Android 平台权限限制;官方功能页也说明了工作目录和日志位置。遇到启动后立即停止,可查看客户端日志,而不是只看 Profile 是否已经保存。参考Android 官方功能说明。
macOS:使用 Apple 平台客户端的本地 Profile
- 进入 Profiles/配置管理,选择新建或添加 Profile。
- 选择 Local/本地,按界面提示选择 JSON 文件,或在配置编辑器中粘贴内容。
- 保存后重新点选该 Profile,再启动服务。
- 如果系统弹出网络扩展或权限确认,按系统提示完成授权,然后重新检查 Dashboard 状态。
Apple 平台官方说明列出了 iOS、macOS 和 tvOS 的客户端及其要求,但没有为所有版本固定同一套菜单名称,因此 macOS 的实际入口应以当前客户端界面为准。若更换过 macOS 独立客户端,官方迁移说明指出旧应用的 Profile 和设置不一定会自动继承,可查看官方迁移说明。
iPhone/iPad:按 Profiles 和本地配置入口操作
- 打开客户端,进入 Profiles/配置页面。
- 选择新增配置,寻找 Local/本地、从文件导入或配置编辑器入口。
- 从“文件”中选择 JSON,或粘贴完整配置并保存。
- 返回列表,明确点选刚保存的 Profile,再启动服务。
- 完成系统 VPN 权限确认后,用实际网页或应用测试,而不要只依据“配置已保存”判断成功。
官方 Apple 平台功能说明确认客户端使用 NetworkExtension 提供 TUN 实现,但不同版本的按钮名称可能不同。若找不到本地导入项,可先升级到当前可用客户端,或使用编辑器创建 Local Profile;不要把远程 URL 当成本地文件导入。
导入成功但不能连接:按四个阶段排查
本地配置问题建议按“文件—保存—启动—联网”顺序定位。不要一看到节点列表就认为已经生效,也不要把“服务启动”直接等同于“网页访问成功”。
- 文件阶段:确认内容是合法 JSON,括号、逗号和引号成对;如果客户端提示 JSON 解析错误,先重新复制原文件,不要直接猜字段。
- 保存阶段:确认配置列表中出现了新的 Local Profile,并且重新打开编辑器后内容仍在。没有保存成功时,后面的启动排查没有意义。
- 启动阶段:选中正确 Profile 后再启动服务。若启动后立即停止,查看日志中的字段名、协议类型、DNS、TUN 或证书错误。sing-box 官方提供命令行校验和格式化命令,可在有命令行环境时使用:
sing-box check -c config.json
sing-box format -w -c config.json -D config_directory如果命令行返回错误,原始报错文案应以本机日志为准。常见的 invalid character、unexpected end 只是 JSON 解析错误的示例,不同客户端可能显示不同文字。
- 联网阶段:确认服务状态为运行,再访问实际目标;如果只有部分应用可用,继续检查路由、DNS、TUN 和应用分流。Android 与 Apple 客户端对 TUN、应用选择和系统权限的支持并不完全相同,可分别查看官方平台功能说明。
如果配置来自较旧版本,字段兼容性也可能影响启动。官方迁移页面列出了不同版本的弃用字段和迁移方式,例如 TUN 字段、DNS 规则以及 WireGuard 配置变化;遇到“字段不支持”时,应按当前内核版本对照迁移说明,而不是盲目删除字段。
本地配置和远程配置怎么选
本地配置适合已经拿到完整 JSON、需要离线保存或手动修改的场景;远程配置适合由 URL 提供内容并按客户端机制更新的场景。官方通用客户端说明将两者定义为不同 Profile 类型,不能把本地文件和远程订阅混为一谈。
- 本地配置:文件保存在设备上,更新通常需要重新替换、编辑或导入;适合固定版本和本地备份。
- 远程配置:以 URL 作为更新来源,客户端可按实现提供自动更新;适合由远端维护内容,但依赖访问 URL 和远端内容。
- 隐私差异:本地文件不应随意上传;远程 URL 可能包含访问凭据或订阅标识,也不应公开转发。
- 排错差异:本地导入失败先查 JSON 和字段;远程配置失败还要增加 URL、HTTP 状态码和下载权限排查。
如果你实际拿到的是订阅链接而不是 JSON 文件,可参考站内的sing-box订阅怎么添加;如果已经导入但无法联网,可继续查看VPN连接失败排查步骤。想了解不同客户端的导入差异,可阅读电脑换手机后的配置迁移方法。
常见问题
导入本地配置后为什么没有节点?
先确认你导入的是完整 sing-box JSON,而不是单条分享链接、Base64 节点列表或 Clash YAML。然后检查 JSON 中是否确实存在可用的 outbounds,以及客户端是否选中了刚导入的 Profile。
导入成功和启用成功是一回事吗?
不是。导入表示客户端取得了文件,保存表示 Profile 被写入配置列表,启用或启动表示内核开始运行,联网验证则要确认实际应用流量能够通过。四个阶段应分别确认。
客户端提示 JSON 解析失败怎么办?
先把文件复制到本地文本编辑器,检查最外层大括号、引号、逗号和文件末尾是否完整;再使用 sing-box check -c config.json 校验。不要根据某一个英文关键词直接判断,实际报错应以客户端日志为准。
Windows、Android、macOS 和 iOS 的按钮为什么不一样?
官方将它们划分为不同平台客户端,并且平台权限和网络扩展实现不同。菜单名称、导入入口和授权提示可能随客户端版本变化,优先寻找 Profiles/配置、Local/本地、新建、导入文件和编辑器入口。
本地 JSON 能不能直接改成远程订阅?
不能简单改文件名或添加 URL。Local Profile 和 Remote Profile 是不同类型;远程配置需要一个可访问的 URL,并由客户端按其实现进行下载和更新。
本文为独立整理,非sing-box官方,引用页面仅作参考,与本站无合作关系。
sing-box本地配置导入速查
| 对象 | 判断标准 | 下一步 |
|---|---|---|
| 完整 sing-box JSON | 有大括号,能看到 dns、outbounds、route 等配置字段 | 选择 Local/本地并导入或粘贴 |
| Clash YAML | 常见为 port:、proxies:、rules: 等键值格式 | 不要直接导入,先转换或获取 sing-box JSON |
| Base64 节点列表 | 没有大括号,主要是连续编码字符 | 先在本地识别或转换,不要当完整配置 |
| 单条分享链接 | 通常只有一行协议链接 | 需要生成完整配置后再导入 |
| 已保存未启动 | 列表中有 Profile,但服务状态未运行 | 重新选中配置并启动服务 |
| 已启动未联网 | 服务运行但实际网页或应用不可用 | 查日志、DNS、路由、TUN和系统权限 |
常见问题
sing-box本地配置必须是JSON吗?
官方配置文档说明 sing-box 使用 JSON 配置文件。扩展名不是唯一判断标准,仍需确认内容结构和字段是否符合当前内核。
Android上找不到本地导入按钮怎么办?
进入 Profiles/配置区域,寻找新增、Local/本地、文件选择器或编辑器入口。不同版本菜单可能不同;如果只有远程配置入口,应查看当前客户端是否提供本地编辑或文件导入功能。
为什么配置保存了却不能上网?
保存只代表 Profile 写入成功,不代表服务已经启动或流量已经通过。请依次确认选中配置、启动服务、完成VPN权限授权,再用实际网页或应用验证。
旧配置提示字段不支持怎么办?
先保留原文件并查看日志中的字段名,再对照官方 Migration 页面确认该字段是否弃用或需要迁移,不要直接删除不理解的字段。