· 入门指南 · 约 8 分钟

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

解压目录、运行环境、核心类型选择、本地端口、系统代理与首次导入订阅,按顺序列出 v2rayN 初次上手的必改设置,附新手最常踩的几个坑。

本文速览

适合第一次在 Windows 或 macOS 上配置 v2rayN 的读者。先让客户端和核心正常启动,再导入订阅、选中一个节点并核对监听端口,最后开启系统代理,用同一个应用做开关对照。遇到问题时,先确定故障发生在哪一步,再改对应的设置。

安装包、解压目录与运行环境

按操作系统和处理器架构选包。x64 对应 64 位 Intel 或 AMD 处理器,ARM64 对应 Windows ARM 设备或搭载 Apple 芯片的 Mac。系统是 64 位,不等于处理器是 x64。下面以 v2rayN 7.x 的常见界面为例;不同小版本或构建的菜单文字和位置可能略有变化。

核心类型:按节点要求选择

v2rayN 是桌面客户端,代理核心负责读取节点配置并建立连接。判断依据是节点实际使用的协议、传输和安全设置,不是订阅分组的名字。例如,VLESS 是协议,REALITY 是安全配置的一部分,不能在核心下拉框里把这两个名字当作核心来找。

首次安装的两种选择

Xray 核心

推荐

如果服务端明确给出 VLESS、REALITY 和 Vision 流控,优先按服务端要求使用 Xray。导入后保留原有字段,不要把普通 TLS 节点手动改成 REALITY 节点。

适合:节点明确要求 Xray,或订阅中包含依赖 Xray 特性的配置。

V2Ray 核心

如果提供方注明使用 V2Fly 的 V2Ray 核心,按其文档核对协议和传输。VMess 搭配 WebSocket 和 TLS 并不意味着必须换核心;只有客户端提供该选项、核心已就绪且配置受支持时,才考虑切换。

适合:提供方有明确的 V2Ray 核心配置说明,需要按说明复现的节点。

首次导入订阅并启用系统代理

订阅地址用于获取节点列表,不等于单条节点链接。先准备服务方给出的订阅地址和分组名称。首次测试只选一个节点,不同时调整 DNS、路由和 TUN,这样日志出现错误时更容易判断是哪一项引起的。

从空列表到连接验证

  1. 新建订阅分组

    在主窗口打开「订阅分组」→「订阅分组设置」,添加分组,填写备注和订阅地址并保存。部分版本在分组栏提供「+」入口。粘贴时核对地址是否完整,尤其别删掉问号后的参数;这些参数可能包含访问凭据,不要发到公开截图里。

  2. 更新当前订阅

    选中新建分组,在「订阅分组」菜单找「更新当前订阅」对应项。没有可用代理时,先选「不通过代理」的更新方式;更新后回到该分组,确认列表中确实出现了节点。更新成功只说明客户端获取并解析了列表,不代表其中的节点已经连通。

  3. 设为活动节点

    在列表里右击一个节点,选择「设为活动服务器」,确认主窗口显示的活动节点与刚才所选一致。需要核对默认核心时,进入「设置」→「参数设置」→「Core 类型设置」查看对应协议;如果版本还允许单节点指定核心,也要核对该节点的设置。

  4. 确认本地监听

    查看主窗口状态栏和日志,再到「设置」→「参数设置」查看本地监听设置。若当前显示混合端口为 10808,后续就检查这个端口;若显示其他值,以实际值为准。日志出现端口占用或核心启动失败时,先修好监听,不要急着开启系统代理。

  5. 开启代理验证

    在系统托盘菜单或主窗口的「系统代理」入口选择「自动配置系统代理」。用一个遵循系统代理设置的浏览器打开测试页面,同时看客户端日志是否有对应请求。若切换前后网页都能打开,再核对路由结果:请求出现在日志里,不等于它一定由当前节点转发。

本地端口与系统代理核对

本地监听地址是应用把请求交给 v2rayN 的入口;订阅里的服务器地址和端口是核心连接远端用的。两者不能互填。首次使用保持仅本机监听,不开启「允许来自局域网的连接」。

两处设置的核对值

客户端监听

本机地址
127.0.0.1
混合端口示例
10808,以界面为准
局域网访问
关闭
异常线索
address already in use 表示监听地址和端口已被占用

混合端口可接收 HTTP 和 SOCKS 请求;若界面分别列出两种端口,按应用所选的代理类型填写对应值。

系统代理

Windows 检查入口
「设置」→「网络和 Internet」→「代理」
macOS 检查入口
「系统设置」→「网络」→ 当前网络服务 →「详细信息」→「代理」
浏览器测试
使用系统代理设置,不同时启用单独的浏览器代理规则
退出前
在客户端选择「清除系统代理」,必要时恢复先前记录的设置

系统代理只影响遵循该设置的应用。退出前清理,可避免应用继续向已停止的本地端口发请求。

常见故障:按现象定位

先记下失败发生的时间、活动节点和本地端口,再复现一次。区分三件事:订阅能否下载、核心是否监听、应用的请求是否按预期发出。每次只改一项,改完用同一应用访问同一页面,才能看出设置有没有生效。

首次配置常见问答

订阅提示更新成功,为什么还是空列表?

先选中刚更新的分组并清空列表搜索条件,再核对更新的是当前分组还是其他分组。如果日志显示解析失败,向提供方确认该地址返回的是 v2rayN 支持的订阅格式,而不是登录页或账户页;反馈时只提供脱敏后的报错。

订阅更新超时,要切成通过代理吗?

先验证当前网络能正常打开普通网页,再核对订阅地址和客户端日志。如果手头已有经验证可用的活动节点,可试「通过代理」更新,并保留两次结果对比。刚安装、列表里还没有节点时,切换更新方式不能凭空建立代理,应先向提供方确认地址的访问条件。

端口占用,能直接换成 10818 吗?

可以先查是否有重复运行的实例;正常退出旧实例后重试。如果原端口需要留给其他应用,且 10818 未被占用,可以把混合端口改为该值并重新加载核心,再让 v2rayN 重新应用系统代理。以前手工填写过端口的应用也要改,否则仍会连接旧端口。

网页提示连接被拒绝,是节点失效了吗?

先看报错指向哪里。若被拒绝的是 127.0.0.1:10808,先核对核心是否启动、应用填的端口是否与当前监听一致。若客户端已收到应用请求,而日志显示连接远端失败,再核对节点地址、端口和当前网络。不要把本地入口的错误当成远端故障。

退出 v2rayN 后,为什么浏览器断网了?

检查系统代理是否仍指向本机端口,也检查浏览器是否手动设置了代理。若残留的是本次测试写入的配置,可重新打开客户端并选择「清除系统代理」,再退出验证;如果电脑原先有单位或学校的代理设置,按测试前的记录恢复,不要直接覆盖。

客户端下载