Windows
v2rayN 首推v2rayN 提供 Desktop 桌面版与经典 WPF 版。前者采用跨平台界面，后者保留熟悉的桌面操作布局。两种入口都应先确认系统与处理器要求，再选择安装包；不要仅凭文件大小判断适配情况。
初次安装后，先导入已有订阅或连接信息，选择一个配置并启动内核，再设置系统代理。系统代理影响遵循系统设置的应用，并不等于所有程序的连接都已接管。需要处理更多应用时，再阅读 TUN 说明。
客户端入口 / 配置字段参考
V2Ray 客户端官网v2rayN 下载与配置
按系统选择开源客户端，从订阅导入到 config.json 字段，对照配置与解析路径。
- Xray-core
- V2Fly-core
- GPL-3.0
V2Ray 客户端下载入口
先选操作系统，再确认处理器架构与安装格式。桌面端使用 v2rayN；安卓端优先了解 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。
macOS
v2rayNv2rayN 按 Apple Silicon 与 Intel 芯片提供不同入口。可在系统的“关于本机”中查看芯片或处理器信息，再选择对应架构。芯片类型与安装包架构需要匹配，不能用桌面外观或设备年份替代判断。
安装后先完成客户端本身的启动与配置导入，再检查系统网络代理。若只有部分应用能连接，应分别核对应用是否遵循系统代理、路由是否命中预期出站，以及域名解析是否使用了正确路径，避免反复重装。
Android
v2rayNG 首推v2rayNG 使用 Xray 内核；v2flyNG 使用 V2Fly 内核，适合需要对应内核行为的配置。主流较新设备通常选择 arm64，无法确认处理器架构时，可先了解通用包的适用范围。两款客户端的配置兼容性仍需逐项核对。
启动连接时，系统会请求建立 VPN 连接的权限。这是安卓客户端接管流量的系统入口，不代表服务端已经可用。首次连接应观察客户端日志，同时检查按应用代理设置；其他使用同类系统通道的程序可能造成冲突。
Linux
v2rayNv2rayN 提供适配不同发行版的软件包。Debian、Ubuntu 系通常使用 deb，Fedora 等发行版通常使用 rpm；处理器还需区分 x64 与 arm64。包格式解决安装方式，处理器架构解决可执行文件兼容问题，两者都要确认。
桌面环境、系统代理与自启动项是三个独立环节。建议先在图形界面中完成一次手动连接，再配置登录后启动。若程序能运行但应用连接失败，应先看桌面代理设置和应用自身的代理选项，再检查权限与依赖。
客户端负责本地配置与连接管理。实际连接还需要可用的服务端参数；下载并安装程序不会自动生成订阅或远端账户。
查看全部客户端 →客户端设置与配置字段
从界面操作追到实际配置。以下均为局部示例，用于解释数据流向；客户端管理项与内核字段分别说明，不把片段当成完整连接配置。
inbounds.json / 导入后的本地入口
订阅由客户端管理
订阅导入用于批量保存连接条目，更新地址属于客户端管理数据，不是通用 config.json 的顶层字段。v2rayN、v2rayNG 与 v2flyNG 的菜单和存储方式有所不同，导入后都应检查协议、地址与传输参数。下方展示的是选定条目后可配套使用的本地 SOCKS 入站，而不是订阅文件。监听限制在回环地址，可让本机应用通过该端口交给内核处理；订阅更新也不应覆盖自行维护的路由规则。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"udp": true
}
}
]
}
routing.json / 按规则选择出站
规则顺序与出站标签
路由分流把不同目标交给不同出站，而不是重新定义远端连接参数。规则按顺序匹配，具体规则应放在宽泛规则之前。示例把私有地址交给名为 direct 的出站，该标签必须同时存在于 outbounds 中。v2rayN 可以通过界面维护路由，安卓客户端的预设与自定义入口则有所不同。修改后应重新加载配置，并检查日志中的目标地址与出站标签；如果域名尚未解析，只写 IP 规则未必能得到预期结果。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
},
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}
outbounds.json / 接管后的出口示例
接管范围与路由分开设置
TUN 通过虚拟网络接口接收流量，通常用于处理不遵循系统代理的应用。v2rayN 的具体实现、权限要求与所用组件有关；安卓客户端则通过系统 VPN 接口接管，不能直接套用桌面开关。通用 V2Ray 配置没有可跨内核照搬的顶层 tun 开关。下方只展示接管后可使用的直连与阻断出站，并不创建虚拟网卡。开启前应确认其他网络接管程序是否冲突，并准备恢复系统网络设置的路径。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {}
}
]
}
dns.json / 内置解析服务器
先确认解析发生在哪里
DNS 设置需要同时考虑谁发起查询、查询走哪条连接，以及解析结果如何参与路由。内核的 dns 段并不会自动替换全部应用的系统解析设置。示例使用 localhost 调用本机解析路径，适合说明服务器列表的结构，不代表适用于所有网络环境。v2rayN 与安卓客户端可能另外提供远端解析、虚拟地址或接管相关选项，修改时应核对实际生成的配置。出现域名失败而 IP 可达时，先区分解析错误与路由错误。
{
"dns": {
"servers": [
"localhost"
]
}
}
policy.json / 核对内核配置支持
按协议与字段选择内核
多内核切换是客户端能力，不是 config.json 中的统一切换字段。v2rayN 可按其支持情况选择内核；v2rayNG 与 v2flyNG 则分别面向 Xray 与 V2Fly。相近的配置结构不表示所有协议、传输与扩展字段完全兼容，切换前应先核对服务端要求。下方 policy 片段演示用户级策略的写法，能否生效还取决于相关用户是否使用对应 level。迁移时先保留可用配置，再逐项测试，避免同时更换内核与路由。
{
"policy": {
"levels": {
"0": {
"handshake": 4,
"connIdle": 300
}
}
}
}Project V、V2Fly 与 Xray
区分项目生态、连接内核和图形客户端。协议由两端协商，客户端负责把配置交给内核运行；名称相近不代表配置可以直接互换。
ecosystem / 组成层次
- 项目背景
- Project V
- 内核家族
- V2Fly / Xray
- 桌面客户端
- v2rayN
- 安卓客户端
- v2rayNG / v2flyNG
- 配置结构
- JSON / 入站 / 出站 / 路由
- VMess
- VLESS
- Trojan
- GPL-3.0
协议名称用于定位配置要求，不代表任意内核与传输组合都可直接使用。
生态历史与职责边界
Project V 是理解 V2Ray 技术背景的起点。代理内核围绕入站、出站与路由组织连接，图形客户端再提供订阅列表、系统代理和设置界面。V2Fly 延续了 V2Ray 相关开发，Xray 则形成独立发展的内核分支。两者保留一些相近概念，但后续功能与配置演进并不完全一致。阅读资料时，应同时确认资料对应的内核，而不只看标题中的 V2Ray 名称。
内核家族与协议兼容
VMess、VLESS、Trojan 是连接协议，TCP、WebSocket 等描述传输方式，TLS 则涉及传输安全设置。这些层次要组合起来理解，不能用单个协议名代替完整配置。选择内核时，应先看服务端给出的协议、传输、安全参数和扩展要求，再确认客户端能否生成相应字段。遇到不兼容时，先定位具体字段，不宜把所有问题归结为客户端安装失败。
三款客户端与开源许可
v2rayN、v2rayNG 与 v2flyNG 均为开源图形客户端，其客户端项目采用 GPL-3.0 许可。内核、规则数据与附带组件可能使用各自的许可，不能用客户端的许可标签概括全部依赖。开源提供了阅读实现与理解配置的途径，但并不替代对服务端来源、订阅权限和系统权限的判断。订阅地址可能包含访问凭据，分享截图或日志前应移除敏感内容。
更新机制与配置迁移
客户端更新、内核更新、订阅更新和规则数据更新是不同操作。客户端更新影响界面与配置生成方式，内核更新影响字段支持和连接行为，订阅更新改变连接条目，规则更新改变匹配范围。准备调整环境时，先保存当前可用配置与自定义规则，再一次只改变一个环节。完成后重新加载配置，并分别测试域名解析、直连目标与代理目标，便于定位变化来源。
V2Ray 技术笔记
按具体问题阅读。先理解配置结构，再处理解析路径与平台部署；文章中的局部示例需要结合所用客户端与内核判断。
v2rayN Linux 版安装：deb/rpm 包部署与开机自启动设置
介绍 Debian、Ubuntu 与 Fedora 系发行版的桌面安装路径，说明包格式、架构选择、自启动项与常见依赖问题。把软件安装、桌面启动和网络代理分开检查。
阅读笔记 →V2Ray config.json 逐段拆解：inbounds、outbounds 与 routing 怎么写
从顶层结构解释入站监听、出站连接和路由标签的关系。对照 JSON 片段理解客户端生成的配置，区分本地监听参数与服务端连接参数。
阅读笔记 →V2Ray DNS 分流解析设置：国内外域名分开解析与防污染配置
解释 dns 段的 servers、domains 与 expectIPs 字段，讨论本地解析、远端解析及其与路由的关系。先确认查询路径，再判断解析结果是否符合预期。
阅读笔记 →技术笔记按问题展开；字段的完整层级与使用范围见配置参考。
查看全部文章 →