sing-box GitHub 官方仓库在哪？下载、版本与安装入口核验
简答：sing-box 官方 GitHub 仓库是 SagerNet/sing-box。日常使用优先选择 Releases 中的稳定版，按系统与架构下载；安装后用 sing-box check 检查 JSON 配置，再根据日志确认启动结果。
定义：sing-box 是由 SagerNet 维护的通用代理平台，官方代码仓库、发布文件和配置文档分别集中在 GitHub 与 sing-box.sagernet.org。
先确认 sing-box GitHub 官方仓库
本文与 sing-box 项目及其开发者无隶属关系。搜索“sing-box GitHub”时，优先核对地址是否为 GitHub 上的 SagerNet/sing-box 仓库。该仓库页面将项目描述为 “The universal proxy platform”，并把文档入口指向 sing-box.sagernet.org。
识别官方入口时看三项：仓库所有者是否为 SagerNet，路径是否完整为 SagerNet/sing-box，页面中的文档入口是否指向官方文档域名。名称相近的个人仓库、脚本集合或二次封装项目，即使包含 sing-box 名称，也不能直接视为官方项目。
- 看源码和提交记录：进入官方 GitHub 仓库的 Code 页面。
- 下载已编译文件：进入官方 Releases 页面。
- 查配置字段和命令：进入官方文档，不要只依据第三方脚本中的说明。
官方文档的客户端页面还特别说明，部分声称使用 sing-box 的第三方项目并不在官方客户端列表中。因此，看到“基于 sing-box”并不等于它就是 SagerNet 维护的官方客户端。官方图形客户端列表可作为进一步核对入口。
版本怎么选：稳定版、alpha 版和旧版本
截至 2026 年 10 月 24 日，官方 Releases 页面列出 1.14.4，同时列出 1.15.0-alpha.13 等预发布版本。页面将 alpha 版本标记为 Pre-release，因此版本号更大不代表更适合日常使用。
| 版本类型 | 适合场景 | 建议 | 安装前检查 |
|---|---|---|---|
| 稳定版 | 日常使用、首次安装、长期运行 | 优先选择 | 系统、CPU 架构、配置字段 |
| alpha 预发布版 | 测试新功能或复现特定问题 | 与稳定环境分开测试 | 发布说明、兼容性和回滚文件 |
| 旧版本 | 必须兼容旧配置或旧系统 | 确认需求后再使用 | 对应版本的发布说明和配置变化 |
下载时不要只看版本号。Release 页面会同时列出不同系统和架构的文件，应该核对文件名、系统、CPU 架构以及页面提供的校验信息。如果文件无法在官方 Release 页面找到对应条目，或校验值无法对应，建议停止安装并重新确认来源。
按平台选择安装入口
官方客户端页面将图形客户端按平台区分：Android 使用 sing-box for Android，iOS、macOS 和 Apple tvOS 使用 sing-box for Apple platforms，Windows 和 Linux 使用 sing-box for Desktop。核心程序、图形客户端和 Docker 镜像不是同一个安装入口，应按实际用途选择。平台客户端列表可用于核对入口。
| 平台或场景 | 优先查看 | 适用说明 |
|---|---|---|
| Windows | 官方 Desktop 客户端或 Releases | 适合桌面图形操作，也可按 Release 文件手动安装 |
| macOS | 官方 Apple 客户端或 Releases | 图形客户端与核心程序的权限和启动方式可能不同 |
| Linux | 包管理器、手动安装或 Docker | 长期运行时还要查看服务管理和日志 |
| Android | 官方 Android 客户端页面 | 移动端配置、权限和桌面核心程序不同 |
| iOS | 官方 Apple 客户端页面 | 以官方页面当前提供的分发方式为准 |
| Docker | 官方 Docker 文档 | 适合已有容器管理流程的用户，不等同于桌面客户端 |
Linux 用户可以查看官方包管理器文档，其中包含仓库安装、手动安装、托管安装、服务管理和 Docker 等入口。普通用户没有必要为了首次使用直接源码构建；如果只是导入已有配置，优先选择与你的系统和架构匹配的稳定安装包。
安装后按顺序核验：版本、配置、启动
第一步：查看版本。在终端运行：
sing-box version
如果当前版本不支持该命令，先运行 sing-box --help 查看本机二进制提供的命令；不要把本文示例当成所有旧版本的保证。判定标准是：终端能够显示已安装程序的版本信息，并且主版本、次版本和预发布标记能够与官方 Releases 页面对应。
第二步：检查 JSON 配置。sing-box 官方配置文档明确说明配置文件使用 JSON，并提供 check 子命令。可以先在配置文件所在目录运行：
sing-box check
如果配置文件不在默认目录，应根据当前版本的帮助信息补充 -c 指定文件，或使用 -C 指定配置目录。判定标准是命令没有输出配置错误；如果出现 JSON 解析失败、未知字段、字段类型错误或路径错误，先修正配置，再继续启动。相关格式、检查和合并命令见官方配置文档。
第三步：启动并看日志。临时运行时，重点观察配置是否成功读取、监听地址是否冲突、DNS 或 TUN 权限是否报错。若使用 Linux 服务，还应结合 systemd 状态和日志判断：
sudo systemctl status sing-box：查看服务状态。sudo journalctl -u sing-box --output cat -e：查看近期日志。sudo journalctl -u sing-box --output cat -f：持续跟踪日志。
这些命令的前提是系统已通过包管理器或其他方式创建对应的 systemd 服务。若服务不存在，先回到官方安装与服务管理说明确认安装方式。服务显示运行中，也不等于网络连接已经正常，还需要确认入站、出站、路由和 DNS 配置。
包管理器、Docker、手动下载和源码构建有什么区别
不同安装方式的维护边界不同。包管理器更适合希望使用系统安装和服务管理的 Linux 用户；GitHub Releases 适合手动下载指定平台文件；Docker 适合已有容器环境的部署；源码构建则面向开发者、发行版维护者或需要自定义构建参数的高级用户。
| 方式 | 主要优点 | 主要注意事项 |
|---|---|---|
| GitHub Releases | 可直接选择指定系统和架构 | 需要自行核对文件、权限和升级过程 |
| 包管理器 | 便于安装、升级和服务管理 | 仓库渠道和版本轨道要看官方说明 |
| Docker | 便于隔离运行环境和统一部署 | 需要准备配置目录、卷挂载和容器权限 |
| 源码构建 | 可使用构建标签和自定义参数 | 需要匹配 Go、平台和编译依赖 |
官方 Docker 文档给出的基本命令如下，前提是主机已经安装 Docker，并且 /etc/sing-box/ 中准备了配置文件：
docker run -d -v /etc/sing-box:/etc/sing-box/ --name=sing-box --restart=always ghcr.io/sagernet/sing-box -D /var/lib/sing-box -C /etc/sing-box/ run
命令来源见官方 Docker 安装文档。启动后可以运行 docker ps 查看容器是否持续运行，再运行 docker logs sing-box 查看日志。若容器反复退出，优先检查挂载路径、配置文件和 JSON 格式，不要直接更换到陌生镜像。
源码构建前应阅读官方源码构建说明。文档列出不同版本要求、简单构建、自定义构建、构建标签、链接器参数和平台差异。具体 Go 版本、标签和依赖应以该页面与当前源码分支为准，无法从当前页面确认的旧版本要求不要照搬。
第三方一键脚本如何核验
第三方脚本仓库与 SagerNet/sing-box 官方仓库不是同一层级。脚本可能额外创建系统用户、修改防火墙、写入 systemd、下载其他组件或生成服务端配置；这些行为不能仅凭“使用 sing-box”这一描述推断为官方支持。
执行脚本前至少检查：
- 仓库所有者、提交记录和脚本最近修改时间。
- 脚本是否使用固定且可核对的下载地址。
- 是否写入系统目录、修改防火墙或需要 root 权限。
- 配置文件、密钥、日志和环境变量是否会被保存。
- 是否提供卸载、回滚和清理步骤。
无法从公开资料确认的行为应标记为“未核实”。更稳妥的顺序是：先从官方仓库确认版本，再从官方文档选择安装方式，安装后执行配置检查，最后通过进程、服务状态和日志确认启动结果。只有确实需要额外自动化时，才考虑社区脚本，并保留旧配置和可回滚文件。
下载和安装前自查清单
- 地址是否为
github.com/SagerNet/sing-box或sing-box.sagernet.org。 - Release 是稳定版还是明确标注的 alpha 预发布版。
- 文件名是否匹配操作系统和 CPU 架构。
- 文件是否能在官方 Releases 页面找到对应条目。
- 配置是否为 JSON，且能通过
sing-box check。 - Docker 是否挂载了正确的配置目录，并能从日志确认启动。
- Linux 服务是否能通过 systemd 状态和 journal 日志核验。
- 第三方脚本的权限、下载源、写入路径和卸载方式是否清楚。
如果你的目标只是找到官方 GitHub 入口，先确认仓库路径即可；如果要部署长期运行的服务，再继续核对版本、配置、服务管理和日志。
常见问题
sing-box GitHub 官方仓库是哪一个？
官方仓库是 https://github.com/SagerNet/sing-box/%E3%80%82%E8%AF%86%E5%88%AB%E9%87%8D%E7%82%B9%E6%98%AF%E6%89%80%E6%9C%89%E8%80%85 SagerNet、完整路径 SagerNet/sing-box，以及页面指向 sing-box.sagernet.org 的文档入口。
截至 2026 年 10 月 24 日，sing-box 应该下载哪个版本？
官方 Releases 页面当前列出 1.14.4 和 1.15.0-alpha.13 等版本。日常使用优先稳定版，alpha 版更适合测试新功能或复现特定问题。
Windows、macOS、Linux、Android 和 iOS 能下载同一个文件吗？
不能直接混用。官方客户端按平台分别提供，核心程序、图形客户端和移动端客户端的入口与权限不同，应按系统和 CPU 架构选择。
如何检查 sing-box 配置是否正确？
配置文件使用 JSON，可先运行 sing-box check；若配置不在默认目录，再根据 sing-box --help 使用 -c 指定文件或 -C 指定目录。通过后再启动并查看日志。
Docker 运行 sing-box 后如何判断是否正常？
先用 docker ps 查看容器是否持续运行，再用 docker logs sing-box 查看配置读取、权限和监听错误。容器反复退出时，优先检查挂载目录和 JSON 配置。
第三方一键脚本能代替官方 GitHub 仓库吗？
不能直接等同。第三方脚本可能修改系统、下载额外文件或生成配置，使用前应核对权限、下载源、写入路径、卸载方式和回滚方案；无法确认的部分应视为未核实。