sing-box 使用教程:全平台安装、订阅导入与新协议支持

教程 · 发布 2026-11-05 · 更新 2026-11-05 · 约 3304 字 · 8 分钟

sing-box 是近几年增长最快的代理内核,新协议几乎都先在它上面落地:AnyTLS、Hysteria2、TUIC、VLESS Reality、ShadowTLS。它有各平台官方客户端,也有 Hiddify 这样的图形封装,还是 Apple TV 上少数可用的免费客户端。对大多数用户来说,Clash 系客户端仍然够用,只有机场明确提供 sing-box 订阅、或订阅里包含 Clash 不支持的新协议、或要在 tvOS 上用时,才需要换到 sing-box。

什么时候需要 sing-box

  • 机场用户中心有「sing-box 订阅」按钮。
  • 节点协议是 AnyTLS、TUIC 或 ShadowTLS。
  • iPhone 想用免费客户端且不介意配置偏技术。
  • 需要 Windows、macOS、Android、iOS、tvOS 统一一套配置。
  • 软路由内存小,想要比 OpenClash 更省资源的方案。

本站收录的 17 家机场品牌资料里协议多为 VLESS 或未注明,Clash 系客户端都能处理。协议科普见 机场协议区别 和 AnyTLS 是什么。

各平台安装

平台获取方式说明
iOS / iPadOS / tvOSApp Store 搜索 sing-box美区可下载,免费,需非国区账号
AndroidGitHub SagerNet/sing-box Releases 的 APK,或 Google Play选 arm64-v8a
Windows / macOS / LinuxGitHub Releases 的命令行二进制没有官方图形界面,桌面用 Hiddify
全平台图形界面Hiddify:GitHub hiddify/hiddify-app封装 sing-box,适合不碰配置的人

非国区账号注册见 美区 Apple ID 教程。

三种订阅格式在 sing-box 里的差异

订阅格式官方客户端Hiddify
sing-box 订阅(JSON)直接导入直接导入
Clash 订阅(YAML)不能,需 订阅转换自动转换
通用订阅(Base64)不能,需转换自动转换

这是 Hiddify 最大的便利:它内置转换,什么格式都能吃。格式区别见 订阅链接说明。

导入订阅:分步骤

官方客户端(iOS / Android):

  1. 打开 sing-box → 底部「Profiles」→ 右上角「+」。
  2. 类型选「Remote」,Name 填机场名,URL 粘贴 sing-box 订阅链接,Auto Update 打开并设间隔。
  3. 点「Create」。预期:Profiles 列表出现该项,右侧显示最近更新时间。
  4. 回到「Dashboard」,确认 Profile 已选中,打开顶部开关,首次允许 VPN 配置。预期:状态变为 Started,「Groups」里能看到策略组和节点。
  5. 打开浏览器验证。

Hiddify:

  1. 首页「+」→「从剪贴板添加」(提前复制任意格式的订阅链接)。
  2. 预期:首页出现一张配置卡片,显示流量和到期。
  3. 点中间的大按钮连接。预期:按钮变色,显示延迟。
  4. 「代理」页选节点。

没有订阅先看 机场推荐排行榜。

设置项逐项说明

官方客户端「Settings」:

  • Profile Auto Update:订阅更新间隔,建议 24 小时。
  • Always On / On Demand:按需连接,有网络请求时自动启动。
  • Include All Networks:让所有网络接口的流量都走 sing-box,开了 TUN 后一般打开。
  • Exclude APNs:排除苹果推送流量,避免推送延迟。
  • Log Level:排障时调 debug。

Hiddify「设置」:

  • 服务模式:VPN(整机)、系统代理(仅浏览器等)、TUN。手机用 VPN,桌面用系统代理或 TUN。
  • 路由规则:「绕过中国」默认打开,国内直连。
  • DNS:远程 DNS 默认 Cloudflare,可以改。
  • 分应用代理(Android):选择哪些 App 走代理。
  • 自动测速选节点:开启后用 url-test 组。

配置文件结构(命令行用户)

sing-box 用 JSON,核心四段:

  • inbounds:本地入口,桌面常用 mixed(HTTP + SOCKS 混合)或 tun。
  • outbounds:节点列表和策略组(selector、urltest)。
  • route:分流规则,配合 rule_set 远程规则集实现国内直连。
  • dns:建议国内域名走国内 DNS,其余走 DoH。

运行:sing-box run -c config.json。检查配置:sing-box check -c config.json。订阅提供的 JSON 一般已经包含完整四段,直接用即可;需要改规则时只动 route.rules。

与 Clash 的取舍

对比sing-boxClash(mihomo)
新协议支持最快稍慢,但主流都有
配置格式JSON,偏技术YAML,机场订阅直接给
图形客户端官方简洁,Hiddify 友好Clash Verge / Meta / Mi 成熟
规则生态rule_set规则集丰富,教程多
内存占用更低略高
tvOS有无

新手仍然建议 Clash 系,见 翻墙工具汇总。

常见报错表

症状原因处理
导入提示 parse config 失败粘贴了 Clash 或通用订阅换 sing-box 订阅或用 Hiddify
启动报 rule_set 下载失败规则集托管在 GitHub,首次需网络先用可用节点开代理再启动,或改本地规则集
Hysteria2 节点连不上网络限制 UDP换 TCP 协议节点;见 Hysteria2 是什么
开关打开但没流量未选中 Profile 或策略组选了不可用节点Dashboard 检查 Profile,Groups 换节点
网页打不开但延迟正常DNS改 DNS 为 DoH
tvOS 输入不了 URL遥控器用 iPhone 键盘或 iCloud 同步配置
版本不支持某协议App 旧更新 App

常见问题

机场只给 Clash 订阅,sing-box 能用吗?

Hiddify 可以自动转换;官方客户端需要先转换。

iOS 的 sing-box 和 Clash Mi 选哪个?

有 sing-box 订阅选 sing-box;只有 Clash 订阅选 Clash Mi。两者都免费,都需要非国区账号。

Apple TV 能用吗?

可以,tvOS 版在 App Store。配置方法见 Apple TV 教程。

怎么判断是客户端问题还是机场问题?

同一订阅换一个客户端试;都不行就是机场,按 排查步骤 处理。

软路由能用 sing-box 吗?

可以,OpenWrt 有 sing-box 包和 luci 插件,内存占用比 OpenClash 低。见 软路由教程。

多设备配置怎么同步?

iOS / macOS / tvOS 官方客户端支持 iCloud 同步 Profile;Android 和桌面各自导入。设备数限制见 多设备共用说明。

sing-box 晚上特别慢?

线路问题,见 晚高峰慢怎么办。

选好客户端后,到 机场品牌库 按协议筛选机场。