本地配置

本地配置是一份保存在设备上的 sing-box JSON 文件。官方图形客户端提供编辑入口。修改前保存副本,注意逗号、引号和数组结构。

远程配置

远程配置通过 URL 获取内容,更新会再次读取该地址。客户端支持自动更新;具体更新行为以当前客户端设置和项目文档为准。

浏览器能打开地址不代表客户端一定拿到正确内容。如果返回网页或鉴权错误,应先处理链接与访问权限。

导入链接

官方客户端的远程配置导入协议采用下列形式。地址和名称分别进行 URL 编码;它只负责打开导入流程,不保证配置有效。

sing-box://import-remote-profile?url=已编码的配置地址#已编码的名称

导入后的核对

  1. 确认配置来源与更新时间。
  2. 确认当前运行的是刚导入的配置。
  3. 检查内核是否报告不支持的字段。
  4. 连接后检查 DNS、出站与规则是否符合预期。
资料来源:配置管理规范 · 配置格式
资料核对:2026-09-25。版本相关行为请以对应版本文档为准。