sing-box 客户端下载与使用:先选对平台,再导入配置
简答:先按设备选择图形客户端:Windows/Linux 使用 sing-box for Desktop,Android 使用 sing-box for Android,iPhone、iPad 和 macOS 使用 sing-box for Apple platforms。安装后还需要有效的 sing-box JSON、本地配置或兼容的远程配置,软件本身不会自动提供节点或订阅。
定义:sing-box 是一个使用 JSON 配置文件的网络代理核心及多平台图形客户端集合,客户端负责管理配置、系统代理或 TUN 权限,订阅服务则负责提供节点和配置内容。
先看下载选择:不要把核心程序和客户端混为一谈
本文是第三方使用指南,不是任何客户端或服务的官方网站。sing-box 项目文档将图形客户端分为 Android、Apple 平台、Windows 和 Linux 桌面端;如果你只是想在电脑或手机上导入配置并启动连接,优先选择对应平台的图形客户端,而不是先下载命令行核心。
| 设备或系统 | 优先选择 | 下载与架构注意事项 |
|---|---|---|
| Windows 10/11 | sing-box for Desktop | 项目文档列出 x64、x86、arm64,按 Windows 系统和处理器架构选择安装包。 |
| Linux | sing-box for Desktop 或命令行核心 | 桌面端文档列出 x64、arm64、armv7l;服务器或无桌面环境再考虑软件包或核心程序。 |
| macOS | sing-box for Apple platforms | Apple 平台页面列出 macOS 13.0 及以上要求;Standalone 版本与 App Store 版本的功能路径可能不同。 |
| Android | sing-box for Android | 图形客户端通过 Android VpnService 提供非 Root 的 TUN 能力,首次启动通常需要确认 VPN 权限。 |
| iPhone/iPad | sing-box for Apple platforms | 项目页面列出 iOS 15.0 及以上要求,下载入口和地区可用性以当前 App Store 页面为准。 |
| 服务器、脚本或高级用户 | sing-box 核心程序 | 需要自行准备 JSON、命令行参数和系统权限;不适合只想点击导入和连接的新手。 |
下载前建议从项目图形客户端页面进入对应平台说明,再从项目 Releases 页面核对安装包名称、版本和架构。本文不固定写死某个版本号,因为发布页面会持续变化。
安装前准备:先确认你手里的配置是什么
sing-box 的配置格式是 JSON,项目文档给出了包含 dns、inbounds、outbounds 和 route 等字段的基本结构。服务方提供的订阅链接、Clash YAML、单节点分享链接和 sing-box JSON 并不是同一种输入,能否直接导入取决于客户端和服务方是否提供转换或兼容支持。
| 你拿到的内容 | 处理建议 | 导入前检查 |
|---|---|---|
| sing-box JSON | 优先尝试作为本地文件或远程配置导入 | 确认文件是完整 JSON,而不是网页错误页或登录页。 |
| 远程订阅 URL | 在客户端中新建远程配置并粘贴链接 | 用浏览器或命令行确认链接可返回配置内容,注意不要公开包含令牌的 URL。 |
| Clash YAML | 不要默认认为可以直接导入 | 先向配置提供方确认是否有 sing-box 格式或转换方式。 |
| 单节点分享链接 | 确认客户端是否支持该协议和分享格式 | 协议、服务器地址、端口、认证字段缺一项都可能导致解析或连接失败。 |
如果你使用的是命令行核心,可以先把配置复制到新文件,再执行项目文档中的检查命令:
sing-box check -c config.json该命令适用于已安装 sing-box 核心的 Windows、macOS、Linux 或其他支持命令行的环境。预期结果是配置通过检查;如果提示 JSON 解析错误、字段未知或缺少必填字段,先修复配置,不要直接反复切换节点。项目配置文档还提供了格式化命令,可在备份后使用:
sing-box format -w -c config.json如果你使用的是图形客户端,则以当前界面提供的导入、校验和日志功能为准,不要把命令行参数直接填入图形客户端输入框。
各平台安装与首次连接:按这个最小闭环操作
- 下载安装包。Windows 和 Linux 从项目桌面端页面进入 Releases;Android 和 Apple 设备优先查看项目客户端页面列出的商店或测试渠道。下载后核对平台、架构和文件类型,遇到来源不明的二次打包文件不要直接运行。
- 先备份或新建配置。不要一开始就覆盖原配置。为测试单独建立一个配置条目,远程配置先记录名称和更新时间,本地 JSON 先复制一份。
- 导入配置。选择本地 JSON、远程配置或客户端支持的分享方式。导入后先查看配置名称、服务器字段、出站或节点组是否为空。
- 选择出站或节点组。如果配置包含 Selector、URLTest 或其他节点组,先选择一个明确的出站;如果默认出站为空,连接可能启动但没有可用路径。
- 启动权限。Windows、macOS 和 Linux 可能需要系统代理、TUN 或网络扩展权限;Android 和 iOS 通常需要确认系统 VPN 权限。只授予客户端正常工作所需的权限,不要为了排障长期关闭系统安全功能。
- 做三层验证。先看客户端日志是否显示服务启动,再确认 DNS 是否能解析目标域名,最后用浏览器或业务应用加载页面。延迟有返回不等于网页一定可用,因此不要只凭一个延迟数字判断节点成功。
- 记录结果并回滚。若启动后无网络,立即停止配置并切回系统原有网络;保留错误日志、配置名称和发生时间,再进入故障分流。
桌面端的定位是管理本地或远程 sing-box 配置,并提供包括 TUN 在内的平台功能;Android 文档明确说明,SFA 可通过 ForegroundService 或 VpnService 运行,是否能正常接管流量仍取决于配置、系统权限和路由规则。相关行为应以桌面端文档和Android 客户端功能说明为准。
按故障阶段排查:下载、导入、启动和联网不要混查
| 现象 | 先检查什么 | 下一步和回滚方法 |
|---|---|---|
| 下载失败或文件打不开 | 来源、系统架构、文件是否完整 | 重新从项目文档进入发布页;不要混用 x64、x86 和 arm64 文件。 |
| 配置解析失败 | 是否为 JSON、是否被网页或登录页替代 | 保存原文件后用 sing-box check 检查;Clash YAML 不要直接改扩展名冒充 JSON。 |
| 导入后没有节点或出站 | 配置返回内容、订阅是否过期、节点组是否为空 | 向配置提供方确认格式和有效期;不要把包含令牌的订阅地址发到公开论坛。 |
| 启动时报权限错误 | 系统代理、TUN、VPN 或网络扩展权限 | 只重新授权当前客户端;仍失败时先关闭配置,恢复系统原网络,再查日志。 |
| 启动后网页打不开 | 出站选择、DNS、系统代理和路由规则 | 先用一个明确出站做测试,再分别验证 DNS 解析和网页加载,避免同时修改 DNS、MTU、规则。 |
| 端口被占用 | 本机是否已有其他代理或 sing-box 进程 | 退出重复进程或更换监听端口;修改前备份配置,完成测试后再恢复原设置。 |
| 手机 VPN 反复断开 | 系统 VPN 权限、后台限制、省电策略和配置错误 | 重新授权并允许必要的后台运行;若仍失败,先停用新配置并恢复普通网络。 |
排障时建议一次只改一个变量。例如先确认配置能否通过解析,再确认客户端能否启动,最后确认 DNS、代理连接和网页加载。不要在没有记录原值的情况下长期关闭 Private DNS、防火墙或系统安全能力,也不要把一次成功连接推断为所有节点或所有网络都可用。
配置更新、软件升级与安全下载清单
- 配置更新不等于软件升级:远程订阅刷新只会重新获取配置;客户端升级则是替换软件本身,二者应分开操作。
- 更新前留备份:保存当前可用配置、客户端版本、系统版本和错误日志。更新失败时先恢复旧配置,再判断是配置问题还是软件问题。
- 版本以发布页为准:截至 2026-11-05,本文不把搜索结果中的某个版本号当作长期有效结论;请以当前 Releases 页面显示的稳定版、预发布版和资产文件为准。
- 核对文件架构:Windows 文档列出 x64、x86、arm64,Linux 文档列出 x64、arm64、armv7l;如果不确定,可先在系统信息中确认处理器架构。
- 保护订阅信息:订阅 URL 可能包含身份令牌,不要截图、粘贴到公共 Issue 或发送给陌生人。日志分享前应删除服务器地址、用户名、密码、UUID、订阅链接和访问令牌。
如果你需要手动安装 Linux 软件包,项目的Package Manager 文档列出了 APT、DNF、Homebrew、Scoop、winget 等方式。命令适用范围、仓库地址和权限要求应以该页面当前内容为准,不建议从搜索结果中复制来历不明的一键脚本。
结论:先选客户端,再验证配置,最后定位连接层
sing-box 客户端下载安装的关键不是盲目寻找一个安装包,而是先判断设备、系统版本和 CPU 架构,再区分图形客户端、命令行核心与订阅配置。首次使用时按“下载核验—备份配置—导入—选择出站—授予必要权限—验证 DNS 和网页—保留日志”的顺序操作,出现问题则按下载、解析、启动、连接和 DNS 阶段逐层排查。
如果你拿到的是某个服务提供的订阅地址,相关入口、套餐、链接格式和兼容性以该服务的已核验官方页面或支持渠道为准;本文只说明客户端侧的通用操作,不替任何服务保证节点可用性。
常见问题
sing-box 安装后可以直接使用吗?
不能默认认为可以。客户端只是管理配置和网络权限的工具,首次使用还需要有效的 sing-box JSON、本地配置或客户端支持的远程配置。安装程序本身不会自动提供节点、订阅或可用线路。
Clash YAML 能直接导入 sing-box 吗?
不能一概而论。sing-box 项目文档使用 JSON 配置格式,Clash YAML 与 sing-box JSON 不是同一种格式。请先向配置提供方确认是否有 sing-box 格式或转换方式,不要只修改文件扩展名。
Windows 应该下载 x64、x86 还是 arm64?
按 Windows 系统和处理器架构选择。大多数普通 Intel 或 AMD 64 位电脑使用 x64;32 位系统才考虑 x86;搭载 ARM 处理器的设备选择 arm64。无法确认时先查看系统信息,再对照项目 Releases 页面中的文件名。
导入配置后没有节点怎么办?
先检查远程地址是否返回了配置内容,是否需要登录或已经过期,再确认配置格式和节点组是否为空。不要公开包含令牌的订阅链接;如果配置本身没有节点或出站,需要联系配置提供方确认格式和权限。
启动 sing-box 后网页仍然打不开,应该先改 DNS 吗?
不要一开始同时修改 DNS、MTU 和路由。先确认客户端日志显示已启动,再确认选择了明确的出站,随后分别测试 DNS 解析、代理连接和网页加载;如果新配置导致全局断网,先停止配置并恢复系统原网络。
相关阅读
- 继续看:sing-box 和 Mihomo 配置、订阅与客户端怎么选
- 需要理解 JSON、DNS、规则和 TUN,可参考核心配置教程
- 启动后网页打不开,可按系统代理、DNS 和节点分层排查
- 连接成功后,再学习如何区分延迟、丢包和实际可用性