ByWave官网 - 高端IPLC专线机场返回首页

sing-box 客户端下载与使用:先选对平台,再导入配置

更新于 2026-11-05 · bywave.buzz

简答:先按设备选择图形客户端: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/11sing-box for Desktop项目文档列出 x64、x86、arm64,按 Windows 系统和处理器架构选择安装包。
Linuxsing-box for Desktop 或命令行核心桌面端文档列出 x64、arm64、armv7l;服务器或无桌面环境再考虑软件包或核心程序。
macOSsing-box for Apple platformsApple 平台页面列出 macOS 13.0 及以上要求;Standalone 版本与 App Store 版本的功能路径可能不同。
Androidsing-box for Android图形客户端通过 Android VpnService 提供非 Root 的 TUN 能力,首次启动通常需要确认 VPN 权限。
iPhone/iPadsing-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

如果你使用的是图形客户端,则以当前界面提供的导入、校验和日志功能为准,不要把命令行参数直接填入图形客户端输入框。

各平台安装与首次连接:按这个最小闭环操作

  1. 下载安装包。Windows 和 Linux 从项目桌面端页面进入 Releases;Android 和 Apple 设备优先查看项目客户端页面列出的商店或测试渠道。下载后核对平台、架构和文件类型,遇到来源不明的二次打包文件不要直接运行。
  2. 先备份或新建配置。不要一开始就覆盖原配置。为测试单独建立一个配置条目,远程配置先记录名称和更新时间,本地 JSON 先复制一份。
  3. 导入配置。选择本地 JSON、远程配置或客户端支持的分享方式。导入后先查看配置名称、服务器字段、出站或节点组是否为空。
  4. 选择出站或节点组。如果配置包含 Selector、URLTest 或其他节点组,先选择一个明确的出站;如果默认出站为空,连接可能启动但没有可用路径。
  5. 启动权限。Windows、macOS 和 Linux 可能需要系统代理、TUN 或网络扩展权限;Android 和 iOS 通常需要确认系统 VPN 权限。只授予客户端正常工作所需的权限,不要为了排障长期关闭系统安全功能。
  6. 做三层验证。先看客户端日志是否显示服务启动,再确认 DNS 是否能解析目标域名,最后用浏览器或业务应用加载页面。延迟有返回不等于网页一定可用,因此不要只凭一个延迟数字判断节点成功。
  7. 记录结果并回滚。若启动后无网络,立即停止配置并切回系统原有网络;保留错误日志、配置名称和发生时间,再进入故障分流。

桌面端的定位是管理本地或远程 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 解析、代理连接和网页加载;如果新配置导致全局断网,先停止配置并恢复系统原网络。

相关阅读

参考资料

  1. Graphical Clients - sing-box
  2. sing-box for Desktop - sing-box
  3. sing-box for Apple platforms - sing-box
  4. Android 客户端功能说明 - sing-box
  5. Configuration Introduction - sing-box
  6. Package Manager - sing-box
  7. Releases - SagerNet/sing-box