指南

sing-box 安装与使用入门

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

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

已经有订阅地址

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

查看订阅导入教程

需要安装图形客户端

  • Android:Project S 维护的 SFA 可以管理本地或远程 sing-box 配置。
  • Apple 平台:iOS 和 tvOS 可使用 App Store 上的 sing-box MT;macOS 使用独立 SFM 安装包。
  • Windows 与 Linux:使用 Project S 官方 sing-box for Desktop,再按系统与 CPU 架构选包。

查看客户端与平台说明

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

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

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

查看 Linux 首次安装与运行

稳定版本入口

日常使用通常优先选择当前正式稳定版;测试版本更适合明确需要验证新功能的场景。当前版本号、发布日期和下载项由版本页集中维护。