shadowsocksx-ng Mac 安装配置与版本选择：NG2、Legacy 怎么选？
简答：如果你的 Mac 是 Apple Silicon 且运行 macOS 15 或更高版本，可以优先核对 ShadowsocksX-NG2；如果是 Intel Mac，NG2 的官方要求不满足，Legacy 1.x 是否适配你的系统需单独核实。下载前只认项目 GitHub Releases，并注意 NG2 仍处于 Alpha 阶段，配置和规则不能默认完整迁移。
定义：shadowsocksx-ng 是 macOS 上的 Shadowsocks 图形客户端，本身不提供服务器、节点或订阅服务，使用前必须准备兼容的服务器配置或订阅。
先看兼容性：你的 Mac 应该选哪一代？
资料核验日期：2026-11-02。当前项目 README 写明，ShadowsocksX-NG2 面向 macOS 15 或更高版本，以及 Apple Silicon（arm64）Mac；项目 Wiki 同时说明 1.x 已停止维护，2 仍处于 Alpha 测试。查看项目 README 查看项目 Wiki
| 你的设备或需求 | 优先核对的版本 | 判断与注意事项 |
|---|---|---|
| Apple Silicon，macOS 15 或更高版本 | NG2 | 满足官方列出的系统要求，但当前仍是 Alpha，遇到功能缺失或界面变化应保留回滚方案。 |
| Intel Mac | Legacy 1.x | NG2 的官方要求包含 Apple Silicon；Legacy 1.x 仍能在 Releases 页面找到，但当前检索到的官方资料未明确确认全部 Intel 与 macOS 组合，需以具体资源说明和实机结果为准。 |
| 需要稳定生产使用 | 先谨慎评估 NG2 | 项目说明 NG2 仍在开发，Alpha 版本可能存在 Bug 或未完成功能，不宜把预发布版本当作稳定版。 |
| 只想安装软件 | GitHub Releases | 不要把客户端下载与服务器、订阅服务混为一谈；项目明确表示不提供服务器或订阅。 |
截至 2026-11-02，项目 Releases 页面将 v2.0.0-alpha.2 标为 Latest，同时列出 v2.0.0-alpha.1 与 v1.10.3。版本号和资源可能变化，下载前应再次打开页面核对标签、发布时间和 Assets。查看 GitHub Releases
最短安装流程：下载、启动、导入、复测
- 确认设备信息。打开 macOS“关于本机”，记录芯片类型和 macOS 版本。若不是 Apple Silicon，先不要直接下载 NG2；若系统低于 macOS 15，也不要假设 NG2 可以运行。
- 进入正确的发布页。在项目 GitHub 仓库点击 Releases，核对版本标签是否与目标版本一致，再查看对应 Assets。不要只根据搜索结果中的文件名判断来源。
- 首次启动。下载并打开对应应用后，观察菜单栏是否出现客户端图标。若 macOS 阻止启动，先确认文件来自项目 Releases，再按系统提示检查“隐私与安全性”中的允许选项；不要为了启动未知文件而关闭系统安全机制。
- 导入服务器配置。在菜单栏客户端中选择添加或导入配置，使用服务提供方给出的服务器信息、兼容的
ss://分享链接，或项目支持的 HTTPS SIP-008 订阅。导入后检查服务器地址、端口、加密方式、密码和插件参数是否完整。 - 选择路由模式。先使用 Global 做单一变量测试；确认连接后，再根据需要切换 Rules 或 Direct。项目 README 明确列出 Global、Rules、Direct 三类模式，Rules 还包含不同规则预设。查看当前版本说明
- 开启系统代理并复测。先确认客户端状态为已连接，再打开系统代理或客户端提供的代理开关。访问一个普通网页或使用需要代理的应用进行测试；如果只有浏览器有效、其他应用无效，说明应用可能没有使用系统代理。
- 记录结果并回滚。每次只改一个变量，记录版本、路由模式、插件和报错。若升级后异常，关闭客户端，保留旧版本应用和原配置，再回到之前能工作的版本复测。
客户端提供的是本地 SOCKS5 和 HTTP 代理入口；它不等于系统中所有应用都会自动走代理。项目 README 还说明，LAN 监听默认关闭，只有明确需要局域网设备接入时才应考虑开启。查看本地代理与 LAN 监听说明
配置导入失败：按现象分流排查
| 现象 | 先检查什么 | 修复动作 | 复测标准 |
|---|---|---|---|
| 无法导入订阅 | 链接是否为 HTTPS、返回内容是否为客户端支持的 SIP-008 格式、网络是否能访问该地址 | 重新复制链接，避免把网页地址、带空格的文本或失效跳转地址当作订阅；必要时先用浏览器确认是否能返回内容 | 客户端能创建订阅条目并显示服务器或更新结果 |
ss:// 导入后不能连接 | 地址、端口、密码、加密方式是否与服务端一致 | 删除错误条目后重新导入，避免在多个字段中重复粘贴编码内容 | 客户端状态变为已连接，延迟测试或实际访问不再立即失败 |
| 系统代理没有效果 | 客户端是否运行、系统代理是否开启、测试应用是否遵循系统代理 | 先用客户端支持的本地 SOCKS5 或 HTTP 入口测试，再检查具体应用的代理设置 | 至少一个明确遵循系统代理的应用能够完成访问测试 |
| 插件节点失败 | 服务端与客户端插件名称、参数、传输模式是否完全匹配 | 先关闭插件做基础连接测试；若节点必须依赖插件，再逐字段对照服务端资料 | 基础连接和插件连接的结果能够区分，不再混淆为网络整体故障 |
| 升级 NG2 后规则消失 | 是否把 Alpha 版本当作完整迁移升级 | 重新建立自定义规则，并保留旧版本配置作为回滚参考 | Rules 模式下实际命中的规则与预期一致 |
官方 Alpha.1 说明明确提醒：NG2 可与 Legacy 并行安装，但旧版偏好设置、路由规则和登录项不会自动迁移；Alpha.2 又说明自定义规则及规则启用设置不会从 Alpha.1 自动迁移。因此升级前应先记录规则和配置，不要只依赖自动迁移。查看版本迁移说明
Global、Rules、Direct 怎么选？
- Global：适合首次连接测试。它便于判断服务器配置、客户端运行和本地代理是否基本正常，但不代表所有应用都会自动使用代理。
- Rules：适合需要按域名或规则分流的场景。项目当前版本说明包含多个规则预设，切换后应实际检查目标站点命中了代理还是直连。
- Direct：适合暂时验证本地网络，或确认问题是否由代理路径引起。若 Direct 能访问而 Global 不能，应优先检查服务器参数、路由或插件，而不是先修改 DNS。
推荐顺序是“Global 基础测试—Rules 分流验证—Direct 对照测试”。每次切换后都使用同一个测试目标，避免把路由变化、节点变化和网络变化同时混在一起。
下载与安全核验清单
- 地址应为项目 GitHub 仓库及其 Releases 页面，而不是只看第三方转载页。
- 版本标签、发布日期和 Assets 应在同一 Releases 页面中对应。
- Apple Silicon 与 macOS 15 或更高版本要求只适用于官方当前说明的 NG2，不要把它推断成 Legacy 1.x 的全部兼容范围。
- 安装包打开后若要求输入与客户端功能无关的敏感信息，应停止安装并重新核对来源。
- 下载完成后保留版本标签和文件名，方便以后排查或回滚。
Homebrew 页面目前把 shadowsocksx-ng 标为 disabled，并显示记录版本为 1.10.3，因此不建议把 Homebrew Cask 当作当前 NG2 下载依据；应优先核对项目 Releases。查看 Homebrew 条目状态
结论：先按芯片选版本，再做最小配置测试
shadowsocksx-ng 的关键不是“下载哪个文件”，而是先确认 Mac 芯片、macOS 版本和目标版本的状态。Apple Silicon 且 macOS 15 或更高版本可以核对 NG2，但要接受 Alpha 阶段的迁移和兼容风险；Intel Mac 不应直接套用 NG2 要求，Legacy 1.x 的具体适配情况需要结合 Releases 资源和实机核验。完成安装后，使用单个配置、Global 模式和本地代理测试作为第一轮基线，再逐步加入订阅、Rules 和插件。
本文仅作客户端安装与连接排查参考，不代表任何代理服务器或订阅服务的官方页面。ShadowsocksX-NG 项目本身也明确说明不提供服务器或订阅服务。查看项目边界说明
常见问题
shadowsocksx-ng 现在应该下载哪个版本？
截至 2026-11-02，GitHub Releases 页面将 v2.0.0-alpha.2 标为 Latest。它面向 Apple Silicon 和 macOS 15 或更高版本，但仍是 Alpha。若你的设备或系统不满足这些条件，不要直接套用 NG2；Legacy 1.x 的具体兼容性需进一步核对。
Intel Mac 能不能使用 ShadowsocksX-NG2？
官方 README 将 Apple Silicon（arm64）列为 NG2 系统要求，因此 Intel Mac 不满足 NG2 的已核实要求。Legacy 1.x 仍可在 Releases 页面找到，但当前检索到的官方资料没有确认所有 Intel 与 macOS 组合，建议以具体资源说明和实机结果为准。
ShadowsocksX-NG 会自动提供节点或订阅吗？
不会。它是客户端，项目 Wiki 明确说明不提供、销售或运营服务器及订阅服务。你需要自行准备兼容的服务器配置、ss:// 分享链接或服务方提供的兼容订阅。
NG2 和 Legacy 可以同时安装吗？
官方 Alpha.1 说明 NG2 可以与 Legacy 并行安装，但旧版本的偏好设置、路由规则和登录项不会自动迁移。升级或并行安装前，应先记录配置，遇到异常时保留旧版本作为回滚参考。
导入成功但连接失败，应该先改 DNS 吗？
不建议一开始就改 DNS。先用 Global 模式检查地址、端口、密码、加密方式和插件参数，再用 Direct 做对照测试；只有确认问题与域名解析有关时，才把 DNS 作为单独变量测试。
相关阅读
参考资料
- ShadowsocksX-NG GitHub 项目 README
- ShadowsocksX-NG GitHub Releases
- ShadowsocksX-NG Wiki 项目状态与边界
- Homebrew Formulae：shadowsocksx-ng（formulae.brew.sh）
- Shadowsocks Getting Started（shadowsocks.org）