v2rayN 桌面版与 WPF 版
桌面版采用新一代跨平台界面，WPF 版保留经典桌面操作方式。首次使用可先从桌面版了解服务器列表、订阅分组和日志面板；已有使用习惯时，也可以选择 WPF 版。两种入口是界面形态的选择，不代表购买方案，也不表示导入订阅后一定能够连接。
安装前先在系统设置中确认处理器架构，并阅读下载页的运行要求。启动后先添加一组订阅，完成更新，再选中一条配置进行真连接测速。启用系统代理只会影响遵循系统代理设置的程序；浏览器能连接，并不能说明所有应用都已经使用相同出口。
前往下载V2RAY · V2RAYN · V2RAYNG
V2Ray 教程与v2rayN 客户端下载.
从订阅导入到路由分流，按步骤配置 v2rayN / v2rayNG，结合内核日志定位连接问题。
CLIENT SELECTION
按系统选择客户端
桌面端从 v2rayN 开始，安卓端优先了解 v2rayNG。安装包的架构要与设备处理器对应，文件格式则取决于操作系统和发行版。先选对客户端，再导入已有的服务器配置，能够把安装问题与连接问题分开处理。
v2rayN 芯片架构选择
在“关于本机”中查看芯片信息：显示 Apple Silicon 系列芯片时选择 arm64，显示 Intel 处理器时选择 x64。两个安装入口对应不同架构，不需要同时安装。安装过程中如果出现系统权限提示，应先确认提示对象和安装来源，再按系统提供的流程处理。
桌面客户端负责保存配置、切换服务器和生成内核运行参数，实际连接仍由内核完成。配置导入成功后，先确认当前活动服务器，再检查代理方式。更换客户端时，不宜直接覆盖整个数据目录；先保留原设置，再逐项迁移订阅和规则，便于发现路径与权限差异。
前往下载v2rayNG 与 v2flyNG
v2rayNG 使用 Xray 内核，是安卓端的优先入口；v2flyNG 使用 V2Fly 内核，作为按内核需求选择的备选。多数较新的手机可先查看 arm64 安装包，无法确认架构时再参考通用版说明。应以设备实际架构与系统要求为准，而不是仅凭手机购买年份判断。
首次启动连接时，系统会请求建立 VPN 连接的权限，这是客户端接管选定流量的系统接口。授权后还应检查分应用代理、路由模式与后台运行限制。若切到后台一段时间后断开，先观察电池优化与进程状态，不要立即把原因归到订阅地址或服务器参数上。
前往下载v2rayN 发行版安装包
Debian、Ubuntu 及相应衍生发行版通常选择 deb，Fedora 等采用 RPM 软件包体系的发行版选择 rpm。除此之外，还要区分 x64 与 arm64。包格式与处理器架构是两个独立条件：格式正确但架构不符，仍可能无法完成安装或启动。
图形客户端启动后，先使用普通权限完成订阅管理和基础连接测试，再考虑需要额外权限的网络接管方式。桌面环境对系统代理的支持并不完全相同，部分程序还需要独立设置。遇到连接不一致时，记录应用是否遵循桌面代理、使用何种 DNS，再决定是否启用 TUN。
前往下载客户端安装包不包含可直接使用的服务器服务。连接地址、端口、身份参数和订阅链接需要来自有权使用的服务或自建环境；安装、导入、测速和验证应按顺序分别完成。
查看全部客户端 →CONFIGURATION INDEX
订阅、路由与日志
配置问题可以沿着“配置从哪里来、流量从哪里进、匹配哪个出口、域名如何解析”的顺序拆开。下列索引对应五个常用入口，示例只展示相关字段，不是可独立运行的完整配置。实际字段还应与所选内核及客户端生成的配置对应。
订阅导入与本地监听
订阅用来批量获取服务器配置，不等于连接已经建立。在 v2rayN 的订阅分组中保存完整地址并执行更新；安卓端也应先添加分组，再更新配置。列表出现条目后，选择活动服务器并进行连接测试。下面是本地 SOCKS 入站片段，与订阅内容分属不同层级；监听回环地址只接受本机连接。更新失败时先看订阅请求日志，不要通过改动入站端口来尝试修复远程地址。
{
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
]
}路由规则按顺序匹配
分流规则决定一次请求使用哪个出站，不负责修复服务器本身。先为代理与直连出站设置清晰的标签，再从具体规则写起，最后安排默认出口。下面把私有地址交给名为 direct 的出站，这个标签必须在完整配置中存在，引用的规则数据也要可用。排查误分流时，先查较靠前的命中规则，再检查域名是否已经变为 IP；不要只看规则名称推断结果，也不要同时修改多条规则。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}区分系统解析与内核 DNS
网页打不开并不一定是服务器不可用，也可能是域名解析没有走到预期路径。先区分系统 DNS、应用自己的加密 DNS 与内核内置 DNS，再检查路由是否触发解析。下面是内核 DNS 服务器的简化字段，并不意味着所有应用的查询都会被接管。比较修改前后的日志与访问结果，一次只调整一个解析环节；若使用远程解析，还要确认到解析服务器的连接本身可以建立，避免形成依赖循环。
{
"dns": {
"servers": [
"1.1.1.1",
"8.8.8.8"
]
}
}TUN 接管与回环风险
TUN 通过虚拟网卡处理流量，适合需要覆盖更多应用的场景，但权限、路由和 DNS 都要同时配合。先确认普通代理连接可用，再在客户端启用 TUN，并观察虚拟网卡与系统路由的变化。下面是可用于本地连接测试的 SOCKS 入站，不是 TUN 开关；TUN 的实现与配置格式取决于客户端所用组件，不能直接把这段 JSON 当作虚拟网卡配置。出现断网时先关闭 TUN，保留日志后再定位。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
}
]
}从第一条错误确定范围
内核无法启动与连接建立后超时属于不同阶段，应分别处理。先找到同一次启动中最早出现的错误，检查配置语法、端口占用和字段兼容性，再看远程连接及 TLS 握手。临时提高日志级别有助于复现问题，完成后应恢复常用级别，减少冗余输出。下面的 warning 适合关注警告与错误；分享日志前还要移除订阅链接、身份参数和真实地址，保留错误类型与前后文即可。
{
"log": {
"loglevel": "warning"
}
}初次配置建议先保留默认路由，用一条已确认参数完整的服务器记录建立连接，再逐步增加分流与 DNS 设置。把多个开关同时打开会扩大排查范围；每次只改一个变量，并记下修改前的值，后续恢复与比较才有依据。
按完整步骤配置首次连接 →PROJECT V ECOSYSTEM
客户端与内核的分工
V2Ray 是理解这套代理工具生态的起点，但客户端名称、内核名称和协议名称不是同一回事。明确它们各自负责什么，比单纯比较软件名称更有助于选型，也能减少照搬配置时的误解。
生态背景Project V
配置结构与代理组件
内核家族V2Fly / Xray
协议处理与连接执行
图形客户端v2rayN / v2rayNG / v2flyNG
配置管理与操作入口
BACKGROUND
Project V 与配置结构
Project V 将代理功能拆成相互配合的组件，V2Ray 是其中广为使用的实现。理解配置时，可以把入站看作应用流量的入口，把出站看作连接目标的方式，把路由看作两者之间的选择规则。DNS、日志和策略则提供解析、观察与资源管理能力。这样的拆分使同一份配置可以表达多个入口与多个出口，也说明了为什么只改服务器地址往往不足以解决所有连接问题。
图形客户端把这些结构转换为列表、分组、开关和表单，降低日常管理的成本。它不是远程服务器，也不会替代服务端配置。导入链接通常只是把一组参数转换成本地记录；真正启动时，客户端还可能根据当前路由模式、监听端口和用户设置重新生成运行配置。因此，阅读教程时要分清“导入时保存的记录”与“当前内核实际读取的配置”，不要把两个文件或两个界面当成完全相同的内容。
CORE FAMILIES
V2Fly 与 Xray 的关系
V2Fly 延续 V2Ray 的社区维护，Xray 则由相关代码分支发展而来。两者共享一部分配置概念，但协议特性、字段支持和后续演进并不完全一致。看到 JSON 结构相似，不能直接推断所有字段都可以互换；某个内核接受的传输参数，也不一定被另一内核以相同方式解释。判断兼容性时，应先确认客户端实际启用的内核，再核对协议、传输层和安全层的组合。
VMess、VLESS、Trojan 与 Shadowsocks 是协议名称；WebSocket、gRPC 等描述传输方式；TLS 又涉及另一层连接安全设置。这些名称可能同时出现在一条服务器记录里，但承担的职责不同。排查时可以顺着地址与端口、身份参数、传输路径、服务器名称的顺序核对，而不是反复切换内核碰运气。只有明确需要某项特性时，内核选择才应成为配置方案的一部分。
OPEN SOURCE CLIENTS
三款客户端的开源属性
v2rayN、v2rayNG 与 v2flyNG 都是开源图形客户端，相关源代码由社区项目维护。v2rayN 面向桌面平台，提供服务器管理、订阅分组和路由等常用入口；安卓端的 v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核。选择时优先看设备、系统要求与服务端参数是否匹配，再考虑界面习惯。相似的名称并不意味着它们是同一个安装包，也不表示数据目录能够直接通用。
开源许可证说明软件代码的使用、修改与再分发条件，不等于远程服务的可用性说明。V2Ray 与 Xray 的核心代码采用 MPL 2.0，具体客户端及随附组件仍需分别查看其许可证与声明。客户端可以免费使用，但远程服务器、网络连接和订阅服务可能由不同主体提供。将软件工具与服务来源区分开，才能判断故障应在哪一侧处理，也能避免把服务费用误认为客户端的授权要求。
UPDATE & DIAGNOSIS
更新、回退与配置留存
客户端更新与内核更新并不总是同一个动作。界面调整可能改变设置入口，内核变化则可能影响字段兼容性与协议行为。更新前应保存订阅分组、自定义路由和必要的个人设置，并阅读相关变更说明。更新完成后，先检查已有配置能否启动，再验证常用访问场景；确认基础连接正常之后，再恢复实验性的路由或接管设置。这样可以把升级引入的变化限制在可比较的范围内。
如果更新后出现问题，先记录客户端类型、正在使用的内核、操作系统以及错误发生阶段，不要立即删除所有设置重装。内核启动失败时看首条配置错误；只有部分域名失败时检查 DNS 与规则命中；浏览器可用而其他程序不可用时检查代理覆盖范围。日志中涉及真实服务器、订阅地址和身份信息的内容应先隐藏，再整理为可以复现的步骤。关于字段含义与最小示例，可继续阅读配置参考，而具体操作顺序适合从使用指南开始。
TECHNICAL NOTES
近期技术笔记
使用指南按照完整流程组织，技术笔记则围绕一个具体问题展开。已完成安装但不知道下一步检查什么，可以先读首次连接；需要理解按钮与面板的对应关系，可以从主界面速览开始；准备修改分流时，再进入规则语法与命中顺序。
v2rayN 主界面功能速览：服务器列表、订阅分组、日志面板与参数设置
按区块讲清 v2rayN 主窗口：服务器列表的右键菜单、订阅分组切换、底部日志面板的阅读方法，以及参数设置里最常用的几项开关。
阅读笔记 →v2rayN 首次连接指南：选节点、真连接测速与代理是否生效的验证方法
导入订阅后，先用真连接测速筛出可用节点，再开启系统代理，最后通过浏览器访问与出口 IP 查询，确认流量确实走了代理。
阅读笔记 →V2Ray 自定义路由规则写法：domain、ip、geosite 匹配语法与优先级
详解 domain 前缀、full 与 regexp 匹配，ip 与 geoip 写法，geosite 分类引用，以及规则从上到下的命中顺序和 domainStrategy 的影响。
阅读笔记 →阅读排查文章时，先确认问题发生在订阅更新、内核启动、建立连接还是应用访问阶段。相同的“超时”提示可能来自不同环节，结合出现位置和前一条日志判断，通常比重复重试更容易缩小范围。
查看全部文章 →