V2RayN 安装与使用教程

V2RayN 是很多 Windows 用户接触代理客户端时遇到的第一个工具。它的界面信息很多，新手容易在“装哪个包”“订阅放在哪里”“为什么显示连上了却打不开网页”这几步卡住。本文按照实际操作顺序，把一次完整的配置拆成八个站点，每一步只讲必须理解的部分。

V2RayN 是什么

V2RayN（官方仓库写作 v2rayN）是开发者 2dust 维护的开源图形客户端，采用 GPL-3.0 许可证。它本身并不负责加密和转发流量，而是把“节点信息、订阅、路由规则”整理成配置文件，再交给底层核心运行。目前官方说明中支持的核心包括 Xray 与 sing-box，也可以通过自定义配置调用其他核心。

需要先分清一件事：V2RayN 只是客户端，不提供任何节点。 节点来自你自己搭建的服务器，或者你订阅的服务。客户端好不好用，与节点快不快、稳不稳是两个独立的问题。

V2Ray 下载与 V2RayN 的区别

很多人搜索“V2Ray 下载”，真正想要的其实是一个能导入订阅的图形客户端。V2Ray 原本指的是 V2Fly 社区维护的代理核心程序，没有图形界面，需要手写 JSON 配置；V2RayN 则是图形外壳，把核心、订阅和系统代理整合在一起。官方发布包通常已包含部分核心，普通用户先使用包内核心即可；额外核心或自定义配置的要求见官方说明。

适用条件与不适用情况

• 适用：Windows 桌面用户，希望用图形界面管理多个订阅和节点；需要按“国内直连、国外走代理”的方式分流。
• 也可用：macOS 与 Linux 桌面用户（官方已提供对应安装包），不过这两个平台上可选择的客户端更多。
• 手机用户：V2RayN 没有 Android/iOS 版本，改从手机与 Mac 教程选择对应客户端。
• 偏好 YAML 配置与策略组管理：也可以看 Clash 基础教程。

从官方渠道下载 V2RayN

唯一推荐的下载地址是官方 GitHub 的 Releases 页面：github.com/2dust/v2rayN/releases。 网盘、论坛附件里的“中文增强版”“免安装绿色版”无法确认是否被改动过，而代理客户端会处理交给它的网络流量，风险远大于便利。

进入 Releases 页面后，优先选择正式稳定发布，留意是否标注 Pre-release，在 Assets 列表中按系统与处理器架构选择文件。撰写本文时，官方 wiki 对文件命名的说明大致如下（命名可能随版本调整，以官方说明为准）：

系统	常见文件名	说明
Windows x64	v2rayN-windows-64.zip	大多数 Windows 电脑选这个
Windows x64	v2rayN-windows-64-desktop.zip	另一套界面框架（Avalonia）构建，功能相近
Windows ARM	v2rayN-windows-arm64.zip	骁龙等 ARM 处理器的 Windows 设备
macOS	v2rayN-macos-arm64.dmg / v2rayN-macos-64.dmg	分别对应 Apple 芯片与 Intel 芯片
Linux	.deb / .rpm / .zip	按发行版选择对应包管理格式

下载时同时查看该版本提供的签名、校验值或验证说明；如有校验文件，按该版本说明核验，不要把源码压缩包当作可运行程序。如果启动时提示缺少 .NET 运行时，按提示从微软官方网站安装对应版本的 .NET 桌面运行时即可，不要从第三方站点下载“运行库合集”。

macOS 与 Linux 安装说明

macOS 先在“关于本机”确认芯片类型，选择对应 .dmg，安装后按官方说明启动。Linux 根据发行版选择 .deb、.rpm 或便携包；不要把 Windows 的解压运行步骤套用到安装包。当前 wiki 列出的要求包括 macOS 13.6+，Linux 按发行版分别列出版本，安装前应复查官方发布文件说明。

Linux 下载完成后，在文件所在目录执行与包型对应的一条命令。下面文件名按官方 x64 示例；ARM 设备应换成实际下载的 arm64 文件名，不要同时执行三种安装方式：

# Debian / Ubuntu 的 deb 安装包
sudo apt install ./v2rayN-linux-64.deb

# Fedora / Red Hat 的 rpm 安装包
sudo dnf install ./v2rayN-linux-rhel-x64.rpm

# ZIP 便携包：完整解压后，在解压目录运行
chmod +x v2rayN
./v2rayN

安装版从系统应用菜单启动；便携版保持解压目录完整。若出现缺少依赖或无法启动的错误，先保留终端错误并核对发行版要求，不能把安装包改名或换架构当作解决办法。macOS 的 DMG 打开后将应用复制到“应用程序”再启动；若出现未签名或“已损坏”提示，先核对文件来源与该版本的官方处理说明，避免照搬其他应用的修复命令。

后文首次运行以 Windows 便携版为例；其他平台仍按“导入、更新、选节点、启用代理、验证”顺序操作，菜单位置和权限提示可能不同。

首次运行与基础检查

导入订阅并更新

订阅地址是服务商提供的一条 URL，客户端定期访问它来获取最新的节点列表。V2RayN 中订阅相关的功能通常位于“订阅分组”菜单下，不同版本的名称可能略有差异。

如果你拿到的不是订阅地址，而是单条以 vmess://、vless://、trojan://、ss://、hysteria2:// 等开头的分享链接，可以复制后在“服务器”菜单中选择从剪贴板导入。

选择节点并测试延迟

导入成功后，列表里可能有几十个节点。不要只看名称挑选，先测一下延迟。V2RayN 提供多种测试方式，最常用的是 TCPing 和真连接延迟。

测试方式	测试内容	优点	局限
TCPing	本机到节点端口的 TCP 握手	速度快，可快速筛掉完全不通的节点	不验证协议、密钥和出口，结果偏乐观
真连接延迟	经代理完整访问测试地址	最接近实际使用体验	测试耗时较长，受测试地址可达性影响
测速（下载）	经代理下载测试文件	可以看出带宽	消耗流量，结果受时段影响大

挑选节点时有三点值得注意：

• 延迟不等于速度。延迟低的节点不一定带宽大，看视频、下载大文件时还要参考测速结果。
• 多测几次、换几个时段测。晚高峰与白天的结果可能差异很大，单次结果参考价值有限。
• 按用途选择地区。访问某些地区限定的服务时，应选择对应地区的出口，而不是一味追求最低延迟。

选好后，将该节点设为活动服务器（通常可以双击、按回车或在右键菜单中设置），主界面会标记当前正在使用的节点。

设置系统代理

节点选好之后，流量还不会自动经过代理：浏览器等应用需要通过“系统代理”被告知把请求发到 V2RayN 的本地端口。系统代理的开关通常位于主界面底部或系统托盘图标的右键菜单中，一般有三个选项：

选项	作用	适合场景
清除系统代理	删除系统中的代理设置，应用直接连网	暂停使用代理，或退出前恢复网络
自动配置系统代理	把系统代理指向 V2RayN 本地端口	日常使用，绝大多数人选这个
不改变系统代理	V2RayN 不修改系统设置	你打算手动配置或使用浏览器扩展管理代理

需要了解的是，系统代理只对“遵守系统代理设置”的程序生效。很多命令行工具、部分游戏和开发工具需要单独设置。下面用 PowerShell 显式指定代理验证本地端口，避免把终端未读取系统设置误判成节点故障：

# 10808 仅为示例，改为客户端实际显示的 HTTP / 混合端口
curl.exe --proxy http://127.0.0.1:10808 --noproxy "" --max-time 15 -I https://example.com

收到目标网站的 HTTP 响应，只能说明这次通过本地代理端口的请求得到了响应；还应在日志中检查它使用的出站。成功状态码本身不能证明经过境外节点。命令参数含义见 curl 官方手册。

若输出先出现 200 Connection established，那是本地 HTTP 代理同意建立隧道的响应；还要继续看后面的目标站响应，不能在第一行就判定成功。Failed to connect to 127.0.0.1 先查核心是否运行、端口是否一致；已经连接本地端口却出现上游超时或 TLS 错误，再到核心日志检查活动节点。目标站返回 403/404 说明收到了 HTTP 响应，但不代表你需要的登录、内容或地区功能已经可用。

如果某个工具支持 HTTP_PROXY / HTTPS_PROXY，可在当前终端单独设置；不同工具读取这些变量的规则不同，需按工具文档操作。不要为了让一个命令行工具联网，就立刻接管整个系统。

需要覆盖更多应用时，可以了解 TUN。它通过虚拟网卡接收流量，通常涉及额外权限、路由与 DNS 设置；覆盖范围仍受排除规则、系统与应用行为影响，不能保证所有连接。先在系统代理下建立可用基线，再根据代理模式详解决定是否开启。

路由模式：绕过大陆与全局

路由决定“哪些流量走代理、哪些直连”。V2RayN 内置了几套预设规则，常见的有：

• 绕过大陆：国内网站和国内 IP 直接连接，其余流量走代理。日常使用推荐这一项，既能减少不必要的流量消耗，也能避免访问国内服务时绕远路。
• 全局：进入核心的连接按该预设交给代理出站；未接管的应用不因此自动走代理。适合临时排查“是不是规则漏判”的问题，但不建议长期开启。
• 黑名单：默认直连，只有名单内的网站走代理。适合只需要访问少数特定网站的人。

这些规则依赖 geosite、geoip 等数据文件来判断域名和 IP 的归属地。数据文件长期不更新，可能出现新网站被误判的情况，可以在检查更新时一并更新这些数据文件。预设的实际名称与效果以当前版本和配置为准；DNS 和路由配合的原理见DNS 与分流规则。

验证连接，并保留一个可用基线

完成上述设置后，按下面顺序验证，而不是只看延迟数字：

1. 检查活动节点和核心日志。 当前节点已选中，核心没有持续报错；若刚更新订阅，重新确认节点未被删除。
2. 访问实际目标。 在浏览器打开一个需要代理的网站，再访问一个预期直连的网站；检查日志或连接信息中的去向。
3. 区分网页和应用。 浏览器正常但某个应用失败，先看应用是否遵守系统代理、是否有自己的代理设置。可用上面的显式代理命令隔离问题。
4. 观察正常使用。 验证一次页面加载、登录或所需业务；延迟测试不能替代实际用途。测试下载会计入套餐流量，留意节点倍率。
5. 停止后复查原网络。 先清除系统代理，再退出程序，确认浏览器仍能访问普通网站。

把可用节点、路由模式、本地端口、核心版本记下来。之后每次只改一个设置，才容易定位问题。

日常更新、备份与安全退出

订阅更新用来获取服务端变动，不会自动解决所有网络问题。更新前若正在进行会议或下载，先安排合适的时间；更新后检查当前分组、活动节点和测试结果，再做一次网页验证。服务方更换订阅令牌后，要编辑地址并重新更新，而不只是刷新旧链接。

Windows ZIP 便携版按官方说明将数据存放在解压目录。升级前先清除系统代理并完全退出，保存整个现有目录，再把新版本解压到独立目录，按该版本迁移说明恢复配置。macOS/Linux 安装版使用系统用户数据位置，应通过应用提供的数据目录或备份入口查找，不能直接套用便携版路径。备份含订阅和节点凭据，要妥善保存。

换机需要同时恢复订阅来源、额外规则、核心选择、路由模式和必要设置，单条节点链接通常不包含这些内容。新设备验证通过后再处理旧备份。统一步骤见订阅更新与备份指南。

正常停用时先关 TUN（如果启用），再“清除系统代理”，最后退出。如果异常退出后断网，重新打开客户端清除系统代理；仍失败则在系统网络设置中核对是否有遗留代理。公司网络原本有代理时，恢复原值，不要无差别删除。

常见问题的排查入口

配置过程中最常遇到的问题，都已经整理在常见代理连接失败问题一文中，可以直接跳转到对应小节：

• 添加订阅后列表为空或提示失败：V2RayN 导入订阅失败
• 订阅之前正常、现在更新报错：订阅更新失败
• 节点测试正常但浏览器打不开网页：系统代理不生效
• 所有节点都超时或握手失败：时间不同步导致握手失败

排查时一个实用的习惯：每次只改一个设置，改完立即测试。同时改动节点、路由和代理模式，即使问题解决了也不知道是哪一步起了作用。

最后提醒：请在遵守当地法律法规和服务条款的前提下使用代理工具。如果你还想了解另一类更灵活的规则型客户端，下一站是 Clash 基础教程；更多客户端对比可以在代理客户端专题中找到。