指南

sing-box 安装与使用入门

从机场订阅导入、客户端选择和稳定版本确认开始,快速完成 sing-box 日常使用。

sing-box 既是代理核心,也会出现在带图形界面的客户端中。已有机场订阅时,最直接的路径是复制服务商提供的 sing-box 兼容链接,再导入适合平台的客户端。

已经有订阅地址

登录服务商面板,复制明确标注为 sing-box 的订阅或远程配置链接,再导入适合平台的客户端。导入成功后更新订阅,选择配置或节点并启动连接。

查看订阅导入教程

需要安装图形客户端

  • Android:Project S 维护的 SFA 可以管理本地或远程 sing-box 配置。
  • Apple 平台:查看 SFI、SFM、SFT 的当前下载说明;可用渠道可能随平台发布状态变化。
  • Windows:桌面官方客户端仍在开发中。需要图形界面时,可以单独评估 GUI.for.SingBox 等社区客户端。

查看客户端与平台说明

少数场景需要自行维护核心程序

如果要在 Linux 上长期运行服务,或需要维护完整 JSON 配置,可以直接安装 sing-box 核心。基本顺序是:

  1. 选择软件源、安装脚本或适合系统的包。
  2. 准备 JSON 配置。
  3. 运行 sing-box check
  4. 启动服务并检查日志。
  5. 升级前阅读迁移说明,处理已弃用字段。

查看 Linux 首次安装与运行

稳定版本入口

核心稳定版为 v1.13.12,发布日期为 2026-05-15。日常使用通常优先选择正式稳定版;测试版本更适合明确需要验证新功能的场景。