01 / 客户端入口
先确认操作系统和处理器架构，再选择安装文件。桌面端查看 v2rayN；安卓设备优先查看 v2rayNG，需要 V2Fly 内核兼容性时再考虑 v2flyNG。下载页面集中提供入口与安装条件，首页不固定具体发行版本。
v2rayN 提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面，WPF 版延续经典桌面操作方式。两者都用于管理配置与订阅，选择时应以系统要求和实际操作习惯为准，不必为同一份订阅同时安装两套界面。
安装前在系统“关于”中确认系统类型。首次启动后先导入已有配置，选择活动配置，再设置系统代理。浏览器通常读取系统代理，终端和部分应用则需要单独设置代理地址；能启动客户端并不代表所有程序已经使用代理。
迁移已有配置时，先备份订阅分组和自定义路由。保留一套可用设置，再逐项调整本地端口与代理模式，便于定位差异。
v2rayN 的 macOS 安装入口按 Apple Silicon 与 Intel 区分。在“关于本机”中查看芯片或处理器信息，再选择对应安装文件。配置内容可以在不同桌面系统之间复用，但本地文件路径、权限和网络接入方式仍需重新确认。
完成安装后，先检查订阅能否正常导入，再核对当前配置与监听端口。系统代理和 TUN 接入的作用范围不同，后者还涉及网络权限与路由变化。初次配置建议先采用易于检查的接入方式，确认访问结果后再增加规则。
遇到系统安全提示时先阅读提示内容，确认所选文件与设备架构一致。不要将启动失败、权限请求和远端连接失败混为同一个问题。
v2rayNG 使用 Xray 内核，适合管理常见分享链接与订阅；v2flyNG 使用 V2Fly 内核，作为特定配置需求的备选。多数较新的设备可选择 arm64，无法确认架构或遇到安装兼容问题时，再对照下载页说明选择通用版。
导入配置后还需要选择活动条目并启动连接。系统会请求建立 VPN 连接，这是客户端将应用流量接入本地转发链路的步骤。若已有其他应用占用同类连接，应先确认冲突，再检查分应用代理、路由模式与电池后台限制。
v2rayNG 订阅导入和单条链接导入不是同一个入口。需要后续更新一组配置时使用订阅分组，临时导入单条配置时使用剪贴板或扫码方式。
Linux 桌面端使用 v2rayN，按发行版的软件包体系选择 deb 或 rpm，再核对处理器是 x64 还是 arm64。包格式与处理器架构是两个独立条件：文件可以被包管理器识别，并不表示其中程序一定能在当前处理器上运行。
安装后在图形界面中导入订阅并检查本地监听。桌面环境、浏览器和终端对代理设置的读取方式可能不同，因此应分别验证。启用 TUN 前还要确认所需权限与系统路由，避免同时运行多套接管流量的工具造成冲突。
排查时先保留默认路由与端口，观察日志是否出现监听错误或解析错误。先区分客户端启动问题和应用接入问题，再修改内核配置。
02 / 配置段落索引
图形界面负责生成和管理配置，内核按配置执行转发。先理解数据从哪里进入、由哪条出站发送，再调整路由与 DNS，能减少把多个设置同时改错的情况。下列片段用于解释字段，不是可以直接连接远端的完整配置。
本地入站接收浏览器或其他应用交来的连接。图形客户端通常代为生成这段配置，日常使用先在设置中核对监听端口，再让应用使用同一地址与端口。示例仅监听回环地址，适合本机接入；改为对局域网开放前，需要另行处理访问控制。SOCKS 与 HTTP 入站的使用方式不同，不应只改端口而忽略协议。出现端口占用时，应先查找冲突程序，而不是反复更换远端配置。
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
]
}出站描述连接最终如何发送。代理出站需要服务端提供的地址、端口和认证参数，不能仅凭协议名称自动建立连接。示例展示直连与阻断两种基础出站，便于理解标签如何被路由引用。使用 VMess、VLESS 或 Trojan 时，还要核对传输方式和安全层；REALITY 属于安全传输相关能力，不是与这些协议完全同层的替代项。优先保留导入参数，再依据实际内核支持调整，避免自行猜测字段组合。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {}
}
]
}路由规则负责把匹配到的连接交给指定出站，并不负责创建该出站。示例将私有地址交给 direct，实际配置中必须存在同名标签，并具备可读取的地址数据文件。规则通常按顺序处理，范围较大的规则放得过早，可能覆盖后面的精细规则。IPIfNonMatch 表示域名规则未命中时尝试解析以继续匹配 IP 条件，不等于所有域名始终预先解析。调整后应同时观察目标域名与命中出站，确认规则实际生效。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}DNS 设置影响内核需要解析域名时的行为，但不代表所有应用查询都会自动进入内核。应用是否自行解析、是否启用流量接管，以及出站如何处理域名，都会影响最终路径。示例限定查询 IPv4，并使用本地解析来源，适合说明字段关系，不是通用优化方案。只有在确认设备网络与目标服务条件后，才应限制地址族。若出现域名访问失败而地址访问正常，应先检查解析日志与解析来源，再考虑修改服务器列表。
{
"dns": {
"servers": ["localhost"],
"queryStrategy": "UseIPv4"
}
}03 / 开源生态与维护
产品名称、内核名称和协议名称分别描述不同层次。选择客户端时先看运行平台；确认配置能否使用时，再看内核支持范围和服务端参数。开源生态提供可审阅的实现与持续迭代，但实际连接结果仍取决于配置、系统和网络条件。
PROJECT V
Project V 是理解 V2Ray 工具生态的起点。内核实现负责协议处理、连接转发、路由与解析等基础能力；图形客户端在其上提供配置编辑、订阅管理与系统接入功能。因此，搜索“V2Ray 官网”或“V2Ray 客户端”时，可能会遇到项目文档、内核说明和图形程序等不同内容。本站按下载、入门和字段参考划分入口，避免把这些层次混在一张安装清单里。
理解这一区分后，故障也更容易归类：导入菜单找不到，通常先看客户端操作；日志提示字段不被识别，要核对内核能力；浏览器未接入本地端口，则需要检查系统代理。更换图形界面不一定能修复远端参数错误，修改协议也不能替代正确的应用接入设置。
XRAY / V2FLY
V2Fly 延续 V2Ray 的社区维护路线，Xray 在相关技术基础上发展出自己的功能和配置能力。二者存在共同概念，但新增字段、传输组合和默认行为不应被视为完全一致。尤其涉及 REALITY 与 XTLS Vision 时，应核对 Xray 的适用配置，而不是将片段直接放入任意内核。选择内核的依据是所需功能与配置兼容性，不是单看名称或假定某一个始终更快。
V2Ray 协议选择也需要服务端配合。VMess、VLESS 与 Trojan 的认证方式不同，TLS、REALITY 及传输层参数又涉及另一组条件。分享链接通常携带这些组合信息，导入后应检查地址、端口、服务器名称与流控设置。某项测试成功只证明特定测试链路可用，不代表所有目标站点和应用场景都已验证。
CLIENTS
v2rayN 面向桌面环境，提供订阅分组、活动配置选择、路由管理和代理接入设置；具体可用内核由发行包与客户端支持范围决定。v2rayNG 面向安卓设备，结合 Xray 内核与系统 VPN 接入管理连接。v2flyNG 同样面向安卓设备，但采用 V2Fly 内核，适合已有配置明确依赖该实现的场景。这三款客户端均属于开源项目，实际使用仍应阅读对应发行说明与许可文件。
客户端负责保存配置，不负责自动提供服务端。订阅地址和认证参数需要从可信来源取得，并按使用授权妥善保管。订阅链接可能包含访问凭据，排查问题时不应将完整地址公开贴出。需要分享错误信息时，可以保留错误类型、字段名和发生步骤，同时移除地址中的个人标识与认证内容。
LICENSE / UPDATE
开源许可说明源代码的使用、修改与再分发条件。图形客户端、内核和附带数据资源可能适用不同许可，不能将整个生态简单归为同一个许可名称。免费使用也不改变服务端资源、网络访问和第三方服务各自的使用条件。配置手册解释技术字段，不替代项目的许可文本，也不对任意来源的配置作适用性保证。
更新客户端是替换程序与相关组件；更新订阅是重新获取一组连接配置；更新路由数据则会改变 geosite、geoip 等分类的匹配基础。三者解决的问题不同。升级前备份自定义路由与订阅分组，升级后先验证已知可用的配置，再逐项启用新功能。不要把“订阅更新成功”当成程序已经更新，也不要在一次故障排查中同时改动全部配置。
04 / 配置专题
以下专题分别处理配置来源、连接分流与应用接入。先按问题所在层次阅读，再回到客户端核对结果。格式转换只能改变表达方式，不能补齐缺失的服务端参数；路由规则只能选择已有出站，也不能替代正确的连接配置。
对比三种常见订阅与配置格式的结构和适用场景，并给出互相转换的思路，以及转换后在客户端里核对导入结果的方法。
阅读文章 →用真实 routing 片段演示中国大陆站点直连、境外站点走代理的分流写法，并讲清 domainStrategy 的取舍与规则匹配顺序。
阅读文章 →浏览器和终端读取代理设置的方式不同。按插件冲突、PAC 模式、环境变量、本地端口四个方向逐项排查。
阅读文章 →