client workflow

从订阅导入到路由分流

客户端配置不是单个开关。按订阅、代理、路由和验证四个环节逐项处理，可以更快定位设置问题，也便于在不同设备之间保持一致的使用逻辑。

subscription

订阅导入与更新顺序

订阅链接用于集中传递客户端可以识别的配置。首次使用时先复制完整地址，再在订阅分组中新增来源并执行更新。列表出现配置后，还要选择当前使用项，不能把“导入成功”等同于“已经连接”。后续更新应在原分组上执行，以免重复创建同名条目。若更新失败，先检查地址是否被截断、系统时间是否准确，再判断网络状态和订阅来源是否可用。

查看订阅导入步骤

订阅分组 按来源管理

新增订阅填写地址

更新订阅手动执行

选择配置设为活动项

routing

用规则表达流量去向

路由规则决定不同域名、地址和应用流量应走哪个出口。刚开始使用时，优先选择客户端提供的预设模式，确认基本连接稳定后再增加自定义规则。规则通常按顺序匹配，靠前的精确条件会先于后面的宽泛条件生效，因此修改时既要检查语法，也要检查位置。将局域网地址保留为直连，可以避免访问路由器、打印机或本地服务时绕行外部出口。

阅读路由规则语法

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

platforms

按操作系统选择客户端

桌面平台使用 v2rayN，移动设备可在 v2rayNG 与 v2flyNG 之间选择。下载中心会按系统和处理器类型列出对应文件，入口不会直接跳过平台说明。

desktop

Windows

适合使用 v2rayN 图形客户端。桌面版采用跨平台界面，经典 WPF 版保留熟悉的 Windows 操作方式；两者都支持订阅分组、系统代理、路由模式和连接测试。进入下载页后可根据界面习惯选择。

前往下载

desktop

macOS

使用 v2rayN 桌面客户端。下载前先在系统信息中确认芯片类型，再选择 Apple Silicon 或 Intel 对应安装文件。导入订阅和路由设置与其他桌面平台保持相近，迁移配置时更容易核对同名选项。

前往下载

mobile

Android

首选使用 Xray 内核的 v2rayNG，也可按配置来源和内核需求选择 v2flyNG。多数较新的设备适合 arm64 文件，无法确定处理器架构时可查看系统信息，再决定是否使用通用安装文件。

前往下载

desktop

Linux

v2rayN 提供适用于 Debian、Ubuntu、Fedora 等常见发行版的软件包。下载时先确认包管理体系与处理器架构，安装后再处理桌面托盘、系统代理和登录自启动，避免把发行版差异误判为客户端故障。

前往下载

查看全部客户端 →

quickstart

三步完成基础配置

先建立一条可以复现的基础流程，再调整路由和高级传输参数。这样遇到问题时能够明确判断是订阅、客户端还是系统代理环节出现偏差。

查看完整教程

01

安装对应客户端

桌面设备进入 v2rayN 下载区，Android 设备选择 v2rayNG 或 v2flyNG。安装前确认操作系统、处理器架构和软件包格式。首次启动后先熟悉订阅分组、服务器列表、路由模式与系统代理的位置，不急于修改高级选项。
02

导入并更新订阅

复制完整订阅地址，在客户端的订阅管理中新增分组并执行更新。列表出现配置后选中一个可用项，检查协议、地址、端口、传输方式和 TLS 等字段是否由订阅正确提供。二维码更适合设备间临时迁移，长期管理仍建议保留统一订阅来源。
03

连接并逐层验证

启动内核并开启所需代理模式，先确认日志没有端口冲突或配置解析错误，再进行真连接测试，最后用浏览器验证实际访问。基础链路稳定后再添加自定义路由与 DNS 设置；一次只改变一类参数，便于回退和比较结果。

open ecosystem

Project V、V2Fly 与 Xray

客户端、内核、协议和配置格式属于不同层次。理解它们之间的关系，比记住某个界面按钮更有助于迁移配置和处理兼容问题。

生态关系

Project V 形成了围绕代理协议、传输方式、路由规则和客户端工具的开源生态。V2Ray 常被用作这一技术体系的通称，但实际使用时需要继续区分图形客户端与底层内核。图形客户端负责导入订阅、生成配置、管理系统代理和展示日志；内核负责解析配置、建立连接、执行路由并处理入站与出站流量。把两层分开理解，可以解释为什么同一份订阅能够被不同客户端读取，也能解释为什么某些参数只在特定内核中生效。

内核家族

V2Fly 延续了 V2Ray 的社区维护方向，覆盖 VMess、VLESS、路由、DNS 与多种传输组合。Xray 在相近配置体系上继续发展，并加入更多传输与协议能力。二者不是客户端名称，而是可被图形客户端调用的核心程序。选择客户端时，应同时关注它默认使用的内核、订阅提供的协议参数以及服务端配置。只比较界面外观，无法判断一份配置能否完整加载。

三款客户端的分工

v2rayN 面向 Windows、macOS 与 Linux 桌面环境，提供订阅分组、路由设置、系统代理和日志查看等图形化功能，适合需要统一桌面操作流程的用户。v2rayNG 面向 Android，通常配合 Xray 内核使用，重点处理移动网络切换、应用代理和二维码导入。v2flyNG 同样面向 Android，以 V2Fly 内核为主要选择，可作为需要对应内核行为时的备选。三者都属于社区维护的开源客户端，但平台定位和内核组合并不完全相同。

开源协议与更新方式

开源项目的代码、许可证与发布记录提供了可追踪的维护依据。客户端更新通常包含界面修正、系统兼容调整、内核适配与配置格式变化；内核更新则可能涉及协议实现、路由能力和传输行为。更新前先阅读变更内容，并保留当前可用配置。若新安装后出现异常，应分别核对客户端设置与内核日志，而不是把所有问题归因于订阅。下载中心按平台组织入口，文档则按操作环节说明变化带来的影响。

common questions