sing-box 怎么导入配置文件？
简答：sing-box 导入配置文件的核心是准备一个合法的 JSON 配置，再通过对应图形客户端添加本地或远程配置。先不要急着启动：用 sing-box check 检查文件结构；如果校验通过，再在桌面端或 Android 客户端中添加配置并启动。不同版本的菜单名称可能不同，以当前版本界面为准。
定义：sing-box 配置文件是以 JSON 编写、用于定义 DNS、入站、出站和路由等内容的配置文档。
先试这一步：确认配置文件能被 sing-box 读取
sing-box 使用 JSON 作为配置文件格式，常见顶层字段包括 log、dns、inbounds、outbounds、route 和 experimental。官方文档还提供了配置检查命令 sing-box check。sing-box 配置文件说明
- 把配置文件保存为文本文件，例如
config.json。 - 确认文件内容是标准 JSON：使用英文双引号，键和值之间用冒号，项目之间用逗号。
- 在 sing-box 程序所在目录打开终端，执行
sing-box check -c config.json。 - 如果命令报告错误，先根据错误所在行检查逗号、括号、引号和字段名称，再尝试导入。
如果你拿到的是一段订阅链接，而不是 JSON 文件，不能直接把链接内容当作本地 JSON 使用。先确认客户端当前版本是否支持远程配置；如果不确定，优先让提供方给出 sing-box 格式的 JSON 配置，或先在浏览器中确认链接返回的确实是 JSON 文本。
sing-box 怎么导入配置文件：桌面端
官方 sing-box for Desktop 用于管理和运行本地或远程 sing-box 配置文件，支持 Windows 和 Linux。sing-box for Desktop 官方说明
- 打开 sing-box for Desktop，先确认客户端已经正常安装并能启动。
- 在配置管理区域选择添加本地配置或添加远程配置；不同版本的菜单和按钮名称可能不同，以当前版本界面为准。
- 选择你的
.json文件，或粘贴远程配置地址。 - 添加后选中该配置，先查看是否出现 JSON、字段或配置校验错误。
- 确认配置被识别后，再启动服务或开启 TUN。首次排查建议先只验证配置是否能运行，不要同时修改 DNS、路由和 TUN 参数。
如果桌面端无法识别文件，先把配置复制到 sing-box 程序目录之外的普通文件夹，再重新选择文件。文件扩展名不是唯一判断标准，内容必须符合 sing-box 当前版本支持的 JSON 结构。
Android 上导入 sing-box 配置文件
官方 sing-box for Android 可以管理和运行本地或远程 sing-box 配置文件，并提供 Android 平台的 TUN 功能。sing-box for Android 官方说明
- 把 JSON 配置文件下载到手机本地存储，记住保存位置。
- 打开 sing-box for Android，在配置管理区域选择添加本地配置；当前版本的具体入口名称以界面为准。
- 通过系统文件选择器选中 JSON 文件，等待客户端读取。
- 先检查配置是否显示为可用，再启动配置。
- 如果系统弹出 VPN 权限请求，只在你确认配置来源可信、并且确实要启用本机网络代理时允许。
Android 导入成功不等于所有流量都已经正常工作。若配置能启动但应用无法联网，先查看客户端日志，再分别检查出站、DNS、路由和 TUN 相关字段；不要一开始就删除配置或放开证书校验。
本地 JSON、远程配置和单节点链接有什么区别
| 类型 | 你拿到的内容 | 导入方式 | 先检查什么 |
|---|---|---|---|
| 本地 JSON | 以 { 开头的配置文本或 .json 文件 | 在客户端添加本地配置 | JSON 语法和 sing-box 字段 |
| 远程配置 | 一个配置文件地址 | 在客户端添加远程配置 | 地址是否可访问、返回内容是否为 JSON |
| 单节点链接 | 一条协议分享链接 | 不能默认当作完整 sing-box 配置 | 客户端是否支持该协议和转换方式 |
sing-box 的完整配置通常不只有一个出站节点，还可能包含 DNS、路由和入站等部分。官方配置结构列出了这些顶层字段，因此单独一条节点链接与完整配置文件不是同一类内容。官方配置结构说明
导入失败时，按这个顺序排查
- 提示 JSON 格式错误：检查最后一个项目后是否多了逗号、字符串是否使用英文双引号、花括号和方括号是否成对。
- 提示字段未知或不支持：可能是配置与当前 sing-box 版本不兼容。不要直接照搬旧教程中的字段，先在官方配置文档中搜索字段名称。
- 文件能添加但无法启动：再次执行
sing-box check -c config.json，并查看日志中最早出现的错误，而不是只看最后一行。 - 能启动但没有网络：先确认
outbounds中存在可用出站，并检查route.final或路由规则是否指向正确的出站。官方路由文档说明，final用于指定默认出站；为空时会使用第一个出站。sing-box Route 官方文档 - 启用 TUN 后网络异常：先关闭 TUN，确认普通配置可以运行，再逐项检查
auto_route、auto_detect_interface和平台支持情况。TUN 的可用字段和平台限制以官方文档为准。sing-box TUN 官方文档
排查时建议保留原始配置副本，只修改一项后重新校验。涉及 TUN、系统代理或路由的改动，先记录原设置，方便恢复。
导入前后的安全检查清单
- 不要把包含密码、密钥或订阅凭据的配置文件上传到不明网站。
- 不要为了“先连上”而直接开启证书不校验；证书相关设置应以配置来源和官方 TLS 文档为准。
- 配置文件能通过 JSON 校验，只代表格式基本正确，不代表服务器、域名、端口或出站一定可用。
- 导入后先观察日志和连接状态，再开启全局 TUN 或修改系统代理。
- 如果配置来自第三方，无法核实其内容时，先用文本编辑器查看其中的服务器地址、域名和敏感字段。
截至 2026-10-21，本文只依据 sing-box 官方配置与客户端文档整理；具体菜单、字段支持和行为可能随当前版本变化，遇到界面不一致时应以客户端实际界面和官方文档为准。
常见问题
sing-box 可以直接导入订阅链接吗？
要看当前客户端和链接返回的内容。若链接返回的是 sing-box 格式 JSON，通常可以作为远程配置处理；如果只是单节点分享链接，不能默认当作完整 sing-box 配置，需确认客户端是否支持该协议或转换方式。
为什么 JSON 文件能打开，但 sing-box 仍然无法导入？
文本编辑器能打开文件，只说明文件是可读文本，不代表它符合 sing-box 配置结构。请执行 sing-box check -c config.json，并根据报错检查字段、括号、逗号和当前版本兼容性。
sing-box 导入成功但无法联网怎么办？
先确认配置能够启动，再检查 outbounds 是否存在可用出站、route.final 或路由规则是否指向正确出站，并查看日志。建议先关闭 TUN 和系统代理，避免把配置问题与系统路由问题混在一起。
Windows 和 Android 的导入步骤完全一样吗？
核心流程相同，都是添加本地或远程配置并启动；但文件选择器、权限请求、TUN 实现和菜单名称存在平台差异。Windows 以 sing-box for Desktop 当前界面为准，Android 以 sing-box for Android 当前界面为准。