sing-box GitHub 官方仓库、版本下载与安装指南
简答：sing-box 的官方 GitHub 仓库是 SagerNet/sing-box，代码、Releases 和项目说明都应从这个仓库进入。2026年10月28日核验时，GitHub Releases 将 1.14.4 标记为 Latest，将 1.15.0-alpha.13 标记为 Pre-release；普通用户优先选择 Latest，并根据系统和 CPU 架构下载对应资产。
定义：sing-box 是一个通用代理平台，官方项目仓库位于 GitHub 的 SagerNet/sing-box，提供核心程序、配置文档、图形客户端入口和版本发布资产。
先确认：sing-box GitHub 官方仓库是哪一个
搜索“sing box github”时，最短判断方法是打开 SagerNet/sing-box 官方仓库，再从仓库内进入 Releases 和文档。仓库页面将项目定位为“通用代理平台”，并列出代码目录、许可证和官方文档入口。
本文是面向安装、下载和连接排查的第三方使用指南，不代表 sing-box 官方。名称相近的脚本仓库、镜像仓库或带有额外广告的客户端，不应默认等同于官方项目；官方图形客户端页面也明确说明，部分声称使用 sing-box 的第三方项目并未列入官方客户端列表。
| 你要找的内容 | 优先入口 | 判断方法 |
|---|---|---|
| 源代码与项目说明 | GitHub 仓库 | 仓库路径应为 SagerNet/sing-box |
| 稳定版与预发布版 | GitHub Releases | 查看 Latest 或 Pre-release 标记 |
| 配置字段与安装说明 | 官方文档 | 从文档目录进入 Installation、Configuration、Log |
| 图形客户端 | Graphical Clients | 按 Android、Apple、Windows/Linux 分类查看 |
GitHub Releases 怎么选版本和下载文件
截至 2026年10月28日，官方 Releases 页面显示 1.14.4 为 Latest，1.15.0-alpha.13 为 Pre-release。Latest 适合希望优先使用稳定发布版本的普通用户；Alpha 属于预发布版本，适合需要测试新变化、能够自行回滚和排查配置的用户。版本更新较快，页面中的版本号、日期、资产名称和说明应以你实际打开时显示的内容为准。
- 打开 SagerNet/sing-box Releases。
- 先看版本标签：选择 Latest，除非你明确需要测试 Pre-release。
- 展开 Assets，根据系统和 CPU 架构选择文件，不要只按文件名中的“windows”或“linux”判断。
- 下载后保留原始文件名，并在可用时查看资产旁边显示的 SHA-256 摘要。
- 如果 Release 页面没有提供你需要的校验信息，不要自行编造哈希；可改用官方包管理器，或重新从官方仓库确认对应资产。
官方 Releases 页面曾在资产列表中显示 SHA-256 值，但不同资产和页面加载状态可能不同，因此校验时必须逐字对照当前资产详情，不能把某一个平台文件的哈希套用到其他平台。
Windows、macOS、Linux 和 Android 怎么安装
如果你只想在桌面系统使用，先区分“核心程序”和“图形客户端”：核心程序需要配置文件和命令行启动；图形客户端通常负责界面、系统代理或平台功能。官方文档的图形客户端列表将 Android、Apple 平台以及 Windows/Linux 桌面客户端分开列出，具体安装方式以对应页面为准。
Windows
可以从 GitHub Releases 下载与 Windows 和 CPU 架构匹配的资产，也可以按官方包管理页面列出的方式使用 winget、Scoop 或 Chocolatey。安装后在终端执行 sing-box version；如果系统提示找不到命令，先检查安装目录是否已加入 PATH，或直接在程序所在目录运行。
macOS
macOS 可从 Releases 选择匹配架构的文件，也可以使用 Homebrew：brew install sing-box。安装完成后执行 sing-box version 检查命令是否可用。Homebrew 安装的是核心程序，不等于已经导入订阅或启用了系统代理。
Linux
官方包管理文档提供 Debian/Ubuntu、Red Hat 系列以及其他包管理方式。以 Debian/Ubuntu 为例，应按照官方页面添加仓库密钥和软件源，再执行安装命令；不要把网页上来历不明的一键脚本当作官方安装方式。安装后可用 sing-box version 检查版本，并根据实际配置文件位置启动。
Android
Android 用户应从官方图形客户端页面进入对应项目，再核对其发布入口和适用版本。不要因为某个应用名称包含 sing-box 就默认其属于官方客户端；官方客户端列表是更可靠的起点。
安装后最短校验流程：版本、配置、启动、日志
- 检查版本：执行
sing-box version，确认实际运行的程序不是旧版本或其他目录中的同名文件。 - 准备配置：把配置文件放在你启动命令指定的位置。订阅链接、Clash YAML、V2Ray 节点列表和 sing-box JSON 配置不是同一种格式，不能直接改后缀当作兼容文件。
- 校验配置：使用当前版本支持的配置检查命令，并结合 官方 JSON Schema 核对字段。字段是否兼容取决于实际版本，旧教程不能替代当前版本文档。
- 启动并观察输出：先用前台方式启动，便于直接看到文件路径、字段、权限或端口错误；确认无误后再交给系统服务管理。
- 查看日志：Linux 使用 systemd 时，可执行
sudo journalctl -u sing-box --output cat -e查看最近日志，持续观察可用sudo journalctl -u sing-box --output cat -f。日志只能说明程序启动和连接过程，不能单独证明所有目标地址都可用。
如果启动失败，先把问题分成三层：程序是否能运行、配置是否能通过校验、节点或网络是否能建立连接。不要一开始就同时修改 DNS、TUN、MTU 和路由，否则很难判断究竟是哪一步造成问题。
常见失败分流与恢复方法
| 现象 | 先检查 | 处理方式 |
|---|---|---|
| 命令不存在 | 程序路径、PATH、架构 | 在程序目录执行版本命令，或修正 PATH |
| 配置加载失败 | JSON 括号、字段名称、版本兼容性 | 恢复备份，按当前 Schema 逐项核对 |
| 程序启动但无法连接 | 节点地址、端口、认证、TLS 和系统时间 | 先验证单个节点，再检查 DNS、路由和网络 |
| 开启 TUN 后断网 | 权限、路由、DNS、已有 VPN 或代理 | 临时关闭 TUN 恢复直连，记录改动后逐项恢复 |
| 升级后旧配置报错 | 当前版本变更记录和弃用字段 | 备份旧配置，按官方 Migration、Deprecated 和配置文档调整 |
关闭 TUN 或恢复直连只适合缩小故障范围，测试完成后应恢复原来的系统代理、DNS 和路由设置。若设备用于跨境办公，建议在非工作关键时段完成升级，并保留上一版程序和配置备份。
与 sing-box GitHub 相关的延伸阅读
如果你是从客户端连接问题进入这个主题，可以继续查看本站的连接问题排查指南，先区分客户端、DNS、节点和系统网络故障；需要判断不同设备的配置入口时，可参考设备配置指南；如果已经能够连接但体验变慢，再看节点测速和选择方法。这些页面只作为排查路径补充，不替代 sing-box 当前版本的官方文档。
常见问题
sing-box GitHub 官方仓库是哪一个？
官方仓库是 <a href="https://github.com/SagerNet/sing-box">SagerNet/sing-box</a>。下载版本时应从该仓库的 Releases 进入，不要只根据搜索结果中的项目名称判断。
sing-box GitHub 上 Latest 和 Pre-release 有什么区别？
Latest 是 GitHub 当前标记的正式发布入口，Pre-release 是预发布版本。2026年10月28日核验时，1.14.4 标记为 Latest，1.15.0-alpha.13 标记为 Pre-release；普通用户通常先选择 Latest。
下载 sing-box 后怎么确认安装成功？
在终端执行 <code>sing-box version</code>。如果命令不存在，检查程序架构、安装目录和 PATH；如果能显示版本但启动失败，再继续校验配置文件和查看日志。
sing-box 的 GitHub 下载文件能直接导入订阅吗？
不能这样理解。GitHub Releases 通常提供程序或客户端资产，订阅链接、JSON 配置、Clash YAML 和节点列表属于不同格式，是否能导入取决于当前客户端的转换或导入功能，不能只改文件后缀。
找不到适合自己电脑的 sing-box 文件怎么办？
先确认操作系统和 CPU 架构，再回到当前 Release 的 Assets 列表核对文件名。若仍无法判断，优先使用官方文档列出的包管理方式，或查看对应平台的官方图形客户端入口。