sing-box 全平台使用教程：新一代通用代理平台配置指南

sing-box 是 2026 年最值得关注的新一代通用代理平台。随着 Clash 原版删库停更、Clash Meta（Mihomo）转向收费，sing-box 凭借更广的协议支持、更灵活的路由规则和更低的资源占用，正在成为代理工具的首选。

本文从配置文件结构、多协议支持、路由分流、DNS 防污染到全平台安装使用，手把手带你从零配置 sing-box。

还没有机场订阅？先看这里：

2026 高性价比机场推荐汇总，长期更新

已有 Clash？→ Clash Verge Rev 进阶配置指南

iOS 用户？→ Shadowrocket 小火箭教程

1. sing-box 是什么？为什么要用它？#

1.1 sing-box 简介#

sing-box 是由 SagerNet 开发的新一代通用代理平台，用 Go 语言编写，目标是成为「代理工具的瑞士军刀」。它不是一个单纯的客户端，而是一个代理平台框架——你可以把它当作内核（Core），在上面运行各种图形界面客户端。

核心特点：

特点	说明
多协议支持	Shadowsocks、VMess、VLESS、Trojan、Hysteria 2、ShadowTLS、TUIC 等
灵活路由	支持规则集（rule_set）、DNS 规则独立分流、多出站链式组合
高性能	Go 语言编写，内存占用低，连接处理快
全平台	Windows / macOS / Linux / iOS / Android 全覆盖
活跃维护	2026 年持续更新，社区活跃

1.2 sing-box vs Clash：核心区别#

很多用户从 Clash 转到 sing-box，两者的关键区别：

对比项	Clash / Clash Meta	sing-box
配置格式	YAML	JSON
协议支持	Shadowsocks/VMess/VLESS/Trojan + 插件扩展	原生支持全部主流协议，包括 Hysteria2
Hysteria2	仅 Clash Meta 通过插件支持	原生支持，性能最佳
ShadowTLS	不支持	原生支持 v3
DNS 功能	基础 DNS + 简单分流	DNS 规则独立配置，支持 DNS 规则集
路由规则	Rule Provider 规则集	rule_set 规则集 + DNS 规则分流
出站组合	relay 链式代理	支持链式组合、UDP over TCP 等
维护状态	Clash 原版已停更，Meta 活跃	活跃维护，持续更新
内存占用	50-80 MB	20-40 MB

什么时候选 sing-box：

需要 Hysteria2 / ShadowTLS 等新协议
需要更精细的 DNS 分流控制
追求更低内存占用
机场已提供 sing-box 订阅格式

什么时候继续用 Clash：

习惯 Clash Verge Rev 的图形界面，不想换
机场仅提供 Clash 订阅
只需要基础代理功能，Clash 够用

2. 配置文件结构详解#

sing-box 使用 JSON 格式配置文件，这是与 Clash YAML 的最大区别。别怕——JSON 配置其实更严谨，不容易出格式错误。

2.1 配置文件整体结构#

一个完整的 sing-box 配置文件包含以下 7 个顶级字段：

1
{
2
  "log": {},       // 日志配置
3
  "dns": {},       // DNS 配置
4
  "inbounds": [],  // 入站配置（代理模式）
5
  "outbounds": [], // 出站配置（代理节点）
6
  "route": {},     // 路由分流规则
7
  "experimental": {} // 宂验功能（缓存等）
8
}

每个字段的作用：

1
┌─────────────────────────────────────────────┐
2
│              sing-box 配置结构               │
3
├─────────────────────────────────────────────┤
4
│                                             │
5
│  log        → 日志级别、输出路径             │
6
│  dns        → DNS 服务器 + DNS 规则分流      │
7
│  inbounds   → 本地接收流量（mixed/tun/direct）│
8
│  outbounds  → 远程节点（ss/vmess/vless/…）   │
9
│  route      → 流量分流规则 + rule_set        │
10
│  experimental → 缓存/Clash API等实验功能     │
11
│                                             │
12
├─────────────────────────────────────────────┤
13
│  流量路径：                                  │
14
│  App → inbound → route → outbound → 目标    │
15
│        ↑          ↑         ↑               │
16
│     接收流量   分流决策   代理转发            │
17
└─────────────────────────────────────────────┘

2.2 log 日志配置#

1
{
2
  "log": {
3
    "level": "info",
4
    "timestamp": true
5
  }
6
}

日志级别可选值：

trace：最详细，调试用
debug：开发调试
info：正常运行（推荐）
warn：仅警告和错误
error：仅错误
fatal：仅致命错误
silent：不输出日志

2.3 dns DNS 配置#

sing-box 的 DNS 配置比 Clash 更强大，支持独立 DNS 规则分流：

1
{
2
  "dns": {
3
    "servers": [
4
      {
5
        "tag": "dns-direct",
6
        "address": "223.5.5.5",
7
        "detour": "direct-out"
8
      },
9
      {
10
        "tag": "dns-remote",
11
        "address": "tls://8.8.8.8",
12
        "detour": "proxy-out"
13
      },
14
      {
15
        "tag": "dns-block",
16
        "address": "rcode://success"
17
      }
18
    ],
19
    "rules": [
20
      {
21
        "outbound": ["any"],
22
        "server": "dns-direct"
23
      },
24
      {
25
        "rule_set": ["geosite-cn"],
26
        "server": "dns-direct"
27
      },
28
      {
29
        "rule_set": ["geosite-geolocation-!cn"],
30
        "server": "dns-remote"
31
      },
32
      {
33
        "rule_set": ["geosite-category-ads-all"],
34
        "server": "dns-block"
35
      }
36
    ],
37
    "final": "dns-remote",
38
    "strategy": "prefer_ipv4"
39
  }
40
}

关键概念：

servers：定义 DNS 服务器，每个有 tag 标签
detour：指定 DNS 请求走哪个出站（国内 DNS 走直连，国外 DNS 赫代理）
rules：DNS 规则分流——国内域名用国内 DNS 解析，国外域名用国外 DNS
rcode://success：直接返回空结果（用于广告拦截）
strategy：IP 解析策略，prefer_ipv4 优先 IPv4（避免 IPv6 连不上）

3. inbound 入站配置#

入站（inbound）决定 sing-box 如何在本地接收流量。常用的入站类型：

3.1 mixed 入站（系统代理模式）#

最基础的入站，提供 HTTP + SOCKS5 混合代理：

1
{
2
  "inbounds": [
3
    {
4
      "type": "mixed",
5
      "tag": "mixed-in",
6
      "listen": "127.0.0.1",
7
      "listen_port": 7890
8
    }
9
  ]
10
}

设置后，浏览器/应用设置代理为 127.0.0.1:7890 即可使用。

3.2 tun 入站（全局代理模式）#

TUN 模式在系统层创建虚拟网卡，接管所有流量——真正的全局代理：

1
{
2
  "inbounds": [
3
    {
4
      "type": "tun",
5
      "tag": "tun-in",
6
      "inet4_address": "172.19.0.1/30",
7
      "auto_route": true,
8
      "strict_route": true,
9
      "stack": "mixed",
10
      "sniff": true,
11
      "sniff_override_destination": false
12
    }
13
  ]
14
}

参数说明：

inet4_address：虚拟网卡 IP（可自定义，不要和真实网卡冲突）
auto_route：自动配置路由表（接管全局流量）
strict_route：严格路由（防止流量泄漏）
stack：网络栈，mixed 推荐（兼顾性能和兼容性）
sniff：嗅探协议类型（识别 HTTP/TLS 等流量特征）
sniff_override_destination：是否用嗅探结果覆盖目标地址

macOS / Linux 需要管理员权限运行 TUN 模式！

3.3 direct 入站#

用于接收需要直连的流量（比如局域网服务）：

1
{
2
  "type": "direct",
3
  "tag": "direct-in",
4
  "listen": "127.0.0.1",
5
  "listen_port": 7891
6
}

3.4 完整入站配置（混合模式）#

实际使用中通常同时配置 mixed + tun：

1
{
2
  "inbounds": [
3
    {
4
      "type": "mixed",
5
      "tag": "mixed-in",
6
      "listen": "127.0.0.1",
7
      "listen_port": 7890,
8
      "sniff": true,
9
      "sniff_override_destination": false
10
    },
11
    {
12
      "type": "tun",
13
      "tag": "tun-in",
14
      "inet4_address": "172.19.0.1/30",
15
      "inet6_address": "fdfe:dcba:9876::1/126",
16
      "auto_route": true,
17
      "strict_route": true,
18
      "stack": "mixed",
19
      "sniff": true,
20
      "sniff_override_destination": false
21
    }
22
  ]
23
}

4. outbound 出站配置（代理节点）#

出站（outbound）就是代理节点配置。sing-box 支持的主流协议：

4.1 direct 直连出站#

不走代理，直接连接：

1
{
2
  "type": "direct",
3
  "tag": "direct-out"
4
}

4.2 block 拦截出站#

直接拒绝连接（用于广告拦截）：

1
{
2
  "type": "block",
3
  "tag": "block-out"
4
}

4.3 dns DNS 出站#

用于 DNS 查询的出站：

1
{
2
  "type": "dns",
3
  "tag": "dns-out"
4
}

4.4 Shadowsocks#

1
{
2
  "type": "shadowsocks",
3
  "tag": "ss-out",
4
  "server": "your-server.com",
5
  "server_port": 8388,
6
  "method": "aes-256-gcm",
7
  "password": "your-password"
8
}

支持的方法：aes-256-gcm、aes-128-gcm、chacha20-ietf-poly1305、2022-blake3-aes-256-gcm 等。

4.5 VMess（V2Ray）#

1
{
2
  "type": "vmess",
3
  "tag": "vmess-out",
4
  "server": "your-server.com",
5
  "server_port": 443,
6
  "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
7
  "security": "auto",
8
  "alter_id": 0,
9
  "transport": {
10
    "type": "ws",
11
    "path": "/ws-path",
12
    "headers": {
13
      "Host": "your-domain.com"
14
    }
15
  },
16
  "tls": {
17
    "enabled": true,
18
    "server_name": "your-domain.com"
19
  }
20
}

4.6 VLESS#

1
{
2
  "type": "vless",
3
  "tag": "vless-out",
4
  "server": "your-server.com",
5
  "server_port": 443,
6
  "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
7
  "flow": "xtls-rprx-vision",
8
  "tls": {
9
    "enabled": true,
10
    "server_name": "your-domain.com",
11
    "utls": {
12
      "enabled": true,
13
      "fingerprint": "chrome"
14
    }
15
  }
16
}

VLESS + XTLS Vision 是当前最高效的协议组合，比 VMess + WS 性能更好。

4.7 Trojan#

1
{
2
  "type": "trojan",
3
  "tag": "trojan-out",
4
  "server": "your-server.com",
5
  "server_port": 443,
6
  "password": "your-trojan-password",
7
  "tls": {
8
    "enabled": true,
9
    "server_name": "your-domain.com"
10
  }
11
}

4.8 Hysteria2（重点推荐）#

Hysteria2 是基于 QUIC 协议的新一代代理协议，速度极快，尤其适合高延迟网络：

1
{
2
  "type": "hysteria2",
3
  "tag": "hy2-out",
4
  "server": "your-server.com",
5
  "server_port": 443,
6
  "password": "your-hy2-password",
7
  "tls": {
8
    "enabled": true,
9
    "server_name": "your-domain.com",
10
    "insecure": false
11
  },
12
  "up": "50 Mbps",
13
  "down": "100 Mbps"
14
}

参数说明：

up / down：带宽限制（可选，帮助服务端分配资源）
Hysteria2 基于 QUIC，天然支持多路复用，比 TCP 协议更快
在跨洲线路（如中美）上效果尤为显著

4.9 ShadowTLS v3#

ShadowTLS 用于伪装 TLS 流量，绕过 SNI 检测：

1
{
2
  "type": "shadowtls",
3
  "tag": "stls-out",
4
  "server": "your-server.com",
5
  "server_port": 443,
6
  "version": 3,
7
  "password": "your-shadowtls-password",
8
  "tls": {
9
    "enabled": true,
10
    "server_name": "www.microsoft.com"
11
  },
12
  "detour": "ss-inner-out"
13
}

ShadowTLS 需要配合内部代理（如 Shadowsocks），通过 detour 指定内部代理出站：

1
{
2
  "type": "shadowsocks",
3
  "tag": "ss-inner-out",
4
  "method": "2022-blake3-aes-128-gcm",
5
  "password": "inner-password"
6
}

4.10 Selector 选择器出站（类似 Clash 的 Proxy Group）#

sing-box 通过 selector 类型实现节点分组切换：

1
{
2
  "type": "selector",
3
  "tag": "proxy-out",
4
  "outbounds": [
5
    "hy2-out",
6
    "vless-out",
7
    "vmess-out",
8
    "trojan-out",
9
    "ss-out",
10
    "auto-select"
11
  ],
12
  "default": "hy2-out"
13
}

4.11 URLTest 自动选择出站#

自动测速选择最优节点：

1
{
2
  "type": "urltest",
3
  "tag": "auto-select",
4
  "outbounds": [
5
    "hy2-out",
6
    "vless-out",
7
    "vmess-out",
8
    "trojan-out",
9
    "ss-out"
10
  ],
11
  "url": "https://www.gstatic.com/generate_204",
12
  "interval": "5m",
13
  "tolerance": 50
14
}

参数说明：

url：测速目标 URL
interval：测速间隔（5m = 每 5 分钟测一次）
tolerance：延迟容差（ms），新节点比当前节点快超过此值才切换

5. route 路由分流配置#

路由规则决定哪些流量走代理、哪些直连、哪些拦截。sing-box 的路由比 Clash 更灵活。

5.1 路由规则基础#

1
{
2
  "route": {
3
    "rules": [
4
      // 规则按顺序匹配，先匹配到的生效
5
      {
6
        "protocol": "dns",
7
        "outbound": "dns-out"
8
      },
9
      {
10
        "ip_is_private": true,
11
        "outbound": "direct-out"
12
      },
13
      {
14
        "type": "logical",
15
        "mode": "or",
16
        "rules": [
17
          { "port": [80, 443] },
18
          { "network": "tcp" }
19
        ],
20
        "outbound": "proxy-out"
21
      }
22
    ],
23
    "final": "proxy-out",
24
    "find_process_mode": "strict"
25
  }
26
}

路由规则匹配顺序：从上到下逐条匹配，匹配成功即停止。最后 final 是兜底规则。

5.2 常用规则类型#

规则类型	字段	示例
域名匹配	`domain`	`["google.com", "youtube.com"]`
域名后缀	`domain_suffix`	`[".google.com", ".youtube.com"]`
域名关键词	`domain_keyword`	`["google", "netflix"]`
域名正则	`domain_regex`	`["^.*\\.google\\.com$"]`
IP CIDR	`ip_cidr`	`["10.0.0.0/24", "192.168.0.0/16"]`
GeoIP	`geoip`	`["cn"]`
GeoSite	`geosite`	`["cn", "google", "netflix"]`
进程名	`process_name`	`["chrome", "telegram"]`
端口	`port`	`[80, 443, 8080]`
网络	`network`	`"tcp"` / `"udp"`
协议	`protocol`	`"dns"` / `"http"` / `"tls"`
规则集	`rule_set`	`["geosite-cn", "geoip-cn"]`

5.3 rule_set 规则集（核心功能）#

rule_set 类似 Clash 的 Rule Provider，从远程加载预定义规则集：

1
{
2
  "route": {
3
    "rule_set": [
4
      {
5
        "tag": "geosite-cn",
6
        "type": "remote",
7
        "format": "binary",
8
        "url": "https://raw.githubusercontent.com/SagerNet/sing-geoosite/rule-set/geosite-cn.srs",
9
        "download_detour": "proxy-out"
10
      },
11
      {
12
        "tag": "geoip-cn",
13
        "type": "remote",
14
        "format": "binary",
15
        "url": "https://raw.githubusercontent.com/SagerNet/sing-geoip/rule-set/geoip-cn.srs",
16
        "download_detour": "proxy-out"
17
      },
18
      {
19
        "tag": "geosite-category-ads-all",
20
        "type": "remote",
21
        "format": "binary",
22
        "url": "https://raw.githubusercontent.com/SagerNet/sing-geoosite/rule-set/geosite-category-ads-all.srs",
23
        "download_detour": "proxy-out"
24
      },
25
      {
26
        "tag": "geosite-geolocation-!cn",
27
        "type": "remote",
28
        "format": "binary",
29
        "url": "https://raw.githubusercontent.com/SagerNet/sing-geoosite/rule-set/geosite-geolocation-!cn.srs",
30
        "download_detour": "proxy-out"
31
      }
32
    ],
33
    "rules": [
34
      {
35
        "protocol": "dns",
36
        "outbound": "dns-out"
37
      },
38
      {
39
        "ip_is_private": true,
40
        "outbound": "direct-out"
41
      },
42
      {
43
        "rule_set": ["geosite-category-ads-all"],
44
        "outbound": "block-out"
45
      },
46
      {
47
        "rule_set": ["geosite-cn", "geoip-cn"],
48
        "outbound": "direct-out"
49
      },
50
      {
51
        "rule_set": ["geosite-geolocation-!cn"],
52
        "outbound": "proxy-out"
53
      }
54
    ],
55
    "final": "proxy-out"
56
  }
57
}

rule_set 格式说明：

format: "binary"：二进制格式（.srs），解析快、体积小（推荐）
format: "source"：源码格式（JSON），体积大但可读
download_detour：下载规则集走哪个出站（必须走代理，因为 GitHub 在国内被墙）

官方规则集仓库：

GeoSite: https://github.com/SagerNet/sing-geoosite
GeoIP: https://github.com/SagerNet/sing-geoip

5.4 logical 逻辑组合规则#

sing-box 支持逻辑组合规则（Clash 没有），可以组合多个条件：

1
{
2
  "type": "logical",
3
  "mode": "and",
4
  "rules": [
5
    { "port": [80, 443] },
6
    { "network": "tcp" },
7
    { "process_name": ["chrome", "firefox"] }
8
  ],
9
  "outbound": "proxy-out"
10
}

mode: "and"：所有条件都满足才匹配
mode: "or"：任一条件满足就匹配

6. experimental 实验功能#

6.1 Clash API（兼容 Clash 控制面板）#

sing-box 可以开启 Clash API，让你用 Clash 的 Web UI（如 Metacubexd/Yacd）管理 sing-box：

1
{
2
  "experimental": {
3
    "clash_api": {
4
      "external_controller": "127.0.0.1:9090",
5
      "external_ui": "ui",
6
      "external_ui_download_detour": "proxy-out",
7
      "secret": "your-secret"
8
    },
9
    "cache_file": {
10
      "enabled": true,
11
      "path": "cache.db",
12
      "store_fake_ip": true
13
    }
14
  }
15
}

参数说明：

external_controller：API 监听地址
external_ui：Web UI 目录路径
secret：API 访问密钥（安全）
cache_file：缓存文件，存储节点信息和 Fake IP

6.2 V2Ray API#

1
{
2
  "experimental": {
3
    "v2ray_api": {
4
      "listen": "127.0.0.1:10085"
5
    }
6
  }
7
}

7. 完整配置模板#

把以上所有部分组合，得到完整配置模板：

1
{
2
  "log": {
3
    "level": "info",
4
    "timestamp": true
5
  },
6
  "dns": {
7
    "servers": [
8
      {
9
        "tag": "dns-direct",
10
        "address": "223.5.5.5",
11
        "detour": "direct-out"
12
      },
13
      {
14
        "tag": "dns-remote",
15
        "address": "tls://8.8.8.8",
16
        "detour": "proxy-out"
17
      },
18
      {
19
        "tag": "dns-block",
20
        "address": "rcode://success"
21
      }
22
    ],
23
    "rules": [
24
      {
25
        "outbound": ["any"],
26
        "server": "dns-direct"
27
      },
28
      {
29
        "rule_set": ["geosite-cn"],
30
        "server": "dns-direct"
31
      },
32
      {
33
        "rule_set": ["geosite-category-ads-all"],
34
        "server": "dns-block"
35
      }
36
    ],
37
    "final": "dns-remote",
38
    "strategy": "prefer_ipv4",
39
    "independent_cache": true
40
  },
41
  "inbounds": [
42
    {
43
      "type": "mixed",
44
      "tag": "mixed-in",
45
      "listen": "127.0.0.1",
46
      "listen_port": 7890,
47
      "sniff": true,
48
      "sniff_override_destination": false
49
    },
50
    {
51
      "type": "tun",
52
      "tag": "tun-in",
53
      "inet4_address": "172.19.0.1/30",
54
      "auto_route": true,
55
      "strict_route": true,
56
      "stack": "mixed",
57
      "sniff": true,
58
      "sniff_override_destination": false
59
    }
60
  ],
61
  "outbounds": [
62
    {
63
      "type": "selector",
64
      "tag": "proxy-out",
65
      "outbounds": [
66
        "auto-select",
67
        "hy2-out",
68
        "vless-out",
69
        "vmess-out",
70
        "trojan-out",
71
        "ss-out",
72
        "direct-out"
73
      ],
74
      "default": "auto-select"
75
    },
76
    {
77
      "type": "urltest",
78
      "tag": "auto-select",
79
      "outbounds": [
80
        "hy2-out",
81
        "vless-out",
82
        "vmess-out",
83
        "trojan-out",
84
        "ss-out"
85
      ],
86
      "url": "https://www.gstatic.com/generate_204",
87
      "interval": "5m",
88
      "tolerance": 50
89
    },
90
    {
91
      "type": "hysteria2",
92
      "tag": "hy2-out",
93
      "server": "hy2.example.com",
94
      "server_port": 443,
95
      "password": "hy2-password",
96
      "tls": {
97
        "enabled": true,
98
        "server_name": "hy2.example.com"
99
      }
100
    },
101
    {
102
      "type": "vless",
103
      "tag": "vless-out",
104
      "server": "vless.example.com",
105
      "server_port": 443,
106
      "uuid": "uuid-here",
107
      "flow": "xtls-rprx-vision",
108
      "tls": {
109
        "enabled": true,
110
        "server_name": "vless.example.com",
111
        "utls": {
112
          "enabled": true,
113
          "fingerprint": "chrome"
114
        }
115
      }
116
    },
117
    {
118
      "type": "vmess",
119
      "tag": "vmess-out",
120
      "server": "vmess.example.com",
121
      "server_port": 443,
122
      "uuid": "uuid-here",
123
      "security": "auto",
124
      "alter_id": 0,
125
      "transport": {
126
        "type": "ws",
127
        "path": "/ws"
128
      },
129
      "tls": {
130
        "enabled": true,
131
        "server_name": "vmess.example.com"
132
      }
133
    },
134
    {
135
      "type": "trojan",
136
      "tag": "trojan-out",
137
      "server": "trojan.example.com",
138
      "server_port": 443,
139
      "password": "trojan-password",
140
      "tls": {
141
        "enabled": true,
142
        "server_name": "trojan.example.com"
143
      }
144
    },
145
    {
146
      "type": "shadowsocks",
147
      "tag": "ss-out",
148
      "server": "ss.example.com",
149
      "server_port": 8388,
150
      "method": "aes-256-gcm",
151
      "password": "ss-password"
152
    },
153
    {
154
      "type": "direct",
155
      "tag": "direct-out"
156
    },
157
    {
158
      "type": "block",
159
      "tag": "block-out"
160
    },
161
    {
162
      "type": "dns",
163
      "tag": "dns-out"
164
    }
165
  ],
166
  "route": {
167
    "rule_set": [
168
      {
169
        "tag": "geosite-cn",
170
        "type": "remote",
171
        "format": "binary",
172
        "url": "https://raw.githubusercontent.com/SagerNet/sing-geoosite/rule-set/geosite-cn.srs",
173
        "download_detour": "proxy-out"
174
      },
175
      {
176
        "tag": "geoip-cn",
177
        "type": "remote",
178
        "format": "binary",
179
        "url": "https://raw.githubusercontent.com/SagerNet/sing-geoip/rule-set/geoip-cn.srs",
180
        "download_detour": "proxy-out"
181
      },
182
      {
183
        "tag": "geosite-category-ads-all",
184
        "type": "remote",
185
        "format": "binary",
186
        "url": "https://raw.githubusercontent.com/SagerNet/sing-geoosite/rule-set/geosite-category-ads-all.srs",
187
        "download_detour": "proxy-out"
188
      },
189
      {
190
        "tag": "geosite-geolocation-!cn",
191
        "type": "remote",
192
        "format": "binary",
193
        "url": "https://raw.githubusercontent.com/SagerNet/sing-geoosite/rule-set/geosite-geolocation-!cn.srs",
194
        "download_detour": "proxy-out"
195
      }
196
    ],
197
    "rules": [
198
      {
199
        "protocol": "dns",
200
        "outbound": "dns-out"
201
      },
202
      {
203
        "ip_is_private": true,
204
        "outbound": "direct-out"
205
      },
206
      {
207
        "rule_set": ["geosite-category-ads-all"],
208
        "outbound": "block-out"
209
      },
210
      {
211
        "rule_set": ["geosite-cn", "geoip-cn"],
212
        "outbound": "direct-out"
213
      },
214
      {
215
        "rule_set": ["geosite-geolocation-!cn"],
216
        "outbound": "proxy-out"
217
      }
218
    ],
219
    "final": "proxy-out",
220
    "auto_detect_interface": true
221
  },
222
  "experimental": {
223
    "clash_api": {
224
      "external_controller": "127.0.0.1:9090",
225
      "external_ui": "ui",
226
      "secret": "singbox-secret"
227
    },
228
    "cache_file": {
229
      "enabled": true,
230
      "path": "cache.db",
231
      "store_fake_ip": true
232
    }
233
  }
234
}

使用方法： 复制上面的模板，替换 server、server_port、uuid、password 等字段为你的机场节点信息，保存为 config.json 即可使用。

8. 全平台安装与使用#

8.1 Windows#

方法一：命令行版（sing-box 核心）#

1
# 下载最新版
2
# 从 https://github.com/SagerNet/sing-box/releases 下载 Windows amd64 版本
3

4
# 解压后运行
5
sing-box run -c config.json -D .

需要管理员权限才能使用 TUN 模式。

方法二：Hiddify（推荐，图形界面）#

Hiddify 是基于 sing-box 的图形客户端，提供美观的 UI：

访问 Hiddify 官网下载 Windows 版
安装后导入机场订阅链接
选择节点，开启代理

方法三：Clash Verge Rev + sing-box 内核#

Clash Verge Rev 支持切换 sing-box 内核：

安装 Clash Verge Rev
在设置中切换内核为 sing-box
导入 sing-box 格式订阅或手动配置

8.2 macOS#

方法一：命令行版#

1
# 下载 macOS 版本（Intel: amd64, Apple Silicon: arm64）
2
# 从 https://github.com/SagerNet/sing-box/releases 下载
3

4
# 使用 sudo 运行（TUN 模式需要）
5
sudo sing-box run -c config.json -D .

方法二：Hiddify（推荐）#

从 Hiddify 官网下载 macOS 版
支持 Intel 和 Apple Silicon
导入订阅，一键使用

8.3 iOS#

iOS 上使用 SFI（Sing Box for iOS）：

SFI 目前需要通过 TestFlight 安装（免费）
安装步骤：
- 在 App Store 搜索 “SFI” 或访问 SFI TestFlight 链接
- 安装 SFI
- 打开 SFI，点击「添加配置」
- 选择「从 URL 导入」粘贴机场 sing-box 订阅链接
- 或手动编辑 JSON 配置
- 选择节点，开启代理

注意： SFI 也支持从剪贴板导入配置，直接复制 JSON 内容即可。

8.4 Android#

Android 使用 SFA（Sing Box for Android）：

从 SFA GitHub Releases 下载 APK
或从 Google Play 搜索 “SFA” 安装
安装后导入机场订阅链接
选择节点，开启代理

8.5 Linux#

1
# 下载对应架构版本
2
# 从 https://github.com/SagerNet/sing-box/releases 下载
3

4
# TUN 模式需要 root 或 cap_net_admin 权限
5
sudo setcap cap_net_admin+ep sing-box
6
sing-box run -c config.json -D .
7

8
# 或直接用 sudo
9
sudo sing-box run -c config.json -D .

9. 机场订阅导入指南#

9.1 机场 sing-box 订阅格式#

越来越多机场支持 sing-box 专属订阅格式。导入方式：

图形客户端导入#

在 SFI/SFA/Hiddify 中：

点击「添加配置 / Add Configuration」
选择「从 URL 导入 / Import from URL」
粘贴机场提供的 sing-box 订阅链接
自动解析节点，生成完整配置

命令行导入#

机场订阅通常返回完整 JSON 配置，直接保存为 config.json：

1
# 下载订阅配置
2
curl -o config.json "https://your-airport.com/api/v1/client/singbox?token=your-token"
3

4
# 运行
5
sing-box run -c config.json -D .

9.2 Clash 订阅转 sing-box 格式#

如果机场只提供 Clash 订阅，可以用转换工具：

方法一：在线转换

使用 subconverter 等工具：

1
https://subconverter-url/sub?target=singbox&url=clash-subscription-url

方法二：手动转换关键字段

Clash YAML → sing-box JSON 的关键映射：

Clash YAML	sing-box JSON
`proxies:`	`outbounds:`
`proxy-groups:`	`selector/urltest outbound`
`rules:`	`route.rules:`
`rule-providers:`	`route.rule_set:`
`dns:`	`dns:`

9.3 多节点订阅 + 自定义规则#

你可以同时使用机场订阅节点 + 自定义分流规则：

1
{
2
  "outbounds": [
3
    // 机场订阅节点（由客户端自动生成）
4
    // ... 节点列表 ...
5

6
    // 自定义分组
7
    {
8
      "type": "selector",
9
      "tag": "proxy-out",
10
      "outbounds": ["auto-select", "节点A", "节点B"],
11
      "default": "auto-select"
12
    },
13
    {
14
      "type": "urltest",
15
      "tag": "auto-select",
16
      "outbounds": ["节点A", "节点B", "节点C"],
17
      "url": "https://www.gstatic.com/generate_204",
18
      "interval": "5m"
19
    },
20
    { "type": "direct", "tag": "direct-out" },
21
    { "type": "block", "tag": "block-out" }
22
  ],
23
  "route": {
24
    // 自定义分流规则
25
    "rule_set": [...],
26
    "rules": [...],
27
    "final": "proxy-out"
28
  }
29
}

10. 高级技巧#

10.1 链式代理（流量中转）#

sing-box 支持 outbound 链式组合，流量依次经过多个节点：

1
{
2
  "type": "vless",
3
  "tag": "vless-chain",
4
  "server": "中转服务器IP",
5
  "server_port": 443,
6
  "uuid": "uuid",
7
  "detour": "trojan-out",
8
  // 先走 trojan 到中转服务器，再通过中转服务器连接 vless 目标
9
}

detour 指定前一个出站——流量先走 trojan-out，再走当前 vless-chain，实现链式中转。

10.2 UDP over TCP#

某些网络环境 UDP 不稳定（如部分运营商），sing-box 可以将 UDP 封装为 TCP：

1
{
2
  "type": "shadowsocks",
3
  "tag": "ss-udp-over-tcp",
4
  "server": "your-server.com",
5
  "server_port": 8388,
6
  "method": "aes-256-gcm",
7
  "password": "your-password",
8
  "udp_over_tcp": {
9
    "enabled": true
10
  }
11
}

10.3 多用户 / 分流管理#

通过 selector 出站实现精细分流：

1
{
2
  "outbounds": [
3
    {
4
      "type": "selector",
5
      "tag": "streaming-out",
6
      "outbounds": ["hy2-us", "vmess-jp"],
7
      "default": "hy2-us"
8
    },
9
    {
10
      "type": "selector",
11
      "tag": "chat-out",
12
      "outbounds": ["vless-sg", "trojan-hk"],
13
      "default": "vless-sg"
14
    },
15
    {
16
      "type": "selector",
17
      "tag": "proxy-out",
18
      "outbounds": ["streaming-out", "chat-out", "auto-select", "direct-out"],
19
      "default": "auto-select"
20
    }
21
  ]
22
}

路由规则中按用途分流：

1
{
2
  "route": {
3
    "rules": [
4
      {
5
        "domain_suffix": [".netflix.com", ".youtube.com"],
6
        "outbound": "streaming-out"
7
      },
8
      {
9
        "domain_suffix": [".telegram.org", ".discord.com"],
10
        "outbound": "chat-out"
11
      }
12
    ]
13
  }
14
}

10.4 Fake IP 模式#

Fake IP 可以加速 DNS 解析，避免被污染：

1
{
2
  "dns": {
3
    "independent_cache": true,
4
    "fake_ip": {
5
      "enabled": true,
6
      "ip_range": "198.18.0.0/15"
7
    }
8
  },
9
  "experimental": {
10
    "cache_file": {
11
      "enabled": true,
12
      "store_fake_ip": true
13
    }
14
  }
15
}

工作原理：DNS 查询返回一个 Fake IP（198.18.x.x），应用连接到 Fake IP，sing-box 在路由层拦截后用真实域名去远程 DNS 解析，得到真实 IP 后再转发。

10.5 自动更新订阅#

在图形客户端中通常有自动更新功能。命令行版可以通过脚本实现：

1
#!/bin/bash
2
# sing-box 订阅更新脚本
3

4
SINGBOX_DIR="/etc/sing-box"
5
CONFIG_FILE="$SINGBOX_DIR/config.json"
6
SUB_URL="https://your-airport.com/api/v1/client/singbox?token=your-token"
7

8
# 下载最新配置
9
curl -s -o "$CONFIG_FILE" "$SUB_URL"
10

11
# 重启 sing-box
12
systemctl restart sing-box

配合 systemd 定时器实现自动更新：

1
[Unit]
2
Description=Update sing-box subscription
3

4
[Timer]
5
OnCalendar=*-*-* 04:00:00
6
Persistent=true
7

8
[Install]
9
WantedBy=timers.target

11. 常见问题与排错#

11.1 TUN 模式启动失败#

症状： tun: creating tun stack: operation not permitted

解决：

Windows：以管理员身份运行
macOS：sudo sing-box run ...
Linux：sudo setcap cap_net_admin+ep sing-box 或直接 sudo

11.2 规则集下载失败#

症状： rule_set: download failed: connection refused

解决：

确保 download_detour 设置为 proxy-out（通过代理下载）
检查代理节点是否可用
如果 GitHub 被墙，改用镜像 URL

11.3 DNS 解析异常#

症状： 国内网站解析到海外 IP

解决：

确保 DNS 规则正确：国内域名用国内 DNS，海外域名用海外 DNS
检查 independent_cache: true 是否设置
如果用了 Fake IP，确保 store_fake_ip: true

11.4 端口冲突#

症状： listen: address already in use

解决：

检查其他代理工具是否占用相同端口（7890/9090）
关闭其他代理工具或修改端口

11.5 JSON 配置格式错误#

症状： parse config: invalid json

解决：

使用 JSON 格式检查工具验证
注意 JSON 不支持注释（不能像 YAML 那样写注释）
注意字符串必须用双引号，不能用单引号
注意末尾不能有多余逗号

11.6 iOS SFI 无法连接#

解决：

确保配置格式正确（SFI 对 JSON 格式要求严格）
确保订阅链接返回的是 sing-box 格式（不是 Clash YAML）
尝试从剪贴板导入手动编写的配置

11.7 Hysteria2 连接不稳定#

解决：

Hysteria2 基于 QUIC，某些运营商可能限制 UDP
尝试启用 udp_over_tcp 将 UDP 转 TCP
或切换到 VMess/VLESS 等基于 TCP 的协议

12. sing-box 与 Clash 全对比#

维度	Clash / Clash Meta	sing-box
配置格式	YAML	JSON
协议覆盖	SS/VMess/VLESS/Trojan + 插件	全协议原生（含 Hysteria2/ShadowTLS/TUIC）
DNS 分流	基础分流	DNS 规则独立配置 + 规则集
路由规则	Rule Provider	rule_set + logical 逻辑组合
链式代理	relay	detour 链式组合
测速切换	url-test/fallback/load-balance	urltest/selector
图形客户端	Clash Verge Rev（成熟）	Hiddify/SFI/SFA（快速发展）
Web UI	Yacd/Metacubexd	兼容 Clash API，同用 Metacubexd
内存占用	50-80 MB	20-40 MB
社区规模	大（历史积累）	快速增长
维护状态	Clash 原版停更，Meta 活跃	活跃维护
上手难度	低（大量教程）	中偏低（本文帮你搞定）

13. 推荐配置方案#

13.1 新手推荐方案#

不想折腾配置？直接导入机场订阅！

选择支持 sing-box 订阅的机场（参考机场推荐）
安装图形客户端（Hiddify / SFI / SFA）
导入订阅链接，一键使用

13.2 进阶用户推荐方案#

想精细控制分流？用本文的配置模板！

复制第 7 节的完整配置模板
替换节点信息（server / port / uuid / password）
根据需要调整分流规则
保存为 config.json 运行

13.3 自建节点用户推荐方案#

有自己的 VPS？sing-box 是最佳客户端！

服务端部署 Hysteria2 / VLESS + XTLS Vision
客户端使用 sing-box 对应的 outbound 配置
配合 rule_set 规则集实现精细分流

14. 总结#

sing-box 正在成为 2026 年代理工具的新标准：

多协议原生支持——不再需要 Clash 的各种插件补丁
灵活路由规则——rule_set + logical 组合，比 Clash 更强大
独立 DNS 分流——国内域名国内解析，海外域名海外解析
低资源占用——Go 语言优势，内存占用仅为 Clash 的一半
全平台覆盖——Windows/macOS/iOS/Android/Linux 全有客户端

如果你还在用 Clash，建议先在手机（SFI/SFA）上试一下 sing-box，体验 Hysteria2 的速度提升。习惯了再在电脑上切换。

推荐阅读：

2026 高性价比机场推荐

Clash Verge Rev 进阶配置指南

Clash 规则配置进阶教程

Shadowrocket 小火箭教程

sing-box 全平台使用教程：新一代通用代理平台配置指南 | 2026 最新

1. sing-box 是什么？为什么要用它？#

1.1 sing-box 简介#

1.2 sing-box vs Clash：核心区别#

2. 配置文件结构详解#

2.1 配置文件整体结构#

2.2 log 日志配置#

2.3 dns DNS 配置#

3. inbound 入站配置#

3.1 mixed 入站（系统代理模式）#

3.2 tun 入站（全局代理模式）#

3.3 direct 入站#

3.4 完整入站配置（混合模式）#

4. outbound 出站配置（代理节点）#

4.1 direct 直连出站#

4.2 block 拦截出站#

4.3 dns DNS 出站#

4.4 Shadowsocks#

4.5 VMess（V2Ray）#

4.6 VLESS#

4.7 Trojan#

4.8 Hysteria2（重点推荐）#

4.9 ShadowTLS v3#

4.10 Selector 选择器出站（类似 Clash 的 Proxy Group）#

4.11 URLTest 自动选择出站#

5. route 路由分流配置#

5.1 路由规则基础#

5.2 常用规则类型#

5.3 rule_set 规则集（核心功能）#

5.4 logical 逻辑组合规则#

6. experimental 实验功能#

6.1 Clash API（兼容 Clash 控制面板）#

6.2 V2Ray API#

7. 完整配置模板#

8. 全平台安装与使用#

8.1 Windows#

方法一：命令行版（sing-box 核心）#

方法二：Hiddify（推荐，图形界面）#

方法三：Clash Verge Rev + sing-box 内核#

8.2 macOS#

方法一：命令行版#

方法二：Hiddify（推荐）#

8.3 iOS#

8.4 Android#

8.5 Linux#

9. 机场订阅导入指南#

9.1 机场 sing-box 订阅格式#

图形客户端导入#

命令行导入#

9.2 Clash 订阅转 sing-box 格式#

9.3 多节点订阅 + 自定义规则#

10. 高级技巧#

10.1 链式代理（流量中转）#

10.2 UDP over TCP#

10.3 多用户 / 分流管理#

10.4 Fake IP 模式#

10.5 自动更新订阅#

11. 常见问题与排错#

11.1 TUN 模式启动失败#

11.2 规则集下载失败#

11.3 DNS 解析异常#

11.4 端口冲突#

11.5 JSON 配置格式错误#

11.6 iOS SFI 无法连接#

11.7 Hysteria2 连接不稳定#

12. sing-box 与 Clash 全对比#

13. 推荐配置方案#

13.1 新手推荐方案#

13.2 进阶用户推荐方案#

13.3 自建节点用户推荐方案#

14. 总结#