适合第一次在 Windows 或 macOS 上配置 v2rayN 的读者。先让客户端和核心正常启动,再导入订阅、选中一个节点并核对监听端口,最后开启系统代理,用同一个应用做开关对照。遇到问题时,先确定故障发生在哪一步,再改对应的设置。
安装包、解压目录与运行环境
按操作系统和处理器架构选包。x64 对应 64 位 Intel 或 AMD 处理器,ARM64 对应 Windows ARM 设备或搭载 Apple 芯片的 Mac。系统是 64 位,不等于处理器是 x64。下面以 v2rayN 7.x 的常见界面为例;不同小版本或构建的菜单文字和位置可能略有变化。
- Windows:打开「设置」→「系统」→「关于」,查看「系统类型」。压缩包要完整解压,例如放到有写入权限的
D:\Tools\v2rayN,再启动v2rayN.exe。不要在压缩包预览窗口里双击,也不要只把主程序拖到桌面:配置和随包提供的核心可能需要从原目录读取。 - macOS:打开苹果菜单 →「关于本机」,查看「芯片」或「处理器」。Apple 芯片选 ARM64,Intel 处理器选 x64。若拿到磁盘映像,打开后按包内说明把应用拖到「应用程序」;若拿到压缩包,先完整解包再移动应用。遇到系统安全提示,先确认下载来源与提示内容,不要为了启动应用而全局关闭系统保护。
- 运行环境:如果 Windows 报缺少 .NET,先读提示中的框架名、主版本和架构。比如提示明确要求 x64 的
Microsoft.WindowsDesktop.App 8.0,就安装 8.0 系列的 x64 .NET Desktop Runtime,而不是只装普通运行时。若选的是自包含构建,通常不用另装对应的 .NET 运行时;能打开主窗口也不代表代理核心已经启动。
核心类型:按节点要求选择
v2rayN 是桌面客户端,代理核心负责读取节点配置并建立连接。判断依据是节点实际使用的协议、传输和安全设置,不是订阅分组的名字。例如,VLESS 是协议,REALITY 是安全配置的一部分,不能在核心下拉框里把这两个名字当作核心来找。
首次安装的两种选择
Xray 核心
推荐如果服务端明确给出 VLESS、REALITY 和 Vision 流控,优先按服务端要求使用 Xray。导入后保留原有字段,不要把普通 TLS 节点手动改成 REALITY 节点。
适合:节点明确要求 Xray,或订阅中包含依赖 Xray 特性的配置。
V2Ray 核心
如果提供方注明使用 V2Fly 的 V2Ray 核心,按其文档核对协议和传输。VMess 搭配 WebSocket 和 TLS 并不意味着必须换核心;只有客户端提供该选项、核心已就绪且配置受支持时,才考虑切换。
适合:提供方有明确的 V2Ray 核心配置说明,需要按说明复现的节点。
首次导入订阅并启用系统代理
订阅地址用于获取节点列表,不等于单条节点链接。先准备服务方给出的订阅地址和分组名称。首次测试只选一个节点,不同时调整 DNS、路由和 TUN,这样日志出现错误时更容易判断是哪一项引起的。
从空列表到连接验证
新建订阅分组
在主窗口打开「订阅分组」→「订阅分组设置」,添加分组,填写备注和订阅地址并保存。部分版本在分组栏提供「+」入口。粘贴时核对地址是否完整,尤其别删掉问号后的参数;这些参数可能包含访问凭据,不要发到公开截图里。
更新当前订阅
选中新建分组,在「订阅分组」菜单找「更新当前订阅」对应项。没有可用代理时,先选「不通过代理」的更新方式;更新后回到该分组,确认列表中确实出现了节点。更新成功只说明客户端获取并解析了列表,不代表其中的节点已经连通。
设为活动节点
在列表里右击一个节点,选择「设为活动服务器」,确认主窗口显示的活动节点与刚才所选一致。需要核对默认核心时,进入「设置」→「参数设置」→「Core 类型设置」查看对应协议;如果版本还允许单节点指定核心,也要核对该节点的设置。
确认本地监听
查看主窗口状态栏和日志,再到「设置」→「参数设置」查看本地监听设置。若当前显示混合端口为
10808,后续就检查这个端口;若显示其他值,以实际值为准。日志出现端口占用或核心启动失败时,先修好监听,不要急着开启系统代理。开启代理验证
在系统托盘菜单或主窗口的「系统代理」入口选择「自动配置系统代理」。用一个遵循系统代理设置的浏览器打开测试页面,同时看客户端日志是否有对应请求。若切换前后网页都能打开,再核对路由结果:请求出现在日志里,不等于它一定由当前节点转发。
本地端口与系统代理核对
本地监听地址是应用把请求交给 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 后,为什么浏览器断网了?
检查系统代理是否仍指向本机端口,也检查浏览器是否手动设置了代理。若残留的是本次测试写入的配置,可重新打开客户端并选择「清除系统代理」,再退出验证;如果电脑原先有单位或学校的代理设置,按测试前的记录恢复,不要直接覆盖。