v2rayN 首次安装设置清单:Windows 与 macOS 通用要点和常见坑

从解压目录、运行环境、首次启动权限讲到本地端口与核心类型选择,汇总 Windows 和 macOS 首次运行 v2rayN 最容易踩的几处设置。

本文速览

第一次在 Windows 或 macOS 上用 v2rayN,按三个结果验收:主窗口能打开、选中的节点能通过本地代理发出请求、浏览器能接收系统代理设置。在前一项通过之前,先不动后一项;这样遇到闪退、订阅为空或浏览器不通,就知道该查哪一层。

安装包、解压目录和首次启动权限

先分清桌面程序和代理核心。双击后连主窗口都没出现,优先查安装包、运行环境或系统提示;主窗口能打开,但选中节点后日志报错,才去查核心文件、节点参数和端口。下文菜单以 v2rayN 7.x 中文界面的常见名称为例,小版本的标签和按钮位置可能不同。

导入一个订阅,先验证一条节点

添加订阅地址只保存了更新入口,不等于节点已经拉取成功。首次设置先用一个来源、一个节点,把订阅更新、核心启动、系统代理分开验证。订阅地址可能含有账户令牌,发截图前遮住完整地址,也要检查日志里有没有打印它。

  1. 添加订阅分组

    打开主界面「订阅分组」→「订阅分组设置」,在窗口中点「添加」。备注写上自己能识别的来源,在可选地址栏粘贴完整订阅地址并保存。若拿到的是以 vmess:// 或 vless:// 开头的单条分享链接,应从「服务器」菜单使用剪贴板导入功能,不要把它填成订阅地址。

  2. 更新当前分组

    回到主窗口选中新分组,在「订阅分组」菜单选择更新当前订阅,首次可先用不通过代理的更新选项。查看日志是否拉取成功,再看该分组是否出现节点。订阅能更新只说明列表能取回来,不代表其中任一节点已经连通。

  3. 选中活动节点

    在列表中右键一条已知可用的节点,选择「设为活动服务器」。单击一行一般只是选中列表项,不能据此判断核心已经切换。切换后看主界面当前节点和日志,确认没有核心启动失败或端口绑定错误。

  4. 核对本地端口

    打开「设置」→「参数设置」,查看「v2rayN 设置」中的本地监听端口。先记下实际值,用下文的显式代理请求验证。不要在这一步同时切节点、换路由规则或启用 TUN,否则请求失败时很难判断是哪个设置导致的。

核心类型按节点参数选

v2rayN 是桌面客户端,Xray 和 V2Ray 是处理连接的核心。打开「设置」→「参数设置」→「Core 类型」,这里通常按配置类型选择核心,并不是把任意节点都统一转换成某个协议。订阅导入后先保留原参数;只有日志明确指出配置不受支持时,才核对核心选择和版本。

Xray 内核

推荐

导入的是 VLESS + REALITY 配置时,优先按服务端说明用 Xray。传输方式、安全选项和 Flow 必须与服务端匹配;节点没填 Flow,不要为了照抄示例自行补上。遇到不识别的选项,先查看日志里启动的是哪个核心、版本是多少。

适合:订阅明确提供 VLESS + REALITY,或服务端说明指定 Xray。

V2Ray 内核

如果当前客户端提供此项,且管理员明确给出了适用的 V2Ray 版本和 VMess 配置,可以按说明选择。VMess + WebSocket + TLS 配置中的路径和服务器名称要按原值保留;仅仅把核心换成 V2Ray,不能修正填错的路径或证书名称。

适合:已有明确的 V2Ray 服务端配置说明,需要按原配置接入。

本地监听端口与系统代理分开验收

节点详情里的服务器端口是远端连接信息,浏览器或终端使用的则是本机监听端口,两者不是同一个设置。下面用 10808 举例:只有参数设置与日志确认该端口接受 HTTP 代理请求时,才能原样运行示例;如果显示的是 SOCKS 专用端口,就按右卡的方式测试。首次调试只在本机使用,别为了排错打开「允许来自局域网的连接」。

HTTP 或混合监听

本机地址
127.0.0.1
示例端口
10808,替换为实际 HTTP 或混合端口
代理地址
http://127.0.0.1:10808

目标网址即使使用 HTTPS,普通本机 HTTP 代理地址仍以 http:// 开头。

SOCKS 监听

本机地址
127.0.0.1
示例端口
10808,替换为实际 SOCKS 或混合端口
代理地址
socks5h://127.0.0.1:10808

这是 curl 可识别的写法,表示让代理端解析目标主机名;不要填进系统设置的 HTTP 代理栏。

保持系统代理暂时关闭、TUN 未启用,用显式代理发一个普通网页请求。Windows PowerShell 用 curl.exe,macOS 终端把命令开头换成 curl。下面的连接超时是 5 秒、请求总时限是 15 秒,都是给本次诊断设的上限,不是性能指标。

curl.exe --proxy http://127.0.0.1:10808 --noproxy "" --connect-timeout 5 --max-time 15 -I https://example.org/

首次设置失败的常见问题

订阅更新提示超时,列表还是空的?

先看日志失败的是订阅域名的解析、连接还是服务器响应。确认地址没粘贴错、分组没选错;如果返回 401 或 403,向订阅提供者确认令牌和访问权限。如果是连接超时且已经有一条确认可用的节点,再尝试「通过代理」更新。手上没有可用节点时,反复切这个选项不会凭空建立连接。

网页能打开,为什么终端还是直连?

浏览器可能读取了系统代理,而终端程序未必读取同一设置。先用上面的 --proxy 为单次请求指定代理。若单次请求能走通,再查所用工具是否支持 HTTPS_PROXY,以及 NO_PROXY 是否把目标排除在外;别一开始就把变量写进全局启动配置。

重启后订阅和设置怎么都没了?

核对快捷方式指向的程序路径,看是否误开了另一份解压目录。先退出客户端,把当前版本保留在一个固定且可写的位置,再打开、修改一项容易辨认的设置并重启确认。若日志提示写入失败,修正目录权限或换用当前账户可写的位置。

退出后全机都打不开网页,是不是要重装?

先检查系统代理是否还指向 127.0.0.1 上已经关闭的监听端口。能启动客户端就用「清除系统代理」再退出;启动不了就到系统的代理设置里撤销这次测试写入的值。有办公网络预设时按之前记录恢复,不要顺手清空其他代理项。

下载 v2rayN