macOS 是 Apple 生态系统的核心操作系统,拥有优秀的用户体验和安全性。这篇指南将详细介绍如何在 macOS 系统中安装和配置 sing-box,让您能够更顺畅地访问网络资源。无论您使用的是 Intel 芯片还是 Apple Silicon 芯片的 Mac,都能找到适合的解决方案。

系统要求

在开始安装之前,请确保您的系统满足以下要求:

  • 操作系统:macOS 10.15 (Catalina) 或更高版本
  • 处理器:Intel 芯片或 Apple Silicon (M1/M2/M3) 芯片
  • 内存:建议 4GB 或更多
  • 存储空间:至少 100MB 可用空间
  • 网络:稳定的互联网连接
  • 版本:支持 sing-box v1.12.4 及更高版本
💡

提示

如果您使用的是 Apple Silicon Mac,建议下载 ARM64 版本以获得最佳性能。Intel Mac 用户请下载 x86_64 版本。

1. 下载软件

请访问官方网站 下载页面,选择对应的版本:

  • Apple Silicon Mac:选择 "macOS 命令行 Apple Silicon" 或 "macOS 应用 通用版本"
  • Intel Mac:选择 "macOS 命令行 Intel" 或 "macOS 应用 通用版本"

当前最新版本为 v1.12.4,支持以下下载选项:

下载完成后,文件会出现在 Downloads 文件夹中。

💡

提示

您也可以直接访问 GitHub 发布页面 下载最新版本。当前最新稳定版本为 v1.12.4。

2. 安装软件

方法一:安装 macOS 应用程序

如果您下载的是 .dmg 文件:

  1. 双击下载的 .dmg 文件
  2. 将应用程序拖拽到 Applications 文件夹
  3. 从 Applications 文件夹启动应用程序
  4. 首次启动时,系统可能会提示安全警告,请在"系统偏好设置 > 安全性与隐私"中允许运行

方法二:安装命令行版本

如果您下载的是 .tar.gz 文件:

  1. 双击下载的压缩包,或在终端中解压:
解压文件
cd ~/Downloads
tar -xzf sing-box-1.12.4-darwin-arm64.tar.gz

解压后会看到以下文件:

解压后的文件
sing-box
LICENSE

将 sing-box 移动到系统路径中:

移动到系统路径
sudo mv sing-box /usr/local/bin/
sudo chmod +x /usr/local/bin/sing-box

3. 配置软件

在运行 sing-box 之前,需要准备一个配置文件(JSON 格式)。配置文件包含服务器信息、路由规则等设置。

创建配置文件

在您的主目录下创建配置文件:

创建配置文件
mkdir -p ~/.config/sing-box
nano ~/.config/sing-box/config.json

配置文件的基本结构示例:

配置文件示例
{
  "log": {
    "level": "info"
  },
  "inbounds": [
    {
      "type": "mixed",
      "tag": "mixed-in",
      "listen": "127.0.0.1",
      "listen_port": 7890
    }
  ],
  "outbounds": [
    {
      "type": "direct",
      "tag": "direct"
    }
  ]
}
⚠️

注意事项

  • 配置文件格式必须严格遵循 JSON 语法
  • 请根据您的实际服务器信息修改配置
  • 建议使用专业的 JSON 编辑器来编辑配置文件
  • 配置文件包含敏感信息,请妥善保管

4. 运行软件

命令行版本运行

如果您安装的是命令行版本,在终端中运行:

运行 sing-box
sing-box run -c ~/.config/sing-box/config.json

应用程序版本运行

如果您安装的是应用程序版本:

  1. 从 Applications 文件夹启动 sing-box 应用
  2. 应用会自动加载默认配置文件
  3. 您可以在应用界面中修改配置

如果配置文件正确,sing-box 就会开始运行,您就能更顺畅地访问所需的网络资源。

5. 配置系统代理

为了让所有应用程序都通过 sing-box,需要配置系统代理设置(这个其实可以不操作):

  1. 打开"系统偏好设置"
  2. 点击"网络"
  3. 选择当前使用的网络连接(Wi-Fi 或以太网)
  4. 点击"高级"
  5. 切换到"代理"标签
  6. 勾选"Web 代理 (HTTP)"和"安全 Web 代理 (HTTPS)"
  7. 服务器地址填写:127.0.0.1
  8. 端口填写:7890(或您在配置文件中设置的端口)
  9. 点击"好"保存设置
💡

提示

您也可以使用第三方工具如 Proxifier 或 Surge 来管理代理设置,这些工具提供更灵活的代理规则配置。

6. 设置开机自启动

为了方便日常使用,可以设置 sing-box 开机自启动:

使用 launchd 服务

创建 plist 文件:

创建服务文件
nano ~/Library/LaunchAgents/com.sing-box.plist

添加以下内容:

服务配置
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.sing-box</string>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/sing-box</string>
    <string>run</string>
    <string>-c</string>
    <string>~/.config/sing-box/config.json</string>
  </array>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
</dict>
</plist>

加载服务:

加载服务
launchctl load ~/Library/LaunchAgents/com.sing-box.plist

7. 常见问题解决

权限问题

如果遇到权限问题,请检查:

  • 确保 sing-box 文件有执行权限
  • 检查配置文件权限设置
  • 确保端口没有被其他程序占用

网络连接问题

如果无法连接网络:

  • 检查配置文件中的服务器信息是否正确
  • 确认服务器是否在线
  • 检查防火墙设置
  • 尝试更换端口

性能问题

如果遇到性能问题:

  • 检查系统资源使用情况
  • 优化配置文件中的路由规则
  • 考虑使用更快的服务器
  • 更新到最新版本的 sing-box(当前最新版本为 v1.12.4)

下一步

成功运行 sing-box 后,您可以:

  • 学习更多高级配置选项,如路由规则、DNS 设置等
  • 配置多个服务器实现负载均衡
  • 设置自动切换规则
  • 探索其他平台的使用方法
  • 参与社区讨论,分享使用经验