Windows
v2rayN · 桌面首选桌面版提供跨平台界面，WPF 版保留经典桌面操作布局。两者都需要核对系统与运行环境要求，不建议仅凭安装包名称判断兼容性。已有配置的用户应先备份订阅分组和自定义路由，再决定是否更换界面版本。
初次使用可以从系统代理开始，确认浏览器访问与日志正常后，再评估是否需要 TUN。安装完成并不代表代理已启用；还应检查当前配置、本地监听端口以及应用是否遵循系统代理设置。
前往下载 Windows 客户端
评测项目单
v2rayN 设置项与使用边界
配置能否生效，取决于导入内容、流量入口和出站规则是否相互对应。先明确每一层负责什么，再调整具体参数。
订阅链接不是完整客户端配置
v2rayN 的订阅分组适合把不同来源的连接配置分开维护。先添加分组、填写订阅地址，再执行该组更新，避免把来源不明的内容混入现有列表。订阅通常提供服务器连接参数，并不保证携带桌面端的系统代理、TUN 或自定义路由设置。更新完成后，应核对协议、传输方式与安全参数，而不是只看列表是否出现条目。与逐条粘贴分享链接相比，分组订阅便于后续更新，但手工修改的条目可能在更新后被覆盖，重要调整需要另行记录。
v2rayN · 订阅分组设置
订阅地址
https://example.com/subscription更新范围当前订阅分组
先确认来源与格式，再更新服务器列表。
先写例外，再放宽泛规则
路由分流按规则顺序决定出站，窄范围的例外规则通常要放在宽泛规则前面。局域网地址直连、指定域名代理与兜底出站应分别检查，不能只凭预设名称判断实际行为。域名规则需要请求保留可匹配的域名信息，IP 规则则取决于目标地址与域名解析策略。与全部交给默认出站相比，自定义规则更容易表达精确需求，也更需要记录修改原因。排查时先找第一条命中规则，再确认它指向的出站是否存在，避免重复添加条件相同的规则。
v2rayN · 路由规则顺序
geosite:category-ads-all → block
geoip:private → direct
geosite:cn → direct
geoip:cn → direct
兜底规则 → proxy系统代理与 TUN 作用层不同
系统代理主要影响遵循操作系统代理设置的应用，适合作为初次配置的起点；部分终端工具或自带网络设置的应用需要单独指定代理。TUN 通过虚拟网卡接管进入其路由范围的流量，覆盖面取决于系统路由、排除规则与权限状态，并非开启后每个请求都走代理。相比系统代理，TUN 还要处理 DNS、局域网访问及其他虚拟网卡的协作问题。建议先在系统代理模式下验证连接，再启用 TUN，出现问题时保留可返回的基础配置。
v2rayN · 参数设置
自动配置系统代理
TUN 模式关闭启用前确认权限与路由范围
本地监听端口：10808，以实际设置为准。
协议名称相同，参数支持仍需确认
图形客户端负责组织配置，内核负责解释配置并建立连接。选择内核时，需要同时核对协议、传输层、安全设置及路由字段的支持范围，不能把更换内核当作通用修复办法。同一条分享链接在不同内核中可能涉及字段转换，导入成功也不等于参数完整可用。与直接修改内核配置相比，图形界面更便于日常管理，但高级选项仍需对照当前客户端说明。调整前保留原配置，每次只更改一个变量，再从启动日志判断配置是否被正确接受。
v2rayN · 内核配置检查
内核类型Xray
检查顺序：协议 → 传输方式 → TLS / REALITY → 路由字段。
把启动失败与请求失败分开
日志排查先确认内核是否启动，再判断具体请求失败在哪一层。端口占用、配置字段错误和规则资源缺失会影响启动；解析失败、握手失败或连接超时则需要结合目标与时间线继续分析。与反复切换配置相比，保留一次失败前后的连续日志更容易缩小范围。先恢复默认日志级别与基础配置，必要时短时提高记录详细程度，复现后及时还原。对外提供日志前，应移除订阅地址、认证信息和可识别的连接参数，保留错误类型即可。
v2rayN · 日志定位顺序
启动配置 → 本地监听 → DNS 解析
→ 路由匹配 → 出站连接
端口占用：address already in use
解析失败：failed to lookup
阅读窗口示意时，先分清参数与结果。
上方窗口展示的是设置关系，不是运行状态。端口、路由预设和内核选择都只是配置输入；连接是否正常，还要结合应用请求与日志判断。不同桌面环境中的菜单位置可能有所变化，理解选项的作用比记住截图位置更有用。首次使用建议只完成订阅导入、选择配置和系统代理设置，暂缓叠加复杂分流。
平台与安装包
V2Ray 客户端下载入口
桌面平台使用 v2rayN；安卓优先考虑 Xray 内核的 v2rayNG，需要 V2Fly 内核时再查看 v2flyNG。先选系统，再核对处理器架构。
macOS
v2rayN · 按芯片选择Apple 芯片选择 arm64，Intel 处理器选择 x64；可先在系统的“关于本机”中确认芯片信息。选对架构能减少启动与依赖问题，不应把错误架构导致的异常误判为订阅或服务器连接故障。
首次打开时留意系统的安全提示与网络权限。系统代理和 TUN 的授权路径不同，建议先完成基本连接验证，再处理虚拟网卡相关设置。遇到拦截应核对应用来源和系统提示，不要一次修改多项安全设置。
前往下载 macOS 客户端Android
v2rayNG / v2flyNGv2rayNG 使用 Xray 内核，作为安卓端的优先选择；v2flyNG 使用 V2Fly 内核，适合需要对应内核行为的配置。主流 arm64 设备选择对应安装包，无法确认架构时可查看通用包说明，避免只按文件体积选择。
安卓端通常通过系统 VPN 接口建立本地流量通道，需要确认系统授权、分应用设置与后台运行限制。桌面端的路由预设不一定能直接迁移到手机，共用订阅地址也不代表两端的 DNS、分流与流量接管行为相同。
前往下载 Android 客户端Linux
v2rayN · deb / rpmDebian、Ubuntu 系发行版通常选择 deb，Fedora 系通常选择 rpm，同时核对 x64 或 arm64 架构。包格式与处理器架构是两项独立条件，选对其一仍不足以保证安装成功，还需查看发行版依赖要求。
桌面环境对系统代理的支持各不相同，部分应用仍需单独配置。自启动也不等于 TUN 权限已经准备完成，建议先验证手动启动，再配置桌面自启动项，并检查退出客户端后系统代理是否正确恢复。
前往下载 Linux 客户端
快速上手
从安装到连接验证的三步顺序
先建立一条可复现的基础连接，再增加自定义规则。每一步只确认当前层的问题，能减少设置之间互相干扰。
-
安装客户端，导入订阅分组
按系统和架构完成安装后，先打开参数设置，记录本地监听端口，再进入订阅分组添加可信来源的订阅链接。更新后核对条目的协议、传输方式和安全设置，选择实际要使用的配置。若订阅更新失败，先检查地址是否完整、授权是否有效，以及链接返回的是订阅内容还是网页错误提示。
分享链接与订阅链接的用途不同：前者通常描述单条连接，后者便于批量更新。不要把带有认证信息的链接粘贴到公开评论、截图或转换服务中。已有配置需要迁移时，先保留备份，再执行覆盖或重新导入；订阅导入成功之后，还需要主动选择配置并确认内核能够启动。
-
选择代理模式，保留基础路由
桌面端先启用自动配置系统代理，使用基础路由预设，暂时关闭 TUN。这样可以先确认订阅参数与出站连接是否成立。安卓端则按系统提示允许建立 VPN 连接，检查客户端的分应用范围。不要同时运行多个接管系统流量的工具，否则故障可能来自代理设置互相覆盖，而非连接参数本身。
“全局”通常描述客户端的出站策略，并不等同于系统中所有应用都已经把流量送到客户端。先确认请求进入代理，再讨论它应该直连还是代理。需要 TUN 时，在基础连接正常后单独启用，并留意管理员权限、DNS 和局域网排除项；出现异常时先回到已验证的系统代理配置。
-
验证应用请求，再保存日常配置
使用实际需要代理的应用发起请求，结合日志确认内核启动、本地监听和出站连接。浏览器能够打开页面，只能说明当前访问路径可用，不能直接推断终端、游戏或其他应用也已使用相同代理。反过来，单次连接超时也不足以证明整个客户端故障，应区分目标服务、域名解析和出站握手。
基础验证完成后，再逐项添加自定义路由、启用 TUN 或调整 DNS。每次记录改动目的与恢复方式，避免多个参数一起改变后失去对照。结束使用时通过客户端正常退出，留意系统代理恢复情况；日常维护重点是订阅来源、配置备份和异常日志，而不是频繁切换所有开关。
Project V / V2Fly / Xray
客户端、内核与开源生态
界面负责管理，内核负责执行。把这两层分开理解，才能解释同一份连接配置在不同设备上的差异。
Project V 是技术生态，不是单个安装包
Project V 围绕代理通信与网络配置形成工具生态，V2Ray 是其中的重要项目。随着社区发展，V2Fly 继续维护 V2Ray 相关实现，Xray 则从相关代码与技术背景发展出自己的实现路线。它们共享部分概念，但并非可以任意互换的同一套程序。日常搜索中的“V2Ray 客户端”常被用作宽泛称呼，实际下载时仍要确认图形客户端和所用内核。
理解这段关系有助于区分三个问题：界面选项在哪里、配置语法是否受支持、服务端参数是否匹配。界面中的某个开关消失，不一定意味着协议被取消；某个协议在内核中存在，也不保证当前图形界面完整暴露了全部高级字段。遇到差异时，应按客户端、内核、连接参数的顺序分别核对，而不是只比较产品名称。
Xray 与 V2Fly 的差别落在具体功能上
内核承担协议处理、传输建立、路由匹配和出站连接。选择时应关注服务端配置所需的能力，例如 VLESS、VMess 对应的参数，以及 TLS、REALITY 等安全设置的兼容要求。不能因为两个内核都支持某个协议名称，就忽略传输方式、字段取值和配置转换差异。排查连接失败时，保留原始参数说明往往比频繁更换内核更有效。
路由与 DNS 也属于需要对照的部分。域名列表、IP 数据资源与解析策略共同影响规则是否命中；看起来相同的路由预设，在资源内容或解析行为变化后可能产生不同结果。建议先使用客户端提供的基础配置，理解直连、代理与阻断出站的含义后，再增加精细规则。把局域网例外与兜底出站明确写清，比单纯增加规则数量更便于维护。
三款客户端都开源，侧重点并不相同
v2rayN 面向桌面使用，提供订阅管理、路由设置和代理模式等图形入口，适合需要在桌面集中检查配置的用户。v2rayNG 面向安卓并采用 Xray 内核，将连接配置与系统 VPN 授权结合；v2flyNG 则提供基于 V2Fly 内核的安卓选择。选型以设备、所需内核能力和操作习惯为依据，不把客户端之间的区别简化成单一的速度排名。
开源意味着可以按项目许可证查看、使用和研究代码，具体再分发与修改义务仍应以各项目许可证为准。客户端、内核与附带资源可能适用不同条款，不能给整个生态笼统套用同一个授权名称。开源属性有助于理解实现与维护方式，但实际连接仍受服务器、网络路径、配置内容和设备环境影响，不构成对每一种使用场景的性能保证。
更新前备份，更新后做同条件验证
图形客户端、内核和规则资源各有维护节奏。更新可能调整界面布局、配置转换、协议支持或系统集成方式，因此出现行为变化时，需要确认究竟改变了哪一层。升级前保存订阅分组、自定义路由和必要的参数记录；升级后先用原来的应用与访问目标复现基础连接，再恢复高级选项，避免把环境变化误判为更新效果。
比较两套配置时，应尽量保持设备、网络与目标一致，并记录系统代理、TUN 和 DNS 的状态。本站的设置说明用于建立可复查的操作顺序，不用缺乏上下文的延迟数字代替结论。遇到新字段、权限变化或启动错误，可先阅读完整手册，再按日志缩小范围；需要理解名词时，术语手册能帮助对应客户端界面与内核配置。
近期配置笔记
安装权限与启动日志
从平台部署到配置错误，按具体症状整理操作路径。先判断问题属于系统权限、程序启动还是请求连接，再选择对应文章。
macOS 安装 v2rayN：未验证开发者提示与网络权限处理
解决 macOS 上打开 v2rayN 时的“无法验证开发者”拦截，说明 Apple 芯片与 Intel 包的区别，以及系统代理、网络扩展授权的操作路径。
Linux 安装 v2rayN：deb/rpm 包部署与开机自启动设置
在 Debian/Ubuntu 与 Fedora 系发行版上用 deb、rpm 包安装 v2rayN，补齐依赖，配置桌面自启动项，并处理系统代理与 TUN 权限问题。
V2Ray 内核启动失败怎么办：从 v2rayN 日志定位配置错误
内核启动失败时先读日志：端口被占用、JSON 格式错误、未知协议字段、规则文件缺失各自对应的报错特征，以及逐项修正的顺序。