本文适合首次在 Mac 上安装 v2rayN,或遇到应用打不开、系统代理未生效的用户。按处理器架构选包,将应用放入「应用程序」,再通过系统提供的单应用放行入口启动;随后分别核对本地监听、系统代理和按需出现的网络权限。Gatekeeper 放行不等于代理连接成功,管理员授权也不等于需要关闭系统安全功能。
安装包选择:先看芯片,再看系统要求
打开屏幕左上角 Apple 菜单 →「关于本机」。显示「芯片 Apple M…」的设备选择 Apple Silicon,也就是 ARM64 架构;显示「处理器 Intel…」的设备选择 Intel,也就是 x64 架构。不要凭机身外观或购买年份判断,同一产品名称可能包含不同处理器。
Apple Silicon 原生包
推荐供 Apple 芯片设备使用,下载项通常以 arm64 标识。推荐指 Apple 芯片设备优先使用对应的原生架构,而不是让所有 Mac 都选择这个包。
适合:关于本机显示 Apple 芯片的 Mac。
Intel 原生包
供 Intel 设备使用,下载项通常以 x64 标识。Intel Mac 不能运行 ARM64 包;Apple 芯片上运行部分 Intel 程序可能需要 Rosetta,但不应把转译作为首次安装的默认路线。
适合:关于本机显示 Intel 处理器的 Mac。
通过客户端下载页选择 macOS 入口,并核对该次发行注明的最低系统要求。macOS 使用对应的桌面应用包,不选择 Windows WPF 包。若系统提示需要 Rosetta,而设备使用 Apple 芯片,先返回核对下载架构;应用本体与随包内核也应保持匹配,避免混入旧目录里的其他架构可执行文件。
- 压缩包先完整解压,再将应用移入「应用程序」;磁盘映像则先打开,再将其中的应用拖入「应用程序」。
- 退出旧版后再替换应用,首次启动不要直接运行压缩预览或磁盘映像里的临时副本。
- 更新前使用客户端提供的备份或导出功能保存设置;不要将含订阅地址的备份上传到公开位置。
Gatekeeper 拦截:使用「仍要打开」单独放行
「无法验证开发者」或「Apple 无法检查其是否包含恶意软件」属于应用信任检查提示,不是节点、DNS 或订阅故障。先确认文件来自预期发布渠道,再使用系统为该应用提供的例外入口。以下路径适用于采用「系统设置」界面的 macOS;不同系统版本的提示措辞可能略有变化。
-
首次打开
在「访达」→「应用程序」中双击 v2rayN。若被安全检查拦截,读清提示后关闭对话框,保留这次启动记录。
-
进入安全设置
打开 Apple 菜单 →「系统设置」→「隐私与安全性」,向下找到「安全性」区域,核对被阻止的应用名称是否为刚才打开的 v2rayN。
-
单独放行
点击该条记录旁的「仍要打开」。系统要求时使用 Touch ID 或管理员账户确认,再在随后的确认框中选择「打开」。
-
检查主界面
应用启动后先查看主界面和日志,确认没有内核启动失败。能够打开窗口只说明应用已获准运行,还需要继续检查代理监听与网络设置。
部分旧版 macOS 可以通过「访达」中按住 Control 点按应用 →「打开」触发例外确认,但较新的系统不一定保留这条放行路线。优先使用「隐私与安全性」中的入口。本文不需要关闭整机 Gatekeeper,也不需要关闭系统完整性保护。
首次联网:分清本地端口与系统代理
在 v2rayN 主界面导入自己的订阅,更新后选择一个有效节点作为活动服务器。先查看「设置」→「参数设置」中的本地监听端口,再从主界面或菜单栏图标的「系统代理」菜单选择「自动配置系统代理」。不同桌面发行的入口位置可能不同,应以当前界面实际显示的同名设置为准。
下面使用 127.0.0.1:10808 演示一个支持 HTTP 代理的本地监听;它不是对所有发行默认端口的承诺。如果当前客户端显示其他端口,或 HTTP 与 SOCKS 分开监听,必须把系统的网页代理指向实际 HTTP 入口,不能照抄示例。
启用后打开「系统设置」→「网络」→ 当前使用的 Wi-Fi 或以太网服务 →「详细信息」→「代理」。如果使用手动 HTTP 系统代理方式,检查「网页代理(HTTP)」和「安全网页代理(HTTPS)」是否指向相应的本机地址、端口。这里的 HTTPS 代理设置表示 HTTPS 请求通过该 HTTP 代理建立隧道,不表示本地入口本身必须启用 TLS。
客户端监听示例
- 监听地址
- 127.0.0.1
- 监听端口
- 10808
- 入口能力
- 支持 HTTP 代理
- 活动服务器
- 已选中的有效节点
先确认日志显示内核启动成功;示例数值必须替换为本机实际设置。
系统代理核对示例
- 网页代理
- 127.0.0.1:10808
- 安全网页代理
- 127.0.0.1:10808
- 代理认证
- 仅按本地入口配置填写
- 生效服务
- 当前联网的网络服务
若客户端配置的是 PAC,检查自动代理配置地址,不要再叠加不明来源的手动代理。
系统代理只影响遵循这一设置的应用。浏览器可访问而某个命令行工具仍直连,并不自动说明授权失败;该工具可能需要独立的代理参数。反过来,系统设置显示代理已开启也不能证明内核正在监听,两者需要分别核对。
网络授权:管理员、本地网络与 TUN 分开判断
macOS 没有一个必须统一打开的「允许所有代理流量」开关。出现权限提示时,先看请求来自哪个程序、要改变什么设置。普通系统代理、本地网络发现、虚拟网卡接管的作用不同,不应为了网页打不开而把所有权限全部开启。
| 提示或入口 | 实际用途 | 处理方式 |
|---|---|---|
| 管理员账户确认 | 修改受保护的网络设置或安装必要的辅助组件 | 核对请求进程与操作,确认是刚执行的客户端动作后授权;不要将密码填进订阅或节点表单。 |
| 隐私与安全性 → 本地网络 | 控制应用访问局域网设备等本地网络资源 | macOS 15 及后续系统可能出现相关请求。仅在确有局域网功能需要时允许,不把它等同于互联网访问总开关。 |
| TUN 相关提权 | 创建虚拟网络接口、调整路由或 DNS | 仅在当前发行提供该功能且确实需要接管不遵循系统代理的应用时启用,按客户端说明完成授权。 |
| 网络 → 防火墙 | 管理传入连接 | 本机代理出站失败通常不靠关闭防火墙解决;只有明确需要其他设备连入时才检查相应入站规则。 |
若「本地网络」列表没有 v2rayN,并不代表安装缺失。列表通常在应用触发相应访问请求后才出现,单纯通过回环地址使用本机代理不应据此判定必须补授权。受管理的工作电脑则可能由组织策略控制网络扩展或代理设置,应由管理员处理,不要自行移除管理配置。
连接排查:先查监听,再查当前网络服务
出现「系统代理已开启,但网页仍打不开」时,按本机入口、系统设置、远端连接的顺序排查。先退出其他正在改写系统代理的工具,避免两个程序轮流覆盖设置。以下命令只读取状态,不修改系统配置;在「应用程序」→「实用工具」→「终端」执行即可。
# 查看示例端口是否存在 TCP 监听
lsof -nP -iTCP:10808 -sTCP:LISTEN
# 列出网络服务,确认实际使用的服务名称
networksetup -listallnetworkservices
# 以下以服务名称 Wi-Fi 为例
networksetup -getwebproxy "Wi-Fi"
networksetup -getsecurewebproxy "Wi-Fi"
networksetup -getautoproxyurl "Wi-Fi"
- 没有监听输出:返回 v2rayN 日志检查内核是否退出、端口是否不同。出现端口被占用时,先定位占用进程或在客户端调整端口,再重新配置系统代理。
- 系统指向旧端口:先在客户端清除系统代理,再重新自动配置;若手动修改,确保当前联网服务的两项网页代理同步更新。
- 查询服务名报错:将命令中的
Wi-Fi替换为列表里真实的网络服务名称,名称带空格时保留英文双引号。 - 监听与系统设置正确:查看日志中的远端连接、TLS 或域名解析错误。超时可能涉及服务器不可达,证书错误应检查系统时间和节点 TLS 参数,不要以跳过证书验证替代排查。
也可以使用下面的请求单独测试本地 HTTP 代理。它显式指定代理,不依赖系统代理开关;将示例端口改为实际端口。目标为本站首页,结果受当前网络、节点和目标站状态影响,不应把一次请求的成败当作全部应用的结论。
curl --proxy http://127.0.0.1:10808 --head --max-time 15 https://v2raydns.com/
若提示无法连接 127.0.0.1,优先检查本地监听;若已连入本机但远端请求失败,再检查活动节点与日志。若显式代理请求成功而浏览器失败,检查浏览器是否有独立代理配置、旧 PAC 或扩展覆盖。不要在本地入口尚未工作时反复修改 DNS。
常见问题:启动放行后仍需检查哪些项目
为什么没有「仍要打开」按钮?
先从「应用程序」再次尝试启动,再立即查看「系统设置」→「隐私与安全性」下方的安全性区域。确认提示确实属于开发者验证,而非恶意软件拦截或组织策略。如果仍无入口,记录系统版本和完整提示,不要改成关闭整机安全检查。
已经允许打开,为什么日志仍提示权限不足?
Gatekeeper 只处理应用运行信任。查看报错对应的是内核执行、配置目录写入还是 TUN 提权;确认应用已完整移入「应用程序」,且当前账户能写入客户端实际使用的配置目录。不要用管理员身份启动整个桌面程序来掩盖目录权限问题。
切换 Wi-Fi 后代理失效,要重新授权吗?
先检查当前网络服务的「详细信息」→「代理」。从 Wi-Fi 换到有线网络可能切换到另一服务,其代理配置未必相同。在 v2rayN 重新执行自动配置系统代理,再核对地址与端口;不要把网络服务差异误判成 Gatekeeper 再次拦截。
退出客户端后整个浏览器都不能联网怎么办?
启动 v2rayN,在「系统代理」中选择「清除系统代理」后再退出;如果应用已无法启动,到当前网络服务的「代理」页面关闭指向本机旧端口的网页代理或停用旧 PAC。只清理属于该客户端的设置,单位网络要求的代理应先咨询管理员。
安装收尾:保留可回退的网络状态
完成配置后,至少验证一次「启动客户端 → 开启系统代理 → 正常访问 → 清除系统代理 → 退出客户端」的完整流程。这样可以确认成功来自实际监听和正确设置,而不是浏览器缓存或残留的其他代理。更新应用、更换节点或启用 TUN 时,每次只改一类设置,出现问题才容易定位。
- 保留本机实际监听端口与当前联网服务名称,供下次对照;不要把订阅地址写进公开排查截图。
- 分享日志前隐藏服务器地址、用户标识、订阅令牌等敏感信息,只保留错误类型与必要上下文。
- 卸载前先关闭 TUN(若已启用)并清除系统代理;删除应用本身不能保证网络设置同时恢复。
- 需要继续了解导入订阅和 DNS 设置时,按入门教程逐项配置,不同时改动内核、路由和解析策略。