sing-box Mac 教程:macOS 图形客户端与命令行两种用法详解

Mac 上的两种用法

sing-box 是 SagerNet 开发的开源通用代理平台,用 JSON 配置文件描述节点和规则。和 Windows 只有命令行不同,macOS 上有两种用法:

方式	形式	适合谁
图形客户端(sing-box for macOS)	官方出品的应用,有配置管理和开关界面	大多数用户
命令行程序	在终端里运行,自己管理配置文件	熟悉终端、需要自定义的用户

无论哪种方式,前提都是机场提供 sing-box 格式的配置或订阅。Clash 格式的订阅不能直接使用;机场没有提供时,改用 Clash Verge Rev Mac 版 更直接。

图形客户端:安装与添加配置

图形客户端的获取方式以 sing-box 官方文档 里苹果平台客户端的说明为准:通常可以在非中国大陆区的 App Store 搜索 sing-box 安装(需要外区 Apple ID),官方仓库 SagerNet/sing-box 的 Releases 也可能提供 macOS 安装包。

安装后按下面的步骤操作:

1. 在机场用户中心复制 sing-box 格式的订阅或配置链接。
2. 打开应用,进入配置(Profiles)页面,新建一个配置。
3. 类型选择远程(Remote),把链接粘贴到 URL 一栏,按需打开自动更新,保存。
4. 回到主面板(Dashboard),打开启用开关。
5. 首次启用时 macOS 会弹窗询问是否允许添加 VPN 配置或系统扩展,点击允许并按提示输入密码。
6. 运行后可以在分组页面里切换节点、查看各节点延迟。

图形客户端是以系统 VPN 的形式接管流量的,效果相当于 TUN 模式,不需要再单独设置系统代理,终端里的命令同样会走代理。

命令行:Homebrew 安装与运行

1. 已安装 Homebrew 的 Mac,在终端执行:

brew install sing-box

2. 把机场提供的 sing-box 配置保存为 config.json。
3. 先检查配置,再运行:

sing-box check -c config.json
sudo sing-box run -c config.json

配置里包含 TUN 入站时需要 sudo;如果配置只开了本地混合端口,则不需要 sudo,但要到「系统设置」→「网络」→「代理」里手动填写 127.0.0.1 和对应端口。按 Control + C 可以停止运行。

命令行方式不会自动更新配置,机场调整节点后需要重新下载配置文件。

验证是否生效

1. 用浏览器打开一个需要代理的网站。
2. 在 IP 查询网站上确认地区已变成节点所在地。
3. 终端里执行 curl -I https://www.google.com,能返回状态行。

常见报错

• 添加配置后提示解析失败:配置格式和客户端版本不匹配。sing-box 的配置字段会随版本调整,先把客户端更新到新版本,再重新获取机场的配置。
• 启用开关打开后自动关闭:常见原因是没有在系统弹窗里允许 VPN 配置,或者和其他 VPN、代理客户端冲突。到系统设置的 VPN 列表里确认配置存在,并退出其他同类软件,更多情况见 TUN模式无法使用。
• 能连接但网页打不开:多与 DNS 有关,按 DNS解析失败 排查。
• 命令行停止后无法上网:如果手动填过系统代理,记得关掉,方法见 macOS系统代理修复。

Windows 上的命令行用法见 sing-box 使用教程,各平台客户端的差异可以在 客户端大全 里对照。