Windows / macOS / Android / Linux 四平台可用

V2Ray设置教程
v2rayN 下载与配置方法

从客户端选择到连接验证,集中说明 订阅导入路由分流故障排查,同时解释 v2rayN、v2rayNG、Xray 和 V2Fly 之间的实际关系。

常见线路地区 美国 日本 香港 新加坡 韩国

核心设置

从系统代理到路由规则,逐项对应客户端界面

配置问题通常不是单个开关造成的。先确定客户端、内核和订阅都处于可用状态,再检查系统代理、路由与 DNS,排查路径会比反复切换节点更清楚。

连接入口

系统代理模式
决定哪些应用接入

v2rayN 内的节点显示可用,并不等于浏览器流量已经交给客户端处理。系统代理模式负责把遵循操作系统代理设置的应用指向本地入站端口。日常使用可先选择自动配置系统代理,再完全关闭并重新打开浏览器,避免旧连接继续沿用原有路径。若只有个别程序无法连接,应继续检查该程序是否使用独立代理、是否绕过系统设置,而不是直接修改节点参数。

这一层解决的是“应用有没有进入客户端”,与协议、线路和远端服务是否可达属于不同环节。把入口问题与节点问题分开验证,可以减少重复导入订阅或频繁改动传输参数。

系统代理
自动配置系统代理
保持原系统代理
绕过局域网地址
变更后重新建立应用连接

客户端下载

按操作系统选择客户端

桌面端统一以 v2rayN 为主要入口,Android 可在 v2rayNG 与 v2flyNG 之间选择。下载页会进一步列出适合不同处理器架构和发行版的文件。

Windows

使用 v2rayN 桌面版或经典 WPF 版。适合需要托盘控制、系统代理切换、订阅分组和完整路由设置的桌面环境。

前往下载

macOS

使用 v2rayN 跨平台桌面界面。下载时需要根据设备处理器选择对应构建,安装后再完成系统代理授权与订阅导入。

前往下载

Android

首选采用 Xray 内核的 v2rayNG,也可按订阅和内核偏好选择 v2flyNG。主流设备通常使用 arm64 架构。

前往下载

Linux

v2rayN 提供面向 Debian、Ubuntu 与 Fedora 系发行版的桌面安装入口,并区分 x64 与 arm64 处理器架构。

前往下载

快速上手

导入、选择、验证三步完成基础配置

首次配置不要同时调整所有高级选项。先建立一条最小可用连接,再根据应用需求增加路由和 DNS 规则。

  1. STEP 01

    导入订阅或分享链接

    桌面端可以从剪贴板导入订阅地址或单节点分享链接,Android 客户端也提供对应入口。订阅导入后需要执行一次更新,确认服务器列表已经出现。若列表为空,优先检查复制内容是否带有多余空格、地址是否完整以及设备时间是否准确。不要在尚未获得节点列表时修改路由规则,因为此时问题仍位于订阅获取环节。

  2. STEP 02

    选择节点并开启代理

    从订阅分组中选定活动节点,再启动客户端内核。Windows、macOS 与 Linux 桌面端还需设置系统代理模式,Android 则需确认系统连接授权。节点被选中只代表配置进入待用状态,内核成功启动并接管应用流量后才构成完整连接。此时先保持默认路由,避免高级规则影响第一次验证。

  3. STEP 03

    检查日志与实际访问

    完成连接后先打开一个新的浏览器窗口进行访问测试,再查看客户端日志是否出现域名解析、TLS 握手或连接超时信息。延迟测试只能说明探测请求的响应情况,不能替代完整网页访问。若浏览器仍沿用旧连接,可完全退出后重开;若所有节点都失败,则按系统代理、DNS、本地网络、订阅有效性和远端状态的顺序逐层检查。

开源生态

Project V、V2Fly、Xray 与图形客户端的关系

名称相近不代表职责相同。理解生态、内核与客户端三层结构,有助于判断教程中的设置究竟属于界面操作、配置格式还是协议实现。

Project V 是技术生态的起点

Project V 形成了一套围绕代理协议、传输方式、路由和配置结构的开源技术生态。常见的 VMess、VLESS、WebSocket、gRPC、TLS、REALITY 与 routing 等词汇处于不同层级:有些负责身份与数据传递,有些负责承载连接,有些负责决定流量最终走向。客户端界面把这些字段整理成表单,但底层仍会转换为内核可读取的配置。

因此,所谓“V2Ray 配置”并不是一个单独开关,而是入站、出站、传输、安全、DNS 与路由共同组成的结果。基础用户通常通过订阅获得完整参数,只需处理客户端导入和系统代理;需要手动维护规则时,再逐步理解各区块职责,比直接复制一份庞大配置更容易发现错误。

V2Fly 与 Xray 是不同的内核家族

V2Fly 延续 Project V 相关技术的社区维护路线,保留熟悉的配置结构和协议能力。Xray 在相近的配置体系上发展,并覆盖 VLESS、REALITY 等常见部署组合。两者都属于运行内核:负责读取配置、监听本地入站、完成域名解析与路由匹配,并建立实际出站连接。内核本身不等同于桌面窗口或移动端界面。

选择哪一种内核,应以节点要求、客户端支持和配置字段为依据。遇到导入成功但无法启动时,首先看日志里是否存在不支持的字段或格式错误;内核已经启动但访问失败时,再检查网络、DNS、证书名称与远端响应。把“配置能否解析”和“连接能否建立”分开,是处理复杂故障的关键。

图形客户端负责系统集成与日常管理

v2rayN 面向 Windows、macOS 与 Linux 桌面环境,主要承担订阅更新、节点选择、系统代理、路由规则编辑、内核切换和日志查看。v2rayNG 面向 Android,通常配合 Xray 内核使用;v2flyNG 同样面向 Android,侧重 V2Fly 内核路线。三款客户端都通过公开的开源协作方式持续维护,但发布节奏、界面结构和支持字段并不完全一致。

客户端升级通常会涉及界面调整、运行内核更新或配置兼容变化。更新前应先记住当前可用的订阅分组、系统代理模式和自定义路由,更新后则先验证最小连接,再恢复高级设置。遇到旧配置无法直接使用时,应根据日志和当前字段说明调整,而不是把不同客户端的配置目录直接互相覆盖。

开源协议带来可审阅的维护方式

开源协议明确了代码使用、修改与分发的边界,也让协议实现、配置处理和问题修复能够被社区审阅。对普通使用者而言,更实际的价值是文档、问题记录与版本变化可以形成可追踪的技术资料。它并不替代正确配置,也不能保证每个第三方订阅来源都可靠;客户端、内核和节点服务仍应分别判断。

本站教程以公开配置语义和客户端实际界面为基础,重点解释各选项的作用、依赖关系与排查顺序。涉及订阅内容时,只说明导入和管理方式;涉及协议时,只说明字段与连接机制。通过这种分层方式,可以避免把客户端问题、内核问题和远端服务问题混在同一个结论里。

常见问题精选

先确认问题发生在哪一层

订阅、节点、系统代理、DNS 与路由会依次影响连接。根据症状定位环节,比反复删除和重装客户端更有效。

订阅更新成功,为什么列表仍然为空?

先确认订阅返回的是客户端支持的节点格式,并检查分组筛选条件、设备时间与更新日志。如果复制的是单条分享链接,应使用从剪贴板导入节点的入口,而不是订阅更新入口。

查看订阅与节点术语 →

延迟测试正常,浏览器为什么打不开网页?

探测响应与完整访问不是同一过程。继续检查系统代理是否开启、浏览器是否复用旧连接、DNS 是否返回可用结果,以及路由规则是否把目标域名送往了预期出站。

查看无法上网排查 →

VLESS、VMess 与 REALITY 分别是什么?

VLESS 与 VMess 属于客户端和服务端之间使用的协议类型,REALITY 属于连接安全与握手相关方案。它们不能直接横向替换,导入时应完整保留节点提供的协议、传输和安全字段。

查看协议术语 →

修改路由后只有部分网站异常怎么办?

暂时切回较简单的默认规则,确认基础连接恢复,再逐条增加域名和 IP 条件。重点检查规则顺序、匹配范围,以及同一服务使用的主域名、接口域名和静态资源域名是否走向不同出站。

查看 DNS 与分流排查 →

技术笔记

配置结构、证书错误与分享链接

最新文章围绕客户端界面背后的配置逻辑展开,适合在完成基础连接后继续阅读。

进阶原理

V2Ray 配置文件结构逐段解析:inbounds、outbounds 与 routing 各管什么

拆开一份最小可用的 V2Ray JSON 配置,解释入站、出站和路由区块的职责,以及它们与 v2rayN 图形设置的对应关系。

阅读全文 →
故障排查

TLS 握手失败与证书报错排查:系统时间、SNI 与 allowInsecure 三个关键点

按系统时间、SNI、证书链和客户端日志梳理排查顺序,并说明放宽证书检查会带来的实际风险。

阅读全文 →
入门指南

vmess:// 和 vless:// 分享链接怎么用?与订阅地址的区别一次讲清

说明单节点分享链接和可更新订阅列表的结构差异,并给出 v2rayN 与 v2rayNG 中对应的导入入口。

阅读全文 →