v2rayN Mac 梯子教程:装包与订阅配置检查
v2rayN Mac 教程共 13 步:依芯片选择 dmg、放行“已损坏”提示、建立订阅分组、测定速度选节点,再启用系统代理自动配置。逐项标出 Mac 版 7.24.9 更名的菜单。
开始之前
- 一台装着 macOS 13.6 或更高版本的 Mac(这是官方发布文件说明里给的最低要求),Apple 芯片、Intel 芯片各有安装包
- 机场给的订阅地址,用户中心里可以复制
- 网络能访问 GitHub,能下完一个约 120 MB 的 dmg
- 知道这台 Mac 的登录密码,之后开启 Tun 模式会用到
Mac 上的 v2rayN
7.24.9· 11 月 16 日核对
操作步骤13 步
步骤目录
第 1 步:看芯片选 dmg
打开 GitHub 上 v2rayN 官方仓库的 Releases 页面,找标着 Latest 的正式版;标 Pre-release 的 7.25.x 是预发布版,不选。先点左上角苹果菜单 →“关于本机”:芯片显示 Apple M 系列的,下载 v2rayN-macos-arm64.dmg(118.6 MB);处理器显示 Intel 的,下载 v2rayN-macos-64.dmg(124.9 MB)。名字相同的 .zip 是免安装版,.sig 是签名,这里都不需要。
第 2 步:拖到应用程序,再解除拦截
双击打开 dmg,把弹出窗口里的 v2rayN 拖进“应用程序”。官方的发布文件说明讲得很清楚:dmg 没做签名,第一次打开时 macOS 会提示“应用已损坏”,此时选“取消”,千万别选移到废纸篓。接着用 Spotlight 搜出“终端”,输入 xattr -cr /Applications/v2rayN.app 回车,什么都不显示就是成功了,然后回“应用程序”重新双击 v2rayN。
第 3 步:找到图标后打开
在“应用程序”里认准这个图标:蓝色圆底,正中一个带深色阴影的白色 V,双击打开。照 7.24.9 源码里的默认设置,Mac 版不会在 Dock 上出现,只在屏幕顶端的菜单栏放一个图标;主窗口被别的窗口盖住时,点它选“显示主界面”。想放进 Dock,就去设置 → 参数设置的“v2rayN 设置”页,打开“macOS 在 Dock 栏中显示(需重启)”。
第 4 步:先认一认初次打开的界面
Windows 版 6.33 头一回启动时,上方一行按钮,最左是“服务器”,最右是“关闭”;节点列表空空如也,信息区正在拉 geoip 文件,进度走完会提示成功,右下角则是“请先检查服务器设置”的提示。到了 7.24.9,Mac 版用 Avalonia 重写了界面,顶部变成配置项、订阅分组、设置、帮助、重启服务、推广、退出这几个,接下来要点的“订阅分组”叫法没变。
第 5 步:展开订阅分组的菜单
机场的订阅地址都归在订阅分组里管。点顶部的“订阅分组”(图中红色箭头所指),应当会弹出一个下拉菜单。要是误点了旁边的“设置”,会展开另一套菜单,在空白处点一下关掉,再去点“订阅分组”。
第 6 步:进入订阅分组设置
下拉菜单一共五项:最上面独立的一项是“订阅分组设置”,分隔线以下四项用来更新订阅,到第 9 步才用。点“订阅分组设置”,会弹出一个同名的小窗口。
第 7 步:新建订阅分组
弹出的窗口上方一排五个按钮——添加、删除、编辑、分享、关闭;下方表格最左列为别名、最右列为排序,初次打开里面什么也没有。点左上角的“添加”,就进入填写表单。以后机场换了订阅地址,同样回这里选中那行改。
第 8 步:填好订阅地址再保存
别名随便起一个自己能认出来的。把订阅地址粘贴到“可选地址(Url)”里,Mac 上的粘贴快捷键是 Command+V。“启用更新”保持开启;自动更新间隔(分钟)设成了 1440,也就是每 24 小时拉一次。User Agent 及以下三栏,框内灰字提示普通分组留空,就别填,排序保持 1。点“确定”,订阅分组设置的表格里会多一行;没有多出来,就回头看地址是不是粘全了。
第 9 步:拉订阅时不经过代理
关闭订阅分组设置窗口,回到主界面重新展开“订阅分组”,选分隔线下面的“更新全部订阅(不通过代理)”。写着“通过代理”的两项需要借助已有节点来下载,现在节点列表还是空的,没法用。更新后“所有”旁边会多出一个标签,名字正是上一步填的别名。
第 10 步:核对拉下来的节点
更新结束后,点刚出现的那个分组标签,节点列表会显示订阅里的所有条目,类型、传输协议、TLS 分列显示。前 4 行其实是机场借节点名字发的通知,写着套餐到期时间、剩余流量、最新网址和距下次重置还有几天,用来了解套餐情况;从第 5 行开始、以 HK 开头的才是真正可选的线路。列表还是空的,去看信息区末尾几行的报错。
第 11 步:一次跑完延迟和速度测试
在节点列表上点右键(触控板双指轻点,或按住 Control 单击),先选“全选 (Ctrl+A)”。然后再右键一次,点红框标出的“一键多线程测试延迟和速度 (Ctrl+E)”。正常情况下,延迟(ms) 和速度(M/s) 两列会一行行填上数字。7.24.9 界面上提示,按 ESC 能中途停止。跑完之后,同一个菜单里有“按测试结果排序”可以用。
第 12 步:指定当前使用的服务器
测试结束后延迟列会逐行出结果,开头几行通知条目同样会有数字,挑线路时略过它们。从 HK 开头的行里选一个延迟小的,右键点“设为活动服务器 (Enter)”,或者选中后直接按回车。7.24.9 中这一项的名字是“设为活动”。设好以后,窗口右下角会显示当前节点的类型和别名。
第 13 步:开启系统代理
主窗口最下方有一个叫“系统代理”的下拉框,初始选项是“清除系统代理”,改选“自动配置系统代理”即可;点菜单栏图标弹出的菜单里也能找到同样的选项。读 7.24.9 源码可知,Mac 版此时会跑一段脚本,调用 networksetup 把每一个网络服务的 HTTP、HTTPS、SOCKS 代理都设成 127.0.0.1 加本地端口(默认 10808)。旁边的路由下拉框保持“绕过大陆(Whitelist)”。如果设完没效果,翻到下方常见问题第 2 条。
检查一下节点列表里显示出延迟数值、开启代理后原本上不去的网站能正常访问,到这一步就配置好了。
测试环境与验证
整篇 v2rayN Mac 教程分 13 步:第 1、2 步装程序,第 3 到 12 步导入订阅、挑节点,第 13 步打开系统代理。订阅地址要向机场购买,可以从梯子推荐里挑一家。
测试环境
| 项目 | 记录 |
|---|---|
| Windows 版 v2rayN 6.33,标题栏日期为 2024/02/01 或 2024/10/07;没有记录 Windows 系统版本 | |
| 第 10 到 12 步的日志日期是 2024/10/09 | |
| 当前正式版 | 7.24.9(2026-08-29),2026-09-25 在官方 Releases 页面核对过,7.25.x 属于预发布版 |
| 系统要求 | macOS 13.6 或更高,出处是官方 wiki 的发布文件说明 |
| 本站实操 | 还没有在 Mac 上完整走一遍这 13 步 |
窗口样子、按钮位置可能和你看到的不同;Mac 版菜单名称是对照 7.24.9 源码写的。本站没有做过测速,第 12 步里的延迟以你自己客户端显示的为准。版本号和安装包大小以 v2rayN 客户端页为准。
v2rayN Mac 版和截图对不上的菜单
| 6.33 版的叫法 | 7.24.9 Mac 版的叫法 |
|---|---|
| 顶部的“服务器”按钮 | 配置项 |
| 顶部的“检查更新”按钮 | 并入“帮助”菜单 |
| 关闭 | 退出 |
| 设为活动服务器 (Enter) | 设为活动 (Enter) |
| 左下角 socks 10808 与 http 10809 两个端口 | 统一为混合端口,默认值 10808 |
| “启用 Tun 模式”开关 | 启用 Tun,开之前要输 sudo 密码 |
| 系统代理中的 Pac 模式 | Mac 版没有这一项 |
Tun 模式和系统代理有什么不同,见什么是梯子的 TUN 模式;用 Windows 的看 v2rayN Windows 教程。
做完后怎么验证
- 主界面底部那个下拉框显示“自动配置系统代理”,右下角能看到当前节点的别名。
- 进系统设置 → 网络,点开你正在用的 Wi-Fi 或以太网,再点“详细信息”里的代理:HTTP、HTTPS 网页代理和 SOCKS 代理这三项应当都开着,地址为 127.0.0.1,端口跟主界面左下角那个数一致。
- 在终端里执行
curl -x http://127.0.0.1:10808 https://www.cloudflare.com/cdn-cgi/trace,结果里的 loc 应该是节点所在地;把-x那部分删掉再跑一次,loc 就该是你本地。curl 默认不理系统代理,所以这一项专门用来验证 v2rayN 的端口。
三项全部对得上,只能证明流量已经交给了 v2rayN;快不快、晚上稳不稳、流媒体能不能看,本站都没有数据。如果所有节点都连不上,照梯子全部节点超时怎么查逐项排查。
卸载和还原
卸载顺序:系统代理先改回“清除系统代理”,Tun 也关掉,然后点顶部“退出”,再把“应用程序”文件夹里的 v2rayN 丢进废纸篓,最后到网络设置的代理页看三项是否都已关闭。订阅、日志放在“打开存储所在的位置”对应的文件夹里,删掉程序不会顺带清除,想删干净要手动。其他 Mac 客户端见 Mac 梯子软件目录。
常见疑问
Mac 说 v2rayN 已损坏,让移到废纸篓怎么办?
文件并没有坏,是 macOS 把没签名的程序拦了下来。照官方发布文件说明,先把程序放进“应用程序”,再在终端执行 xattr -cr /Applications/v2rayN.app,然后打开即可。如果程序放在别处,把命令里的路径改成它实际所在的位置。
已经选了自动配置系统代理,浏览器还是不走代理?
去系统设置的网络里,点开当前连接的详细信息,看代理页那三项开没开、服务器是不是 127.0.0.1。没开就说明脚本没执行成功,官方 FAQ 建议去 guiLogs 文件夹翻日志,设置菜单里的“打开存储所在的位置”可以直达它的上一级目录。
Mac 上开 Tun 时为什么要输密码?
7.24.9 在 Mac 上开启 Tun 前会弹一个“系统的 sudo 密码”输入框,填的是这台 Mac 的登录密码。按界面上的说明,密码只交给命令行去校验,不会被保存,所以程序每次重启都得重新输入。如果只是浏览网页,开系统代理就够了。
Mac 上更新完订阅,节点列表还是空的?
先看信息区的最后几行。订阅地址必须从机场用户中心完整复制,结尾的参数少了一截就拉不下来;套餐过期的订阅也可能返回空内容。第一次更新只能选不通过代理那一项,等有了能用的节点,再改用通过代理的选项。
测试完延迟那一列都是 -1?
从 7.24.9 源码看,连不通的节点延迟会显示 -1。先去机场用户中心看套餐和流量还在不在,再重新更新一次订阅。如果还不行,检查 Mac 的时间是否准确:系统设置 → 通用 → 日期与时间,打开自动设定时间——时间偏差太大会导致 VMess 握手和 TLS 证书校验失败。