ShadowsocksX-NG 怎么用：版本、PAC 规则与插件

ShadowsocksX-NG 的来历

ShadowsocksX-NG 的仓库描述是「Next Generation of ShadowsocksX」，即早年 macOS 客户端 ShadowsocksX 的下一代版本。它挂在 shadowsocks 组织名下，是 macOS 平台上 Shadowsocks 协议的官方图形客户端。与 Windows 和安卓上的同门项目相比，它的特点是把 shadowsocks-libev 的 ss-local 以及几个常用插件直接打包进了应用，安装后不需要另外配置命令行工具。

需要提醒的是，网上还流传一个名为 ShadowsocksX-NG-R 的分支，它是第三方维护的独立项目，并非官方版本，版本号和功能都与本页所说的不同。下载时请务必核对仓库路径是否为 shadowsocks/ShadowsocksX-NG。

官方信息核实结果

核实日期 2026 年 10 月 21 日，来源为官方仓库首页、README 原文、Releases 页面以及 GitHub 接口返回的元数据：

• 官方仓库：https://github.com/shadowsocks/ShadowsocksX-NG
• 最新版本：v1.10.3，发布时间 2024 年 10 月 29 日（UTC），非预发布版
• 发布附件：ShadowsocksX-NG.dmg、ShadowsocksX-NG.dmg.checksum
• 更新内容：改进「从屏幕扫描二维码」功能的通知提示
• 之前的版本：v1.10.2（2023 年 3 月 29 日）、v1.10.1（2023 年 3 月 10 日）
• 平台：macOS
• 系统要求：macOS 10.12 或更高版本
• 芯片架构：官方页面未提及，未能核实
• 许可证：GPLv3
• 归档状态：未归档，默认分支为 develop，最近一次推送为 2026 年 10 月 5 日
• 价格：开源项目，GitHub Releases 免费下载
• 订阅导入：README 未提及，未能核实
• Homebrew 安装方式：README 中没有给出，未能核实

部分第三方下载站和百科页面列出的版本信息与上面不一致，例如有的仍把 1.10.2 当作最新版。本页一律以官方 Releases 为准。

ShadowsocksX-NG 下载与首次运行

1. 打开官方 Releases 页面，下载 ShadowsocksX-NG.dmg，同时下载同名的 checksum 文件。
2. 在终端中对 dmg 文件计算校验值，与 checksum 文件中的内容比对。如果不一致，删除文件，不要打开。
3. 打开 dmg，把应用拖进「应用程序」文件夹。
4. 首次运行时，macOS 可能提示无法验证开发者。这是系统的安全机制，确认文件来自官方仓库并且校验通过之后，可以在「系统设置」的「隐私与安全性」中选择仍要打开。不同系统版本的菜单名称略有差异。
5. 应用启动后主要通过屏幕顶部菜单栏里的图标操作，后续的模式切换、服务器管理都从这里进入。

由于应用需要修改系统的网络代理设置，首次开启代理时，macOS 可能会弹出授权提示。请看清提示内容来自系统本身再确认；如果弹窗要求你注册账号、付费或填写与代理无关的信息，那就不是官方应用的正常行为，应立即停止。关于 Mac 下载渠道的更多判断方法，可以看 下载安全指南。

ShadowsocksX-NG 菜单栏里的几种模式

README 描述了这款客户端的几种工作方式，菜单项名称在不同版本里略有差异：

• PAC 自动模式：根据 PAC 规则判断哪些网站走代理。README 写明可以从 GitHub 下载 GFW List 来更新 PAC，也支持自定义 PAC 规则。
• 全局类模式：README 的功能列表没有专门写到全局模式，菜单中是否提供、叫什么名字，以你安装的版本为准。如果有，它的作用通常是让所有遵守系统代理的流量都经过服务器，适合临时排查。
• 手动模式：README 专门说明，这个模式不会修改系统代理设置，你可以只让个别应用通过 SOCKS5 代理上网。这对只想让浏览器或某个开发工具走代理的人很有用。

此外，README 提到应用通过 Privoxy 提供 HTTP 代理。有些程序只支持 HTTP 代理而不支持 SOCKS5，这时可以在应用的偏好设置里查看 HTTP 代理的端口，再填到对应程序里。

ShadowsocksX-NG 添加服务器的方式

根据 README 的功能列表，添加服务器有三种常见途径：

第一，从剪贴板导入服务器配置链接。如果服务端或机场后台提供了单个节点的 ss:// 链接，复制后在菜单中选择从剪贴板导入相关的项即可。

第二，扫描屏幕上的二维码导入。把二维码显示在屏幕上，比如在浏览器中打开节点的二维码页面，然后在菜单中选择扫描屏幕二维码。v1.10.3 的唯一更新就是改进了这个功能的通知提示，扫描成功或失败时提示会更清楚。

第三，在服务器设置窗口中手动填写地址、端口、密码和加密方式。README 说明支持 AEAD 加密方式，填写时务必与服务端保持一致。

反过来，你也可以把已有的服务器配置以二维码或链接的形式分享出去，方便在手机上的 Shadowrocket 等客户端里扫码使用。

插件支持

这是 ShadowsocksX-NG 相比同门项目更方便的地方。README 写明它支持 SIP003 插件，并内置了 kcptun、simple-obfs 和 v2ray-plugin 三个插件。

如果服务端配置了其中某个插件，在服务器设置里的插件相关字段中填入插件名称和参数即可，不需要另外安装插件程序。参数格式需要与服务端一致，具体内容应向服务端的提供者确认。如果填了插件但服务端并没有启用插件，或者反过来，连接都会失败。

和机场订阅是什么关系

很多人把「Shadowsocks 客户端」和「机场客户端」当成一回事，这里需要分开说。

ShadowsocksX-NG 只支持 Shadowsocks 协议。机场的订阅链接通常是一个 https 地址，返回的内容可能是 Clash 格式的配置文件，也可能是编码后的多协议节点列表，详见 订阅链接是什么。README 没有提到订阅功能，所以本页不认为它能导入机场订阅，也不把它列入任何订阅格式的适配名单。

如果机场只提供 VMess、Trojan、Hysteria2 等其他协议，ShadowsocksX-NG 完全用不上；如果机场提供 Shadowsocks 节点，你可以通过上面说的链接或二维码方式逐个添加，但无法自动随订阅更新。需要整体管理机场订阅的 Mac 用户，更适合选择 ClashX Meta、Clash Verge Rev 或 SFM 这类客户端。各协议的区别可在 协议说明 中查看。

常见问题的排查方向

开启后网页打不开：可以先用手动模式，把浏览器的 SOCKS5 代理指向本地端口测试。如果这样能用而 PAC 模式不行，说明是规则问题，可以更新 GFW List 或补充自定义规则；如果手动指定代理也不行，问题多半在服务器参数或线路。

提示端口被占用：本机如果同时运行了其他代理工具，可能占用了相同的本地端口。退出其他代理工具，或在偏好设置中修改本地监听端口。

退出后无法上网：如果应用异常退出，系统代理设置可能没有被恢复。打开系统的网络设置，检查代理选项是否仍然开启，手动关闭即可。

所有节点都超时：换一个客户端或设备测试同一台服务器，如果同样失败，参考 节点全部超时排查。

升级与共存的注意事项

ShadowsocksX-NG 的正式版本发布间隔比较长，从 v1.10.2 到 v1.10.3 隔了一年半以上。这意味着你手里的版本很可能已经用了很久。升级时，先到官方 Releases 页面确认最新版本号，再按前面的步骤下载并校验 dmg 文件，直接覆盖「应用程序」文件夹中的旧版本即可。覆盖前建议先在菜单里退出应用，避免旧进程仍在占用本地端口。

另一个常见情况是，同一台 Mac 上同时装了多款代理工具。macOS 的系统代理只有一份，哪个应用最后修改了它，就以哪个为准。如果你同时打开 ShadowsocksX-NG 和其他 Clash 类客户端，两者会相互覆盖系统代理设置，表现为时好时坏、切换节点无效。比较稳妥的做法是一次只启用一款工具，换用另一款之前，先在当前工具里关闭代理再退出。

如果你只想让某一个程序走 Shadowsocks，比如终端里的某个命令或某个开发工具，可以使用 README 提到的手动模式。它不会改动系统代理，只在本地提供 SOCKS5 和 HTTP 代理端口，由你自己决定哪些程序去使用，这样也就不会和其他代理工具争夺系统设置。

小结

ShadowsocksX-NG 是 macOS 上的官方 Shadowsocks 客户端，GPLv3 开源，最新版本为 2024 年 10 月发布的 v1.10.3，要求 macOS 10.12 以上，仓库仍有开发活动。它内置常用插件、提供 PAC 与手动模式，适合自建 Shadowsocks 服务端或只使用单个 Shadowsocks 节点的用户；对于需要导入机场订阅的场景，它并不合适。更多 Mac 客户端的选择思路可以参考 Mac 客户端使用指南 与 客户端总览。