苹果设备运行支持评估
在开始配置前，请确认您的 Mac 设备满足以下硬件架构与系统版本要求。
芯片架构原生支持
全面兼容 Apple Silicon (M1/M2/M3系列) 以及早期的 Intel 芯片架构。对于 M 系列芯片，无需通过 Rosetta 2 转译即可高效运行核心组件，确保极低的系统资源占用。
Mac版初始配置与权限授予
由于 macOS 的安全机制，首次安装非 App Store 来源的软件需要进行特定的权限放行操作。
处理 Gatekeeper 安全拦截
完成v2rayn下载并将程序拖入“应用程序”文件夹后，双击可能会提示“无法打开，因为无法验证开发者”。
解决步骤：点击“取消”，然后打开系统顶部的“ 苹果菜单” > “系统偏好设置” (或“系统设置”) > “安全性与隐私”。在“通用”标签页下，您会看到软件被拦截的提示，点击“仍要打开”并输入开机密码即可。
菜单栏图标与常驻运行
启动成功后，主程序界面可能不会立即弹出，而是会在屏幕右上角的菜单栏出现 v2rayn 的状态图标。点击该图标即可展开操作面板，进行节点导入或规则切换。
导入配置与系统代理设置
进入主界面后，您可以通过剪贴板导入或扫描二维码添加配置。若要接管 Mac 全局浏览器的网络请求，请在菜单中勾选“设为系统代理”。详细的路由规则设定，请阅读完整的v2rayn配置说明。
macOS 环境常见问题排查
针对苹果系统特有机制，收集整理了高频的疑难解答。
Q1：为什么勾选“系统代理”后，Safari 浏览器仍然无法正常访问？
这通常是因为 macOS 系统的网络代理权限未正确应用。请打开“系统偏好设置” > “网络”，选择当前连接的网络（Wi-Fi 或以太网）点击“高级” > “代理”，确认 Web 代理 (HTTP) 和安全 Web 代理 (HTTPS) 是否已被 v2rayn客户端 成功勾选并填入本地端口（默认为 10809 或 1080）。如果未生效，可尝试手动勾选并保存。
Q2：提示端口被占用 (Port Already in Use) 怎么办？
这说明您设定的本地监听端口（如 10808）正被其他程序使用。您可以在主界面的“参数设置”中，将本地 Socks 端口修改为其他空闲数字（例如 10810），保存后重启核心即可解决。
Q3：如何彻底卸载 Mac 版？
除了将应用程序文件夹中的主程序拖入废纸篓外，建议您清理配置文件以防止影响后续重装。前往 Finder，按下 Cmd + Shift + G，输入 ~/Library/Application Support/，找到并删除与 v2rayn 相关的配置文件夹即可实现纯净卸载。
Q4：系统休眠唤醒后，连接突然断开无响应？
macOS 休眠机制可能会挂起后台网络进程。遇到此问题，建议在菜单栏点击图标，选择“重启内核”或切换一下节点，通常即可迅速恢复。更多网络连通性排查，请前往查阅v2rayn常见问题解答页面。
Q5：如何让终端 (Terminal) 也能走代理？
勾选系统代理仅对浏览器及部分遵循系统代理的 App 有效。对于终端命令（如 curl, git, brew），您需要在终端环境临时设置环境变量。可以在终端输入 export http_proxy=http://127.0.0.1:10809;export https_proxy=http://127.0.0.1:10809;（请替换为您实际设置的 HTTP 端口）。