macOS 架构兼容与客户端下载
近年来苹果 Mac 电脑绝大多数采用 Apple Silicon（M1/M2/M3/M4 芯片架构），少数早期机型为 Intel 架构。在下载通用代理客户端时务必注意区分架构：
- Apple Silicon 用户：请下载文件名标有
aarch64或arm64的.dmg安装镜像，可获得最佳性能与最低发热能耗。 - Intel Mac 用户：请下载标有
x64的.dmg文件。 - 打开 DMG 文件后，将应用图标直接拖入「应用程序（Applications）」文件夹即可完成安装。
系统权限授权与网络扩展配置
macOS 对底层系统扩展与网络接口的权限控制极其严密。初次启动通用客户端时，通常需要完成以下系统授权：
- 启动应用后，系统若提示「已阻止打开未经身份验证的开发者应用」，请打开「系统设置 - 隐私与安全性」，滑到底部点击「仍要打开」。
- 当应用尝试创建虚拟网络适配器时，系统会弹出「已阻止系统扩展」，点击「打开系统设置」并在安全性面板中点击「允许」，输入 Touch ID 或开机密码。
订阅导入与常用分流规则设置
导入订阅与模式选择：
- 复制 River VPN 提供的专属托管配置链接，在客户端「订阅/配置」界面粘贴并下载。
- 将分流模式设定为「Rule（规则模式）」，这样 Safari 浏览国内技术文档时直连无感，访问境外资源时自动触发代理。
- 启用「自动更新订阅」，保持策略组与节点 IP 始终为最新可用状态。
终端命令行（Terminal / iTerm）代理配置
很多 Mac 开发者发现，即使浏览器能顺利访问海外技术站点，但在终端执行 git clone、brew install 或 npm install 依然超时。
这是因为 macOS 的终端默认不继承桌面图形界面的 HTTP 代理。有两种解决方案：
- 方案 A（推荐）：开启 TUN 模式。在客户端中开启增强型 TUN 模式，它在操作系统底层虚拟出一张网卡，整机所有出站流量均会自动走代理路由，无需修改任何终端配置文件。
- 方案 B：在
~/.zshrc中写入环境变量别名：alias proxy="export http_proxy=http://127.0.0.1:7890; export https_proxy=http://127.0.0.1:7890" alias unproxy="unset http_proxy; unset https_proxy"
在需要加速时在终端输入proxy即可快速生效。
macOS 连接排障与 DNS 缓存刷新
如果遇到节点测试正常但网页加载提示 DNS 错误，通常是本地 DNS 缓存未刷新或与系统设置冲突。在「终端」输入以下命令刷新 macOS 的 DNS 缓存：
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
此外，若从公共 Wi-Fi 切换至手机个人热点，建议在客户端状态栏中轻点重启核心，避免因网关 IP 变动引起的短时断流。