开源客户端 / 配置指南

V2Ray官方下载站客户端与配置指南

下载v2rayN 查看教程

以 订阅管理整理连接配置，用 路由分流区分流量去向，按应用需要选择系统代理或 TUN 模式。

Project V 生态Xray / V2Fly中文操作文档
PLATFORMS
DESKTOP
v2rayN
MOBILE
v2rayNGv2flyNG
ROUTING
GeoSiteGeoIP
WORKFLOW
导入 → 分流 → 验证

CONFIGURATION / WORKSPACE

订阅、路由与流量接管

图形客户端负责组织配置，内核负责实际连接。先确认配置来源，再调整流量进入客户端的方式，最后检查规则命中结果。下面按日常操作拆解关键功能，示例用于说明字段关系，不是完整的连接配置。

configuration / notes

订阅链接先保存，再更新

订阅把多条服务器配置集中在一个地址中。打开订阅分组设置，填写便于辨认的名称与链接，保存后执行更新订阅，列表才会载入配置。与逐条粘贴分享链接相比，分组便于统一刷新和区分来源，但更新也可能替换组内条目。更新前保留手动修改项，更新后重新确认活动服务器。订阅地址可能包含访问凭据，应按敏感信息保存；排查时只记录错误类型，不公开完整地址。

订阅地址格式示意（示例域名）：
https://example.com/subscription

操作顺序：
订阅分组 → 添加 → 保存 → 更新订阅

CLIENT / PLATFORM

按系统选择客户端

先在系统信息中确认处理器架构，再进入对应下载分组。桌面平台统一以 v2rayN 为主，Android 按内核需求选择客户端。客户端提供本地配置管理功能，安装完成并不等于已有可用服务器；仍需准备有权使用的订阅或配置。

Windows

v2rayN 提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面，WPF 版沿用经典桌面交互。选包前查看系统类型与运行要求，安装后把程序和配置放在可写入的位置，避免因目录权限导致设置不能保存。

首次运行先导入订阅、选中服务器，再启用自动配置系统代理。若浏览器可连接而其他应用不生效，应检查应用是否读取系统代理，不要直接把问题归因于订阅。需要更完整的接管时，再按教程检查 TUN 所需权限。

前往下载

macOS

v2rayN 按 Apple Silicon 与 Intel 芯片区分安装包。通过“关于本机”查看芯片或处理器信息，选择匹配的架构。安装后从应用目录启动；若系统要求确认打开来源，先核对应用来源，再通过系统提供的安全设置完成确认。

系统代理与虚拟网卡接管使用不同的系统机制。初次配置应先验证普通代理，观察浏览器请求与客户端日志。遇到网络扩展、授权或其他连接工具冲突时，记录当前状态，逐项排查，不要一次修改多处系统网络设置。

前往下载

Android

优先了解使用 Xray 内核的 v2rayNG；需要 V2Fly 内核时，可查看 v2flyNG。主流较新设备通常选择 arm64 包，架构不明确时查看设备资料或通用版说明。安装授权只对所用安装来源开启，完成安装后按需要恢复设置。

导入订阅后执行更新，选择配置并启动连接，首次启动需要确认系统连接授权。后台连接容易受到省电策略影响，可按设备设置允许必要的后台运行。切换客户端前先停止已有连接，避免多个接管实例互相干扰。

前往下载

Linux

v2rayN 提供 deb 与 rpm 入口，并区分 x64、arm64 架构。Debian、Ubuntu 系通常选择 deb，Fedora 等发行版通常选择 rpm；实际仍以发行版的软件包机制为准。先完成桌面启动与依赖检查，再设置用户会话中的自动启动。

桌面环境的系统代理支持并不完全一致，部分应用需要单独配置代理入口。安装成功后应分别验证图形界面、内核启动和应用请求。TUN 所需权限与网络路由也要单独处理，不能用安装包已经成功部署来判断接管已经生效。

前往下载
查看全部客户端 →阅读全平台安装大全 →

QUICKSTART / THREE STEPS

从订阅导入到连接验证

把配置、接管和验证分开处理。这样可以判断问题发生在哪一层，也便于在修改失败时恢复上一份可用设置。桌面端以下以 v2rayN 为例，Android 的 v2rayNG 操作名称可能不同，但顺序相同。

  1. 01 / IMPORT

    保存订阅并获取配置

    进入订阅分组，添加名称和完整订阅地址，保存后执行更新。链接末尾的查询参数可能参与访问认证，不要自行截断。若复制自聊天或文档，检查是否混入空格、换行或中文标点。只有完成更新后，配置条目才会进入服务器列表。

    列表为空时，先确认选中的分组，再查看更新日志。返回网页内容、认证失败和解析失败是不同问题，应分别处理。手动分享链接应通过相应的导入入口使用，不能仅凭外观把它当作订阅地址填入。

  2. 02 / CONNECT

    选择服务器与接管方式

    选中要使用的配置并设为活动服务器，先保留适合当前需求的路由预设。桌面端启用自动配置系统代理后，用会读取系统设置的浏览器测试。Android 启动连接时确认系统授权，并观察状态栏是否出现对应的连接标记。

    系统代理决定应用如何把请求交给本地入口，路由决定内核收到请求后选择哪个出站，两者并不互相替代。先验证普通连接，再考虑 TUN；若直接同时修改 DNS、路由和接管方式，失败后很难判断是哪项设置引起变化。

  3. 03 / VERIFY

    用实际请求确认结果

    打开目标页面，结合日志确认请求是否进入客户端、内核是否启动、远端是否返回响应。单次连通测试只能说明某条测试路径的结果，不能代表所有应用、域名和传输都可用。验证时同时保留一个直连场景，检查局域网服务是否仍能正常访问。

    遇到失败，按配置解析、内核启动、域名解析、连接建立的顺序定位。记录错误类型和触发动作，分享日志前移除订阅地址及个人信息。准备退出客户端时先清除系统代理，避免应用继续请求已关闭的本地端口。

查看完整教程 →连接问题与配置问答 →

PROJECT V / CORE / CLIENT

开源生态与客户端分工

V2Ray、V2Fly、Xray 与图形客户端并不是同一种组件。理解各自负责的部分，比只比较软件名称更有助于选型，也能缩小配置错误的排查范围。

CONCEPT

Project V

模块化代理与路由设计

CORE FAMILY

V2Fly / Xray

配置解析、传输与出站处理

GRAPHICAL CLIENT

v2rayN / v2rayNG / v2flyNG

订阅、界面与系统设置

Project V 与内核家族

Project V 是理解 V2Ray 技术背景的入口，其模块化设计将入站、出站、传输与路由等职责分开。V2Fly 社区延续 V2Ray 的开发维护，Xray 从相关代码基础发展出另一条内核路线。两者具有共同的技术背景，但功能演进和字段支持并不完全一致。看到同样的协议名称，也仍需核对具体传输方式与安全参数，不能据此判断配置可以直接互换。

内核负责实际建立连接，图形客户端负责生成、保存和组织配置。出现启动失败时，应先看内核解析日志；若只是订阅分组、界面偏好或自动启动异常，则更可能需要检查客户端层。把这两层分开，可以避免在界面设置上反复操作，却忽略了实际不被支持的协议字段。

三款开源图形客户端

v2rayN 面向桌面系统，提供服务器列表、订阅分组、路由设置以及系统代理等管理入口。v2rayNG 面向 Android，使用 Xray 内核；v2flyNG 同样面向 Android，是采用 V2Fly 内核的备选。三者均有开源项目背景，但不是同一个程序的不同名称，配置入口、系统授权和功能覆盖应分别查看。选择时先按设备平台筛选，再按所需协议及内核兼容性决定。

开源协议说明代码使用、修改和分发的条件，不等于对每个运行环境作出兼容保证。V2Fly 的 V2Ray 与 Xray-core 采用的开源许可路线有所不同，图形客户端及随附组件也可能适用各自的许可。普通使用与重新打包分发是不同场景；涉及再分发时，应阅读对应发行物中的许可文件，并保留要求的版权和许可说明。

更新对象需要分别确认

客户端、内核、规则库和订阅是不同的更新对象。客户端更新可能改变界面和配置生成方式，内核更新影响协议能力及连接行为，GeoIP 与 GeoSite 更新影响分类匹配，订阅更新则会刷新服务器条目。某一项完成更新，不代表其他项已同步变化。遇到规则失效，应同时确认所用标签、规则库来源和加载位置，而不是只重复更新订阅。

调整之前先保留当前可用配置，并记下修改的设置。一次只变更一类对象，变更后用相同的请求场景复测；如果结果异常，就能更快还原。涉及服务器参数的问题还需要与配置提供方核对，客户端本身不会生成服务器服务，也不会自动修复已经失效的访问凭据。更多平台差异与安装细节可继续阅读全平台安装配置大全。

NOTES / CONFIGURATION

客户端与路由配置文章

按实际操作主题补充说明：先了解主窗口的设置入口，再理解内核分工，最后维护分流依赖的规则库。文章中的配置片段需要结合当前客户端与内核支持范围使用，修改后应检查日志与实际请求结果。

查看全部文章 →
下载客户端