sing-box 完整入门配置教程:跨平台安装、配置生成与规则分流详解
2026年最新 sing-box 通用客户端图文教程。涵盖 Windows、macOS、Android、iOS 全平台安装,JSON 配置文件语法结构,如何导入机场订阅链接,开启 TUN 虚拟网卡模式及分流规则配置指南。
sing-box 是一款基于 Go 语言开发的新一代全功能通用代理核心客户端,以极致轻量、内存占用极低(<30MB)以及对现代协议(VLESS、Hysteria 2、TUIC、Shadowsocks)原生完整支持而闻名。新手配置 3 步走:1. 从官方 GitHub Releases 或图形客户端下载安装;2. 在机场用户中心复制 sing-box 专用订阅链接并导入生成 config.json;3. 开启 TUN 虚拟网卡模式并设置 Rule 规则分流,即可实现全系统无感智能分流加速。
在当今出海代理客户端生态中,sing-box 凭借其对新兴协议(VLESS、Hysteria 2、TUIC v5)的原生高效实现,以及远低于传统客户端的系统资源开销,正迅速成为高端开发者与技术极客的首选网络核心。
本文将为你提供一份从 0 到 1 的 sing-box 全平台图文配置指南,帮助你快速掌握其架构语法并流畅使用。
一、sing-box 核心技术优势与架构全景
======================== sing-box 架构设计亮点 ========================
[1. 现代协议全覆盖] : 原生支持 VLESS + Reality, Hysteria 2, TUIC, Trojan
[2. 极低内存开销] : 运行时内存常驻仅 20MB - 35MB,启动耗时 < 100ms
[3. 原生全平台 TUN 模式] : 无需第三方复杂驱动,全系统网络层接管无死角
[4. 细粒度规则路由] : 基于 Process Name, Domain, GeoIP, IP-CIDR 毫秒级分流
=====================================================================
二、全平台客户端安装与图形界面推荐
由于 sing-box 官方核心为纯 CLI 命令行程序,普通用户推荐安装集成好的图形客户端:
| 操作系统平台 | 推荐图形客户端 | 获取方式 | 特点与适用场景 |
|---|---|---|---|
| Windows 10/11 | GUI.for.sing-box / Hiddify | GitHub Releases | 界面现代美观,支持一键切换 TUN 模式 |
| macOS (Intel/M系列) | sing-box for Apple / Hiddify | Mac App Store / GitHub | 原生 Swift 编写,耗电极低,无感常驻菜单栏 |
| Android 安卓 | SFA (sing-box for Android) | Google Play / GitHub | 支持分应用代理(Per-app proxy),支持省电策略 |
| iOS 苹果 | sing-box VT / Shadowrocket | App Store (美区/港区) | 完美兼容 TestFlight,支持快速导入 |
三、手把手 4 步导入订阅与配置实操
graph TD
A[获取支持 VLESS 的机场订阅] --> B[导入客户端生成 config.json]
B --> C[配置 inbounds: 开启 TUN 虚拟网卡]
C --> D[配置 route: 国内直连 / 海外走代理]
D --> E[以管理员权限启动核心并验证 IP]
第 1 步:获取标准 sing-box 订阅链接
登录你的机场用户中心(如自营服务商【光速云】),进入“仪表盘” -> “订阅中心”,找到 “sing-box 订阅” 并点击复制。
第 2 步:基础 config.json 核心结构解析
标准的 sing-box 配置包含以下 5 大核心模块:
{
"log": {
"level": "info",
"timestamp": true
},
"dns": {
"servers": [
{ "tag": "dns_proxy", "address": "https://1.1.1.1/dns-query", "detour": "proxy" },
{ "tag": "dns_direct", "address": "223.5.5.5", "detour": "direct" }
]
},
"inbounds": [
{
"type": "tun",
"tag": "tun-in",
"interface_name": "singbox-tun",
"inet4_address": "172.19.0.1/30",
"auto_route": true,
"strict_route": true,
"stack": "mixed",
"sniff": true
}
],
"outbounds": [
{ "type": "selector", "tag": "proxy", "outbounds": ["香港 IEPL 01", "日本东京 02", "auto"] },
{ "type": "urltest", "tag": "auto", "outbounds": ["香港 IEPL 01", "日本东京 02"], "url": "https://www.gstatic.com/generate_204", "interval": "3m" },
{ "type": "direct", "tag": "direct" },
{ "type": "block", "tag": "block" }
],
"route": {
"rules": [
{ "protocol": "dns", "outbound": "dns_proxy" },
{ "geosite": "cn", "outbound": "direct" },
{ "geoip": "cn", "outbound": "direct" },
{ "geosite": "openai", "outbound": "proxy" }
],
"auto_detect_interface": true
}
}
第 3 步:开启 TUN 模式与权限配置
- Windows 用户:右键点击客户端图标,选择 “以管理员身份运行”,确保虚拟网卡驱动能够成功挂载;
- macOS 用户:首次启动时系统会弹出提示,在“系统设置 -> 隐私与安全性 -> 扩展”中允许 sing-box 载入系统扩展。
第 4 步:验证分流与连通性
打开浏览器访问国内网站(如 baidu.com)与海外网站(如 google.com),确认国内流量显示本地真实 IP,海外流量由专线节点接管。
四、常见报错诊断与解决方案
| 常见报错现象 | 根本原因定位 | 标准化修复动作 |
|---|---|---|
bind: address already in use | 7890 或 1080 端口已被其他代理软件占用 | 关闭冲突的 Clash/v2rayN,或在配置中修改混合监听端口为 10808 |
create tun interface: permission denied | 缺乏系统底层虚拟网卡创建权限 | 必须以管理员权限(sudo / Run as Administrator)启动 |
dial tcp: lookup failed: dns timeout | 上游 DNS 无法解析域名 | 将 DNS 配置中的 dns_direct 换为国内运营商默认 DNS 或 223.5.5.5 |
五、优质专线节点与客户端完美搭配推荐
sing-box 能够将现代 VLESS 专线协议的性能发挥到极致,搭配自营推荐服务体验更佳:
- 服务商:光速云(GuangSu Cloud)
- 协议深度优化:100% 支持 VLESS 企业级专线 与 AnyTLS 智能握手,针对 sing-box 核心深度调优。
- 新人特惠:注册结账输入 8 折优惠码【
AMM】,年付折合约 ¥7.5 元/月。
👉 点击进入光速云官网一键获取 sing-box 订阅
(自营合作推荐,支持支付宝/微信即时开通,支持 7×24H 技术响应)
六、下一步阅读推荐
- 如果你使用的是苹果 iOS 平台,请参考 《Shadowrocket (小火箭) 苹果 iOS 配置教程》;
- 如果你更喜欢图形化界面成熟的桌面工具,请查看 《Clash Verge Rev 完整配置教程》;
- 遇到节点全部超时问题?请阅读 《节点全部超时与订阅更新失败排查》。
需要稳定不卡顿的专线节点?推荐体验光速云
针对 ChatGPT-4o / Claude 3.5 / 流媒体 4K 访问深度优化,全节点 IEPL 纯物理专线中转,全平台客户端极速一键导入。