macOS 安装：SFM 独立版与升级迁移

选哪个安装包

• 新手优先：SFM 官方独立版。在官方发行页里找 SFM standalone，按文件类型安装或解压：PKG 就按安装向导装，ZIP 就解压后使用。
• 已有 Homebrew 的用户：也可以走 SFM 的 Homebrew cask，装的是同一个独立版的通用包，更新走 Homebrew 的流程。
• 不要装错：普通 sing-box Darwin 压缩包是命令行内核，没有图形界面；装完发现没有界面，说明拿错了包，不是软件坏了。

系统版本方面，1.14 系列的 SFM 独立版面向较新的 macOS（官方说明里提到 macOS 13 及以上），老系统先确认发行页上该版本的系统要求，再下载。

步骤

1. 下载并安装 SFM 独立版。
2. 导入 sing-box 配置（远程或本地），确认它出现在配置列表里。
3. 选中配置，点启动；系统弹网络扩展或 VPN 配置提示时要点允许，只选中配置、不点启动，服务是不会跑起来的。
4. 如果配置里有分组，在组视图里选节点或跑一次延迟测试，再用浏览器验证实际访问。
5. 不用时点停止；只关窗口不一定等于退出，留意程序是不是还在运行。

升级迁移：最容易丢配置的一步

1.14 的一次应用迁移让 SFM 成了一个新应用，旧版的配置和设置不会自动继承到新应用里。所以升级前要做到：

• 把能恢复的东西先留好：配置文件本身、远程配置 URL、必要的设置截图或记录。
• 在新应用里重新添加一遍配置，不要先删旧数据；确认新应用能正常启动、能访问目标之后，再处理旧应用的数据。
• 迁移时如果遇到权限提示，要按官方迁移说明里与自己情况对应的那一种处理（是首次启动新版本，还是之前已经跑过迁移命令），不要凭感觉移动目录或删除元数据。

升级后如果启动报格式错，先按版本变更说明核对字段，不要直接删字段；连接问题则回到《连不上的排查》按阶段查。