sing-box 从选择设备对应的发行附件到阅读启动故障报告
WindowsMacLinux安卓sing-box 内核源码开放
sing-box 同时提供代理内核、命令行程序及面向不同平台的图形客户端。配置采用 JSON 写法,选文件时需要将系统、芯片和界面类型对应起来,再查看各平台文档。
sing-box 的应用获取方式
先匹配设备平台,再查看应用条目或项目发行列表中的安装条件。
Windows 桌面应用
Windows · 项目发行入口
macOS 桌面应用
macOS · 项目发行入口
Linux 桌面应用
Linux · 项目发行入口
Android 手机应用
Android · 项目发行入口
sing-box 的平台及授权说明
| 发行信息 | 以商家页面为准 |
|---|---|
| 发行记录 | |
| 查阅方式 | |
| 适用平台 | Windows、macOS、Linux、Android |
| 获取渠道 | GitHub Releases |
| 内核说明 | sing-box |
| 源码情况 | 请阅读项目授权说明 |
| 获取条件 | 源码开放 |
| 维护信息 | 查看变更说明变更情况请参看发行说明 |
| 项目仓库 | 开发者资料页 |
| 开发者页面 | 开发者资料页 |
sing-box 的功能与使用问答
客户端资料
sing-box 的图形客户端与命令行程序采用不同文件标识。选择安装方式之前,先确认所需的是桌面界面、手机应用还是命令行工具。
| 资料项 | 页面所述 | 出处页 |
|---|---|---|
| 授权条件 | 许可证含有名称使用限制,使用源码前应阅读完整条文 | 项目 LICENSE 文件 |
| 仓库信息 | 活动情况需查看项目记录 | 项目概况页 |
| 预览发行 | 以商家页面为准 | 项目发行列表 |
| 稳定发行 | 以商家页面为准 | 项目发行列表 |
| 发行记录 | 以商家页面为准 | 项目更新说明 |
许可证中的名称约束涉及衍生项目的命名与关联表述。判断某个应用是否由同一项目提供,应看发布主体和仓库关系,名称相近本身不能作为依据。
程序文件可在 sing-box 发行列表中查找,选择时将文件前缀与设备平台对应。
不同设备应该选哪类文件?
带窗口的客户端使用各自的平台前缀;命令行压缩包与桌面安装程序用途不同,选取之前先看文件类型。
| 使用环境 | 文件辨识方式 | 兼容条件 |
|---|---|---|
| Windows 常见桌面设备 | 以 SFW 开头的桌面安装程序 | 查看系统兼容说明 |
| Windows 的 ARM 设备 | SFW 前缀中对应 ARM 的文件 | 查看系统兼容说明 |
| Windows 的较早架构设备 | SFW 前缀中对应旧架构的文件 | 查看系统兼容说明 |
| macOS 的通用安装场景 | SFM 前缀带 Universal 标记的 pkg 文件 | 查看系统兼容说明 |
| macOS 按芯片选择 | SFM 前缀中区分 Apple 与 Intel 的 pkg 文件 | 查看系统兼容说明 |
| Linux 常见桌面设备 | SFL 前缀的发行版软件包 | 同时核对发行版与芯片类型 |
| Linux 的 ARM 设备 | SFL 前缀中对应 ARM 的软件包 | 同时核对发行版与芯片类型 |
| Android 手机 | SFA 前缀的 APK,通用包带 universal 标记 | 查看系统兼容说明 |
| 较早的 Android 设备 | 带 legacy 标记的兼容分支文件 | 查看分支兼容说明 |
压缩归档中的命令行程序不提供桌面窗口;Android 的应用分发渠道及 macOS 的包管理安装方式,另见项目文档的对应平台说明。
苹果移动设备的获取说明存在前后表述差异,宜先检查现行商店条目与开发主体;越狱设备专用的软件包不能当作普通安装包使用。相关介绍可见 手机软件栏目。
配置文件有哪些要求?
- 图形界面可分别管理设备上的配置文件和远程配置。需要认证的远程配置应按应用文档填写访问条件。
- 项目文档将 TUN 列为客户端的平台功能,可在对应系统说明中查阅设置方式。
- 内核与图形界面的更新内容需要分别查看,避免把内核变化直接当成界面功能。
- 源码仓库中另列桌面客户端项目,可据此区分界面代码与内核代码。
配置对象采用 sing-box 的 JSON 写法。其他软件的文件即使也包含代理信息,也不能直接假定兼容;可先查看 相关客户端介绍 。手机端资料集中在 安卓软件栏目 ,桌面端则可从 电脑软件栏目继续了解。
故障报告应怎样阅读?
公开问题记录描述的是特定环境,处理前应对照平台、配置与复现条件,不能直接套用到所有设备。
- Linux 的 DNS 解析异常,可留意与系统解析服务组合使用的相关问题记录。
- Windows 更新安装失败时,可参考有关缓存目录与安装程序运行位置的讨论。
- 规则集加载异常时,应查看报错对应的协议配置与加载条件,再核对相关修复说明。


