Project V 生态
Project V 为 V2Ray 的协议与配置方式奠定基础。围绕这些基础形成了内核实现、图形客户端和规则数据等不同项目。它们之间存在技术关联，但不应把任何一个图形界面的功能列表直接等同于整个生态的能力。阅读设置说明时，先辨认讨论的是客户端操作、内核参数，还是服务器提供的连接信息。相同术语可能出现在不同层级；把层级分清，再修改配置，能减少因设置位置不对而产生的排查成本。
CONFIGURATION / 01
配置能力与对应设置
从系统代理到流量路由，先确定需要处理的流量范围，再选择客户端中的对应功能。下列片段用于说明配置结构；实际使用时以客户端界面和当前内核支持的字段为准。
先区分本地监听与系统代理
本地 SOCKS 入站负责接收应用发出的代理请求；系统代理则把遵循操作系统设置的应用引向这个本地端口。两者不是同一个开关。日常浏览可先开启“自动配置系统代理”，需要按目标地址决定是否经过代理时再检查 PAC 模式。终端或单独指定代理的浏览器可能使用自己的设置，不能仅凭菜单栏状态判断它们是否接入。遇到页面无法加载，先核对本地端口、系统代理指向和当前服务器状态，逐项排除比反复切换节点更容易定位问题。
{
"inbounds": [{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth" }
}]
}按域名与目标地址决定出站
路由规则将命中的流量交给指定出站，而不是替换服务器配置。常见顺序是先处理明确的直连域名与私有地址，再让剩余请求进入默认出站。规则自上而下匹配，因此范围较宽的规则如果放在前面，可能抢先覆盖更具体的条目。编辑前先确认内核已加载对应的地理数据，并检查规则所引用的出站标签确实存在。若网页与应用出现不同结果，还要检查它们是否通过同一个本地入站发送请求；未经过客户端的流量不会参与这组规则。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [{
"type": "field",
"domain": ["geosite:private"],
"outboundTag": "direct"
}]
}
}将订阅来源与服务器选择分开
订阅分组保存的是更新来源；组内服务器列表是一次更新后得到的结果。添加地址后，需要执行更新操作并确认列表确实出现服务器，随后再选择具体条目作为活动服务器。管理多个来源时，给每组使用可识别的名称，有助于判断条目来自哪里。订阅更新可能改动服务器名称与顺序，不宜只凭列表位置记住常用条目。导入失败时先检查地址是否完整、返回内容是否为客户端支持的格式，再检查网络连接；不要把订阅地址直接当作单个服务器配置导入。
订阅分组：工作环境
更新订阅 → 检查服务器列表 → 选择活动服务器
订阅来源与本地路由规则分别管理处理不读取系统代理的应用
TUN 模式通过虚拟网络接口接管符合条件的系统流量，适合需要覆盖不遵循系统代理设置的应用。它与普通系统代理的作用范围不同，也可能要求额外的系统权限。开启之前先确认常规代理连接正常，再阅读客户端当前平台的 TUN 设置和路由选项。启用后若局域网设备访问异常，应优先检查私有地址、DNS 与排除规则，而不是直接修改服务器协议。结束使用时在客户端关闭 TUN，并检查操作系统网络设置是否恢复到预期状态。
连接检查顺序：
普通系统代理 → DNS 设置 → TUN 虚拟接口
局域网访问异常 → 检查私有地址路由客户端界面与运行内核各司其职
v2rayN 提供订阅、服务器选择和代理模式等图形操作，具体协议处理由所选内核承担。Xray 与 V2Fly 属于相关但独立维护的内核家族；某项协议或传输设置能否使用，取决于内核能力和客户端提供的配置入口。切换内核前先记录当前可用的连接方式，确认目标内核支持现有服务器参数，再重启相关服务并做连接验证。若出现启动错误，查看客户端日志中报告的字段或进程问题，比仅观察系统代理图标更有判断价值。
客户端：v2rayN
内核选择：Xray / V2Fly
检查顺序：协议支持 → 配置字段 → 启动日志需要逐条检查规则、DNS 与订阅管理时，参阅进阶配置手册 →
PLATFORMS / 02
按操作系统选择安装包
桌面端使用 v2rayN；Android 可在 v2rayNG 与 v2flyNG 之间按内核需求选择。先核对系统和处理器架构，再进入对应平台的下载明细。
Windows
v2rayN 提供桌面版与经典 WPF 版。前者采用跨平台界面；已习惯 WPF 操作路径的用户可对照经典版入口。
前往下载 →macOS
v2rayN 按 Apple Silicon 与 Intel 芯片分别提供入口。在系统信息中查看芯片类型，再选对应安装包。
前往下载 →Android
优先查看采用 Xray 内核的 v2rayNG；需要 V2Fly 内核时查看 v2flyNG。两款均列出 arm64 与通用版。
前往下载 →Linux
v2rayN 按软件包格式提供 deb 与 rpm，并列出对应的 arm64 入口。先检查发行版包管理器和处理器架构。
前往下载 →
不确定该选哪个构建？下载页按平台列出安装包、架构与系统要求。查看全部客户端 →
FIRST CONNECTION / 03
从安装到首次连通
先让一个服务器在常规系统代理模式下工作，再调整路由、DNS 或 TUN。一次只改动一类设置，连接结果才容易解释。
- 01
安装并导入
按系统架构安装客户端。在订阅设置中添加服务提供方给出的地址，手动更新订阅，确认服务器条目已经出现在列表中。若收到的是单条配置链接，应使用客户端的链接导入功能，而非订阅分组入口。
- 02
选择服务器与模式
选中一个服务器作为活动配置，启动内核并开启系统代理。先用常规代理模式检查基础连接；需要按目的地址处理不同流量时，再打开路由设置核对规则顺序和出站标签。
- 03
验证并定位问题
用遵循系统代理的应用访问目标服务，随后查看客户端日志。若访问失败，依次核对订阅是否更新、服务器是否选中、本地端口是否正常监听，以及应用是否读取系统代理设置。
OPEN SOURCE / 04
Project V、内核与客户端
界面负责管理配置，内核负责处理连接。理解这层分工，有助于读懂错误日志，也能避免把客户端功能与协议支持范围混为一谈。
V2Fly 与 Xray
V2Fly 延续 V2Ray 项目的内核维护；Xray 是相关生态中的另一个独立内核家族。两者都可以承担连接处理，但具体支持的协议、传输选项及字段可能不同。服务器配置要求某项能力时，需要同时检查客户端的导入方式和当前所选内核。遇到配置解析失败，记录报错字段并查看对应内核的设置说明，不要只依据客户端名称判断兼容性。多内核选择的意义是匹配实际配置需求，而不是让同一份配置自动适配所有实现。
三款客户端的定位
v2rayN 面向 Windows、macOS 和 Linux 桌面环境，集中提供服务器管理、订阅更新、系统代理和路由操作。Android 端的 v2rayNG 使用 Xray 内核；v2flyNG 则提供 V2Fly 内核的备选路径。这三款客户端属于代码开源的项目，但界面布局、更新节奏和支持的功能并不完全相同。选择时先看操作系统，再看所需内核和配置功能；跨设备同步使用同一订阅，也仍需分别检查各设备的代理模式与本地规则。
协议与更新边界
项目采用公开的开源协议；具体许可条件应以各项目发布的信息为准，生态中可见 GPL-3.0 与 MIT 等协议。客户端、内核及规则数据的维护节奏可能彼此独立，因此更新一个组件并不必然改变另一个组件的行为。进行较大配置调整前，保留已能工作的设置，并记录所用客户端、内核与系统平台。遇到问题时，这些信息比笼统描述“无法连接”更适合定位原因。下载页集中列出各平台入口，配置细节则按主题放在进阶手册中。
要继续检查订阅过滤、DNS、FakeDNS 与自定义出站，阅读进阶手册 →
TECHNICAL NOTES / 05
近期技术笔记
围绕启动故障、端口冲突和初次使用整理具体排查路径。每篇文章对应一种可复现的设置情境。