CONFIG NOTES 客户端配置 · 路由规则

V2Ray知识库 客户端下载与配置教程

下载v2rayN 查看教程

整理 四平台客户端入口，按订阅导入与路由分流顺序说明配置。

中文操作说明 Xray / V2Fly 开源客户端
CLIENT
v2rayN / v2rayNG
CORE
Xray · V2Fly
READING
从安装到规则维护
routing.domainStrategy IPIfNonMatch
路由设置 · 规则批注
MANUAL / 章节
  • 核心概念
  • 订阅分组
  • 代理模式
  • 路由分流
  • TUN 模式
  • DNS 设置
域名策略 IPIfNonMatch
匹配条件 出站标签 备注
geosite:category-ads-all →block 广告域名
geoip:private →direct 私有地址
geosite:cn →direct 域名集合
geoip:cn →direct 地址集合
final →proxy 默认出站

按顺序匹配；final 为默认出站的示意名称。

命中说明rules[2]
{
  "type": "field",
  "domain": ["geosite:cn"],
  "outboundTag": "direct"
}

域名命中 geosite:cn 后，使用 direct 标签指定的直连出站。

示例依赖对应规则数据与出站定义；实际结果以运行日志为准。

SETTINGS / 配置索引

客户端设置与规则批注

先区分接入方式与出站规则，再调整内核和解析行为。左侧目录按日常配置顺序组织，代码只展示相关字段，不是可直接导入的完整配置。

订阅地址与配置分组

订阅分组 → 添加
分组名称：日常配置
订阅地址：由配置提供方给出
订阅分组 → 更新当前订阅

订阅用于批量管理连接配置，不等同于客户端账号。先在订阅分组中添加地址并保存，再更新当前分组，确认列表出现可选配置。分组名称用于区分来源，后续更新会影响该组内容，手动修改前应先备份。与逐条粘贴分享链接相比，订阅便于集中刷新；遇到空列表时，应先检查地址是否完整、是否过期以及本机能否访问订阅服务，不要反复更换路由模式。不同界面的菜单名称可能略有差异。

延伸阅读 → 使用手册：订阅导入

CLIENT SHELF / 平台入口

V2Ray 客户端按系统选择

桌面端从 v2rayN 开始，安卓端优先了解 v2rayNG。下载前先看系统与处理器架构，再选择安装形式；客户端安装完成后，还需要来自可信来源的有效连接配置。

Windows

v2rayN / Desktop · WPF

适合以浏览器、办公软件为主的桌面使用场景。下载页区分新一代跨平台界面的桌面版与经典 WPF 版，可根据界面习惯和运行环境选择。首次配置建议先使用系统代理，待订阅、连接与路由正常后，再评估是否需要 TUN。

安装或解压后保留可写的配置目录；迁移电脑时应备份订阅分组与自定义规则，而不只是复制程序快捷方式。

前往下载 →

macOS

v2rayN / Apple Silicon · Intel

先从系统菜单打开“关于本机”，查看显示的是芯片还是处理器型号。Apple Silicon 与 Intel 使用不同架构的安装入口，不应只按文件名称是否相近来判断。安装后再检查客户端运行权限与系统代理状态。

若浏览器能连接而其他应用不能，先确认应用的代理设置。虚拟网卡权限与普通系统代理是两条不同的排查路径。

前往下载 →

Android

v2rayNG / v2flyNG

v2rayNG 面向 Xray 内核配置，v2flyNG 可作为 V2Fly 内核生态的备选。主流较新设备通常选择 arm64，架构不确定时再查看通用包说明。首次连接需要确认系统的 VPN 连接授权，该授权用于本地网络接入，并不意味着已经有可用的远端配置。

后台断连还应检查省电限制与后台运行权限。需要分应用代理时，先读清名单模式的含义，再决定哪些应用接入。

前往下载 →

Linux

v2rayN / deb · rpm

按发行版的软件包格式选择 deb 或 rpm，再核对设备是 x64 还是 arm64。图形客户端适合桌面会话中的订阅管理与规则调整；系统代理能否被应用读取，还受桌面环境及应用自身设置影响。

涉及 TUN 或系统路由时，需要额外关注权限与其他网络服务。先验证普通代理，再扩大接管范围，可减少多项设置叠加造成的定位困难。

前往下载 →

查看全部客户端 →

FIRST CONNECTION / 操作顺序

订阅导入到连接验证

第一次使用先建立一条可复现的连接流程。不要同时修改代理模式、DNS 与内核，否则连接结果发生变化时，很难确定是哪一项设置起作用。

  1. 添加订阅，确认配置已导入

    桌面端在订阅分组中保存地址，再执行当前分组更新；安卓端通过订阅设置添加并刷新。订阅地址可能带有个人访问标识，不宜放到公开截图或聊天记录中。导入后核对配置名称、协议类型与分组来源，空列表应先排查订阅获取过程。

    只有单条分享链接时，使用客户端提供的剪贴板导入功能。订阅更新与手动导入是不同操作，不要把分享链接填进订阅地址栏。菜单名称随界面有所变化时，按“添加来源、保存、更新”的顺序寻找对应功能。

  2. 选择配置，设置接入与分流

    将一条有效配置设为活动项，再选择接入方式。桌面端先尝试系统代理；安卓端确认连接授权后启动服务。路由从客户端提供的基础分流模式开始，先记录当前选项，避免未经验证就添加大量自定义规则。

    系统代理与全局路由不在同一层：前者负责把请求送进客户端，后者负责选择出站。目标应用若不读取系统设置，需要单独配置代理，或在明确影响范围后考虑 TUN。切换路由模式不会修复缺失的服务器参数。

  3. 查看日志，分别验证解析与访问

    启动后查看是否有配置解析、连接建立或域名解析错误，再用目标应用发起实际请求。一个测试结果只能说明某一条路径，不能代表所有协议与应用都正常。应同时确认常用直连服务与需要代理的目标是否符合预期。

    出现问题先回到最简单的工作配置：关闭新加的接管功能，恢复基础路由，再逐项开启。测试结束若暂时不使用客户端，应同步检查系统代理是否已恢复；仅关闭窗口，不一定等于停止后台服务或清除系统设置。

查看完整教程 →

PROJECT V / 生态说明

Project V、内核与图形客户端

“V2Ray”在日常讨论中可能指项目、内核或一类配置工具。先明确各层职责，才能判断某个功能属于客户端界面，还是取决于内核与服务端。

Project V 的模块化思路

Project V 生态以模块化网络代理能力为基础，将入站、路由与出站等职责拆开。请求先通过入站进入处理流程，随后按路由条件选择出站。理解这一顺序，比记住某个按钮的位置更持久：界面改版后，接入范围、匹配条件与连接参数仍然需要分别检查。V2Ray 相关讨论中常见的“配置”，也可能只是一条远端连接信息，而不是包含全部本地行为的完整配置文件。

V2Fly 与 Xray 的能力边界

V2Fly 延续 V2Ray 相关开源项目的开发与维护，Xray 则形成了独立演进的内核分支。两者共享部分历史与概念，但协议、安全参数及配置行为并非始终一致。VLESS、VMess、Trojan 属于连接协议层面的概念，传输与安全设置还需另外核对；不能仅凭同一协议名称，就假设一份配置可以在所有内核之间原样迁移。遇到不识别的字段，先查支持范围，再考虑转换配置。

三款客户端的开源属性

v2rayN、v2rayNG 与 v2flyNG 都属于开源图形客户端，负责降低配置管理的操作成本。v2rayN 面向桌面平台，v2rayNG 主要使用 Xray 内核，v2flyNG 面向 V2Fly 内核。它们不是远端服务本身，安装程序也不会自动生成可用订阅。开源意味着源代码可按相应许可查看和使用，并不等同于对任意订阅来源或远端服务作出保证。客户端、内核及其依赖可能分别采用不同许可，使用和分发时应以各项目实际许可文本为准。

更新与日常维护

客户端更新、内核更新与规则数据更新是三件事。客户端更新可能调整界面或配置生成逻辑；内核更新影响协议实现与运行行为；规则数据更新则会改变域名、地址集合的匹配结果。更新前备份订阅分组、自定义路由和重要设置，更新后先验证原来能工作的场景，再启用新功能。排查时记录系统、客户端类型、所用内核及报错阶段，比只说“无法连接”更有助于缩小范围。日志分享前还应移除订阅地址和个人连接信息。

本站的文档范围

V2Ray知识库整理下载入口、图形客户端操作与配置概念，不是客户端的官方发布方，也不提供节点或订阅服务。说明以功能职责和排查顺序为主，具体菜单与可用选项以安装的构建为准。初次使用从上手文档开始；需要解释参数关系时阅读使用手册；遇到单一术语或重复报错时，再进入术语手册与 FAQ，避免为了一个局部问题整体替换已经可用的设置。

关于本站 · 阅读完整使用手册 · 查看常见问题

TECHNICAL NOTES / 近期笔记

部署、安卓设置与速度排查

按实际问题拆解设置，不把所有连接失败都归结为同一个原因。以下三篇笔记分别覆盖本地客户端、网关部署与安卓后台行为，适合在基础连接验证完成后继续阅读。

查看全部文章 →

下载客户端