- 平台:Windows、Linux、macOS
- 收费:免费
- 授权:公开源代码
当前版本 7.25.6(发布于 2026-10-11)· 在下载中心核对安装包、文件大小与签名校验方式
适合谁
需要Xray、sing-box、Mihomo等多核心或高级协议的桌面用户。
主要优点
- 免费开源并支持多个核心
- 发行文件提供GPG签名
- 协议、路由和高级配置选择较多
主要缺点与限制
- 安装包、界面实现和核心组合较多,新手容易选错
- 跨平台功能可能不同
- 排错时必须区分图形界面、核心和订阅配置三层
先分清 v2rayN 和 v2rayNG
v2rayN 是桌面图形客户端,官方项目当前列出 Windows、Linux 和 macOS;Android 对应的是同一维护组织下的 v2rayNG。手机教程不能直接照搬到桌面端,菜单、VPN权限和流量接管方式都不同。
| 系统 | 官方列出的架构 | 最低系统说明 |
|---|---|---|
| Windows | x64、x86、arm64 | Windows 10 及以上 |
| Linux | x64、arm64、riscv64、loong64 | Debian 9+、Ubuntu 16.04+、Fedora 30+ |
| macOS | x64、arm64 | macOS 11+ |
架构以设备实际 CPU 和操作系统为准;Apple Silicon 通常选 arm64,常见 Intel/AMD 64位电脑通常选 x64,但不要仅凭品牌猜测。
Windows 下载包怎么选
官方发布页提供不同架构与依赖组合。普通 x64 包需要系统具备 .NET 8 Desktop Runtime;自包含包体积较大,但不要求另装对应运行时。部分发布包包含核心,部分不包含,第一次使用应阅读同一版本的发布说明,不要下载页面自动附带的 Source code 压缩包。
- 程序无法启动:先核对架构与 .NET 运行时,不要先怀疑订阅。
- 界面能打开但核心启动失败:检查包内核心、隔离记录和日志。
- Linux/macOS 提示没有执行权限:官方说明压缩包中的可执行文件可能需要添加执行权限;不理解命令时优先选适合系统的软件包。
- 需要内置更新:官方说明部分 .deb 和 AppImage 包不支持程序内更新,应按发布页方式升级。
官方下载与签名核对
只从 v2rayN 官方项目进入 Releases。官方 README 说明发布文件使用 GPG 签名,并公布签名指纹;核验时应把导入密钥的完整指纹与官方 README 逐字比对,再验证下载文件对应的签名。只看到“签名良好”但未核对指纹,仍不能排除导入了错误密钥。
本站不重新打包安装文件,也不提供网盘镜像。下载页域名、发布者、版本号和文件名都应保留,便于以后定位来源。
订阅内容与客户端兼容性
官方订阅说明列出 VMess、Shadowsocks、SOCKS、VLESS、Trojan、Hysteria2、TUIC、WireGuard 和 AnyTLS 等分享格式。服务商声称“支持 v2rayN”不代表所有高级字段都能被当前版本识别;导入为空时,要区分链接获取失败、返回内容为空、内容格式不受支持和核心加载失败。
订阅地址属于敏感凭据。排错截图要遮住完整 URL、二维码、令牌和节点认证信息;泄露后应在服务方后台重置,而不是只删除截图。
v2rayN 从安装到正常退出
Windows 为主 / Linux / macOS
开始前先检查
- 确认下载的是发布文件而不是 Source code
- 按 Windows、Linux、macOS 与 x64/arm64 选择正确包
- 记录 GUI 版本和当前核心版本,排错时两者要分开
下载包不要选错
在官方 Releases 中先确认系统和 CPU 架构。普通 Windows 用户不要下载 Source code;若压缩包不包含核心,需要按官方说明补充核心组件。保留下载来源与版本号,便于排错。
建立订阅分组
打开订阅分组设置,新建分组,填写容易辨认的备注与服务方提供的 URL。保存后执行“更新全部订阅”,确认服务器列表出现内容,而不是只看到分组名称。
设置活动服务器
在服务器列表中选中节点并设为活动服务器,再检查状态栏显示的本地端口。首次测试使用系统代理即可;同时运行其他代理客户端会造成端口或接管冲突。
路由与模式
新手先保留默认路由。需要区分国内外流量时再使用官方提供的路由设置;修改前记录原值。全局代理可用于排查规则,但不建议长期把所有本地流量无差别转发。
更新失败怎么分层查
先确认订阅 URL 和套餐状态,再看日志是网络、格式还是核心问题。GUI 能打开不代表核心已正常启动;单个节点失败也不代表整份订阅失效。
退出后恢复网络
先把系统代理切换为清除或关闭,再退出程序。浏览器仍无法联网时,检查操作系统代理地址是否仍指向 127.0.0.1 和旧端口。
按故障阶段定位,不要一次重装全部
- 程序层:界面打不开,优先查系统版本、CPU架构、.NET依赖和安全软件隔离记录。
- 订阅获取层:记录超时或 HTTP 状态;401/403 常与凭据或访问限制有关,429 表示请求过多,5xx 更可能是服务端异常。
- 内容解析层:请求成功但列表为空,核对返回内容是否是登录页、空白文本或当前版本不支持的格式。
- 核心启动层:GUI 正常但日志报核心错误,核对核心文件、架构、端口占用和配置字段。
- 流量接管层:节点延迟正常但应用不走代理,检查活动服务器、系统代理、TUN、路由和其他客户端冲突。
每次只改变一个变量并保留错误原文。订阅问题可继续使用订阅更新失败四阶段排查,DNS症状见代理 DNS 排查。
常见问题对照
确认订阅分组已启用、URL 可访问,并查看日志中的 HTTP 状态或解析错误。
确认已设为活动服务器,并检查系统代理模式和本地端口是否已生效。
GUI 能打开不代表核心正常;核对核心文件、架构、配置格式与安全软件隔离记录。
先执行清除系统代理,再退出;系统代理若仍指向 127.0.0.1 和旧端口需手动关闭。
- 普通 HTTPS 网站可以访问。
- 用站内 IP检测 对比连接前后的出口。
- 常用应用能够联网,且没有另一款客户端同时接管。
- 关闭客户端后普通网络能够恢复。
图示说明:以上为本站绘制的操作路径示意,不是复制的软件截图;按钮名称可能随系统和版本变化。未完成的设备实测不会写成亲测结论。
官方依据:项目 README、官方发布页、发行文件说明与订阅格式说明,核对日期 2026-10-10。本站按新手完成任务的顺序重新整理,没有复制官方页面结构或第三方教程截图。
“运行Core失败”发生在客户端准备启动Xray、sing-box等核心的阶段,不能直接判定订阅或节点失效。先记录v2rayN版本、内核名称与版本、操作系统、触发动作和内核日志中的第一条具体错误,再按下面分流。
| 第一条错误或现象 | 更可能的阶段 | 下一步 |
|---|---|---|
address already in use |
本地监听端口冲突 | 正常退出旧实例,确认单核心基线 |
FATAL配置字段或DNS校验 |
v2rayN与内核版本/配置生成 | 核对版本组合和官方Issue |
| 只有TUN启动失败,系统代理可用 | TUN设备、权限或对应内核 | 转入TUN排查,保留普通代理基线 |
| 核心已运行但网页打不开 | 节点、规则、系统代理或DNS | 转入连接成功但打不开网页排查 |
详细证据、恢复顺序和停止条件见《v2rayN提示运行Core失败怎么办》。若订阅更新后节点列表为空但核心尚未启动,应改看ArgumentOutOfRange_Count与节点为空排查。
- 记录当前v2rayN和内核的完整版本号;
- 备份必要配置、自定义DNS、路由和覆写,隐藏订阅令牌;
- 更新后先测试基础配置和系统代理;
- 一次只恢复一个TUN、DNS、路由或覆写变量;
- 出现新错误时保留更新前后日志,不连续覆盖证据;
- 客户端仅从v2rayN官方Releases获取;内核仅使用v2rayN内置更新路径或对应内核的官方项目发布。
- 需要恢复普通网络时,先关闭TUN,再关闭系统代理并正常退出v2rayN;若普通HTTPS仍不可访问,停止继续叠加修改并保留日志。
本站编辑核对日期:2026-11-01(北京时间)。这是公开资料核对时间,不是Issue发生日期。本段新增的是诊断和恢复路径,不声称本站已在所有系统与内核组合完成实测。
验证状态与更新记录
已核对官方项目、发布页、系统与架构说明、签名说明和订阅格式;未完成本站多系统安装与多核心对照。没有完成的速度、稳定性、耗电和资源占用测试不写成结论。
2026-10-10:新增桌面端与 v2rayNG 区分、系统架构表、Windows 包与 .NET 选择、GPG 指纹核对、订阅格式边界和五阶段排错。