Sing-Box客户端使用教程、配置说明-macOS

macOS 1.14 系列使用官方独立版 SFM,要求 macOS 13.0 及以上。旧应用的配置与设置不会自动继承;升级前先备份可恢复的配置和设置,再核对迁移方式。本页保留旧界面参考,通用操作集中在 主教程。

本页只补充 macOS 的下载、升级与权限差异。Windows 用户可查看 SFW 教程,Linux 下载入口在 首页;两个平台不按下面的旧 macOS 界面操作。

下载与安装 SFM 独立版

从 官方发行页选择 SFM 开头的 macOS 独立版,按文件类型安装 PKG 或解压 ZIP;例如 Homebrew 当前使用 SFM 1.14.2 的 Universal PKG。已经使用 Homebrew 的用户也可按 sfm cask说明安装。普通 sing-box Darwin 压缩包是命令行内核,不能按图形客户端操作。商店与独立版的来源不同,不把旧 App Store 入口作为 1.14 独立版下载。

准备兼容的 sing-box 配置:可以是本地 JSON,也可以是返回完整配置的远程地址。安装应用本身不会提供节点;配置格式、字段含义和启动验证统一见 sing-box 使用教程。

Clash YAML、单条节点分享链接和节点列表不等于完整 sing-box 配置。先向提供方确认格式与支持的内核版本;导入或启动报错时,按 常见问题区分下载失败、解析失败和连接失败。

添加配置

以下五张图是 Profiles、Dashboard 和分组展示。

添加订阅

Remote 的名称与地址字段。完整字段解释和本地配置选择见 主教程,不用在 macOS 另维护一套通用步骤。

填写订阅信息

运行与分组

选中配置与启动控制。当前 SFM 启动隧道时,按系统提示允许所需的网络扩展或 VPN 配置;只选中配置不等于服务已启动。

选中订阅并开启

运行后的分组入口。配置包含 Selector 或 URLTest 出站时才有相应分组;没有该定义时,不应把入口缺失当作客户端损坏。

显示代理列表

分组与延迟测试。当前配置启动后仍需实际访问验证;节点切换与模式条件见 主教程。

测速并选择合适节点

升级后配置不见了,怎么处理?

1.14 的 Apple 开发者账号迁移使 macOS 独立版成为新应用,不会自动继承旧配置和设置。升级前保留原配置文件、远程地址及必要设置;如果新应用中找不到旧配置,可以用备份重新添加,不先删除旧应用数据。

需要迁移旧应用数据时,官方说明区分“首次启动 1.14.0-rc.2 或之后版本前”和“已执行过旧迁移命令且遇到权限提示”两种情况。按 macOS 数据迁移说明核对适用条件;其中涉及移动目录和删除元数据,先做备份,不把两组命令混用。

macOS 启动与连接排查

配置解析错误先核对内核版本;系统拒绝启用隧道时,检查当前应用需要的权限及已有 VPN。若服务已运行却无法访问,再按 FAQ区分节点、DNS 和路由问题,不把所有报错都归为旧数据迁移。