desktop / v2rayN
Windows
桌面端优先选择 v2rayN。下载页同时说明跨平台桌面版与经典 WPF 版的界面差异、适用系统和安装方式， 便于新系统与存量设备分别选择。
前往下载 →
platforms / 4
core / Xray · V2Fly
config / JSON
license / open source
routing / rules
一条连接如何经过入站、路由与出站
浏览器或系统流量先进入本地监听端口，随后由 routing 规则检查域名、IP、协议类型与进程来源， 最终交给指定的 outbound。理解这条路径后，系统代理、绕过局域网、直连规则与远端连接之间的关系会更清晰。
download / platforms
V2Ray 客户端平台入口
先按当前系统进入对应分区，再根据处理器架构和使用习惯选择客户端。首页只负责平台导航， 安装包类型、系统要求与具体下载入口统一放在下载页说明。
desktop / v2rayN
macOS
v2rayN 桌面版分别提供 Apple Silicon 与 Intel 架构入口。打开系统信息查看芯片名称即可判断， 下载页还会说明首次运行、配置导入和系统代理切换位置。
前往下载 →mobile / v2rayNG
Android
Android 端首选采用 Xray 内核的 v2rayNG，也可按内核偏好选择 v2flyNG。主流设备通常使用 arm64， 无法确认架构时可阅读下载页的通用安装包选择说明。
前往下载 →desktop / v2rayN
Linux
v2rayN 提供适用于常见发行版的软件包，并按 x64 与 arm64 架构区分。先确认发行版采用 deb 还是 rpm， 再进入下载页选择对应架构，可减少安装阶段的格式错误。
前往下载 →config / anatomy
配置字段拆解台
一份配置由多个职责明确的顶层字段组成。选择左侧目录可查看字段作用、常见取值、 图形客户端中的对应设置位置，以及修改时最容易忽略的联动关系。
config > inbounds
本地入站监听
inbounds 定义客户端如何接收来自浏览器、系统或其他程序的流量。常见配置包含
listen、port、protocol 与 tag：
监听地址决定哪些设备可以连接，本地端口需要与系统代理设置保持一致，协议通常使用 SOCKS 或 HTTP。
在 v2rayN 中，这部分对应参数设置里的本地监听端口；在 v2rayNG 中，对应本地代理与 VPN 服务入口。
修改端口后，还要同步调整手动配置过代理地址的浏览器或应用，否则客户端虽然启动成功，流量仍不会进入内核。
config > outbounds
远端连接与出口标记
outbounds 描述流量离开本机后的处理方式。一个配置通常包含远端代理、直接连接与拦截出口，
每个出口通过 tag 获得稳定名称，再由 routing 规则引用。远端出口还会携带协议、服务器地址、
端口、用户参数和传输层选项。图形客户端导入订阅后会自动生成主要出口，用户更常接触的是活动服务器选择、
传输设置和内核切换。手工编辑时应先确认 tag 与路由规则一致，避免出口已经存在但没有任何规则能够引用。
config > routing > rules
域名、IP 与进程分流
routing 决定一段流量应交给哪个 outbound。规则可以按域名、IP 段、端口、网络类型、
入站 tag 或进程名称匹配，并通过 outboundTag 指向代理、直连或拦截出口。
v2rayN 的路由设置提供预设规则集与自定义规则入口，v2rayNG 则可在路由设置中调整域名策略和规则顺序。
实际匹配通常受先后顺序影响，因此精确规则应放在宽泛规则之前；调整后要用日志确认命中的规则和最终出口。
config > dns
域名解析路径
dns 控制内核使用哪些解析服务器，以及不同域名采用哪条解析路径。常见设置包括服务器列表、
hosts 映射、查询策略和按域名指定解析器。它与 routing 紧密关联：域名先被解析为地址后，后续 IP 规则可能继续参与匹配。
图形客户端通常把这些选项放在 DNS 设置、路由高级设置或自定义配置区域。排查域名能解析但连接异常的问题时，
应分别核对系统 DNS、客户端 DNS 与路由域名策略，避免把三个层次混为同一项。
config > log
运行日志与排查级别
log 用于设置访问日志、错误日志和输出级别。日常使用可保持较低输出量，出现连接失败、
路由误判、端口冲突或订阅生成异常时，再临时提高日志级别观察关键记录。v2rayN 与 v2rayNG 都提供日志查看入口，
重点关注监听是否启动、出站是否建立、域名解析是否返回结果，以及 routing 最终选择的 tag。
日志可能包含服务器地址和本地路径，分享排查信息前应先整理与问题直接相关的行，并隐藏个人连接参数。
project v / ecosystem
Project V 生态与客户端分工
图形客户端、代理内核与配置数据属于不同层次。分清各层职责，才能正确理解客户端更新、 内核切换、订阅内容与路由规则之间的关系。
从 Project V 到内核家族
Project V 奠定了 V2Ray 配置模型与模块化网络工具的基本结构。配置文件把入站、出站、路由、 DNS、传输与日志拆分为相互关联的模块，用户可以用 tag 将多个模块组合成清晰的数据路径。 这种结构既适合手工维护 config.json，也方便图形客户端根据订阅和界面选项生成配置。 因此，客户端界面里看到的服务器、代理模式、路由预设和本地端口，最终都会落到对应的配置字段。
V2Fly 延续并维护 V2Ray 核心能力，强调模块化配置与协议实现；Xray 则在相近配置体系上发展出独立内核， 并被多个客户端用于连接与路由处理。两者并不是图形客户端本身，而是客户端调用的底层核心。 同一款图形客户端可以围绕不同内核组织功能，同一个订阅也可能因客户端和内核支持范围不同， 在传输参数、路由能力或配置写法上呈现细节差异。
开源协议与可审阅更新
v2rayN、v2rayNG、v2flyNG 以及相关内核均由开源社区持续维护。开源协议规定了代码使用、修改与再分发的边界， 也让协议实现、配置解析和问题修复能够被开发者公开审阅。对普通用户而言，更实际的判断标准是： 下载与当前系统匹配的客户端，阅读更新说明，保留已能正常工作的配置，并在升级后检查系统代理、路由和内核状态。
客户端更新与内核更新并不总在同一时间发生。界面程序负责订阅管理、配置编辑、托盘控制与系统集成； 内核负责协议连接、DNS、路由和流量处理。某次更新如果只涉及界面布局，现有连接方式通常不会改变； 如果包含内核或配置格式调整，则应重点检查自定义路由、传输参数和旧配置兼容情况。 日常维护时记录客户端类型、所用内核与关键设置，比只记录一个软件名称更有助于定位问题。
desktop
v2rayN
面向 Windows、macOS 与 Linux 的桌面图形客户端，负责订阅管理、服务器选择、系统代理、 路由预设、TUN 模式和日志查看。桌面端需要完整控制系统网络设置时，优先从 v2rayN 开始。
android / xray
v2rayNG
采用 Xray 内核的 Android 客户端，提供扫码、剪贴板导入、订阅更新、分应用代理和路由设置。 已有 Xray 相关参数或需要对应协议能力时，可将其作为移动端主要选择。
android / v2fly
v2flyNG
以 V2Fly 内核为基础的 Android 备选客户端，界面操作与常见订阅流程较为接近。 需要沿用 V2Fly 配置体系或核对不同内核表现时，可按实际配置要求选择。
workflow / checklist
更新客户端前先记录四项设置
- 活动配置：确认当前使用的订阅分组与服务器条目，避免升级后误选其他配置。
- 代理模式：记录系统代理、PAC、全局、规则或 TUN 的当前状态，便于恢复原有路径。
- 本地端口：核对 SOCKS 与 HTTP 监听端口，浏览器手动代理需要使用相同数值。
- 自定义规则：单独保存手工添加的域名、IP、进程与出口 tag，更新后逐条验证命中结果。
quick answers
常见问题精选
订阅导入后为什么看不到服务器？
先执行一次订阅更新，再检查订阅分组是否启用、链接是否完整，以及客户端日志中是否出现解析错误。 完整操作顺序可参照订阅导入步骤。
系统代理与 TUN 模式有什么区别？
系统代理主要接管遵循系统代理设置的应用；TUN 模式通过虚拟网络接口处理更广范围的流量。 选择前应先阅读TUN 模式章节。
端口被占用时应该修改哪一项？
先定位占用本地监听端口的进程，再修改客户端的 SOCKS 或 HTTP 端口，并同步调整浏览器与其他应用的代理设置。 可查看端口冲突排查。
桌面版与经典 WPF 版怎么选？
新系统可先考虑跨平台桌面版，依赖经典界面和既有操作习惯时再比较 WPF 版。 具体差异整理在客户端对比页。
notes / latest
V2Ray 使用心得与配置记录
文章围绕可复现的问题展开：先说明触发条件，再给出设置路径、检查方法和恢复步骤。 涉及配置结构时会同时解释字段职责，便于将图形界面操作对应到内核配置。
v2rayN 提示端口被占用怎么办：定位占用进程与修改本地监听端口
启动客户端时报端口冲突，多半是常用监听端口已被其他程序占用。文章说明如何定位进程， 再在 v2rayN 参数设置中修改本地端口并同步浏览器代理。
阅读全文 →Windows 安装 v2rayN 全流程：桌面版与 WPF 版怎么选、常见问题逐个排
从下载、解压、首次启动到导入订阅，按顺序完成 Windows 端配置，并说明运行环境缺失、 系统代理未生效和客户端版本选择等高频问题。
阅读全文 →config.json 结构逐段解析：inbounds、outbounds 与 routing 各管什么
拆开一份最小配置，说明入站如何接收本地流量、出站如何建立连接，以及 routing 如何通过 tag 把不同规则指向指定出口。
阅读全文 →