01 / CLIENTS
桌面端选择 v2rayN，安卓端优先了解 v2rayNG。安装包架构、界面类型与内核支持分开确认。
客户端负责保存服务器资料、更新订阅和生成运行配置；内核负责协议握手、路由匹配与连接处理。下载安装到本地后，还需要导入由服务提供方给出的有效连接参数。软件本身不附带可用服务器，订阅地址也不是客户端安装包。第一次使用时，先保留默认监听设置，通过一个明确可用的配置验证连接，再逐项调整分流与 DNS，便于定位每次改动的影响。
下载页分别提供 Desktop 桌面版与经典 WPF 版入口。Desktop 使用跨平台界面，WPF 延续经典桌面交互；两者都需要结合实际内核与服务器参数使用，界面选择不代表协议能力完全相同。先确认系统架构，再选择适合的安装方式，不要仅凭文件体积判断用途。
安装并启动后，先导入订阅或单条分享链接，选择服务器，再启用系统代理。浏览器通常会读取系统代理设置，但命令行工具、游戏和部分后台程序可能使用自己的网络配置。如果浏览器能够连接而另一款应用不能，应先检查该应用是否遵循系统代理，而不是反复更换服务器。端口占用、内核运行状态和代理模式可在日志与设置中交叉确认。
先在“关于本机”中确认芯片：Apple Silicon 对应 arm64，Intel 对应 x64。下载页将两类安装包分开列出。客户端界面与系统网络设置属于不同层次；能打开主窗口，只能说明应用已启动，还应确认内核成功运行、本地监听端口建立，以及当前应用使用了对应代理入口。
导入已有配置时，重点检查传输方式、服务器名称与证书相关选项是否保留。不要为了绕过连接错误而随意关闭证书验证。使用系统代理之前可以记录原来的网络设置；切换网络、退出客户端或更换监听端口后，如果应用仍连接旧地址，需要同步检查系统代理状态。涉及虚拟网卡的功能还依赖当前客户端实现、系统权限与所选运行内核，不能仅凭相似的菜单名称套用其他系统的操作。
v2rayNG 使用 Xray 内核，v2flyNG 是使用 V2Fly 内核的备选客户端。多数较新的手机适合 arm64 包；不确定设备架构时，可查看下载页的通用包入口与选择说明。两款应用的内核路线不同，导入相同链接后仍需确认相关协议和传输选项得到支持，不应把其中一款的所有参数原样套到另一款。
首次建立连接时，系统会请求 VPN 连接权限，这是安卓端接管应用流量的入口。连接状态出现后，还要通过实际目标请求和运行日志确认结果。分应用规则、电池限制与后台活动权限都会改变使用表现；屏幕关闭后连接中断，应先检查系统是否限制后台运行。订阅更新失败与连接失败也应分开排查：前者关注地址、响应格式和更新路径，后者关注服务器参数、握手与路由，处理顺序并不相同。
按发行版的软件包体系选择 deb 或 rpm，再核对处理器架构是 x64 还是 arm64。下载页把常见桌面安装入口与 arm64 入口分别列出。安装包格式并不决定协议支持，实际可用字段取决于运行内核。安装后如果界面未正常打开，应先阅读系统给出的依赖或运行环境提示，再检查桌面会话与权限。
桌面环境的系统代理设置不会自动覆盖每个进程。终端程序可能读取环境变量，也可能需要单独指定 SOCKS 或 HTTP 代理；应用配置的协议必须与本地监听入口一致。排查时先确认内核日志没有启动错误，再检查监听地址与端口，最后测试目标请求。需要 TUN 时，先理解虚拟接口、路由表和 DNS 的配合，保留已有网络配置记录，避免同时修改多个网络管理入口后难以区分影响来源。
02 / CONFIGURATION
先区分入站与出站，再看规则如何选择路径。订阅与 TUN 属于客户端功能，不是同名的 V2Ray 顶层字段。
下方示例用于识别配置结构，不是可以直接替换所有设置的完整文件。客户端生成的运行配置可能随内核和界面选项变化；修改前先保存原配置，确认当前查看的是持久化设置还是临时生成文件。直接编辑临时文件后，下一次启动或切换服务器可能重新生成内容。需要长期保留的规则，应从客户端提供的设置入口或自定义配置入口维护。
入站决定在哪个地址、哪个端口接收连接，以及使用什么代理协议。示例只监听本机回环地址，应用应连接对应的 SOCKS 端口。修改端口后，要同步调整手动配置代理的程序；系统代理入口则由客户端按自身设置维护。监听地址改为全部接口会扩大可访问范围，不应把共享给局域网当作默认操作。与路由规则不同，入站先解决“连接如何进入内核”，并不直接决定最终走哪个服务器。
在 JSON 手册中查看 →{ "inbounds": [{ "tag": "socks-in", "listen": "127.0.0.1", "port": 10808, "protocol": "socks" }]}出站包含协议和对应设置，可以是代理服务器，也可以是直接连接。示例展示 V2Fly 与 Xray 常见的 freedom 直连出站；它只定义出口，不会自动补全远程服务器资料。每个用于路由引用的出站应有明确且不冲突的 tag，规则中的 outboundTag 必须能找到对应标记。导入节点后，客户端通常负责生成代理出站，因此手动增加直连项时要同时检查已有标记与默认出口，避免名称相同却指向不同配置。
在 JSON 手册中查看 →{ "outbounds": [{ "tag": "direct", "protocol": "freedom", "settings": {} }]}路由将连接目标与规则逐项比较，匹配后交给指定出站。示例把私有地址范围交给 direct，前提是出站列表中已有同名标记，并且运行环境提供所引用的地理数据。domainStrategy 控制路由匹配涉及的域名解析策略，不等于给所有应用强制指定 DNS。规则有先后顺序，宽泛规则放在前面可能遮住后面的精确规则。排查分流结果时，应一起核对目标域名、解析地址、规则位置与最终选中的出站。
在 JSON 手册中查看 →{ "routing": { "domainStrategy": "IPIfNonMatch", "rules": [{ "type": "field", "ip": ["geoip:private"], "outboundTag": "direct" }] }}DNS 配置描述内核使用的解析服务与静态映射，不代表系统中的每一次查询都会经过内核。浏览器自带的加密 DNS、系统缓存和应用独立解析都可能产生不同结果。示例使用 hosts 为教学域名指定文档示例地址，展示字段结构，不应作为实际服务地址使用。排查时先确认域名由哪一层解析，再观察解析结果能否匹配路由；仅替换解析服务而不检查请求路径，通常无法解释所有连接问题。
在 JSON 手册中查看 →{ "dns": { "hosts": { "example.com": "192.0.2.1" }, "servers": ["localhost"] }}订阅由客户端获取、解析并写入服务器列表，V2Ray JSON 中没有通用的 subscription 顶层配置。更新成功只说明资料已被接收，仍需选择服务器并启动内核。右侧展示日志级别片段，用于说明解析后的运行阶段应观察哪里，而不是订阅地址的填写位置。遇到更新失败，先区分网络请求失败与内容解析失败，再检查链接有效性、返回内容和更新时的代理路径；订阅地址含访问凭据时，不应贴到公开日志中。
在 JSON 手册中查看 →运行阶段的日志片段；订阅地址保存在客户端设置中。
{ "log": { "loglevel": "warning" }}TUN 借助虚拟网卡让部分不读取系统代理的程序进入代理处理链，实际覆盖范围仍受路由、权限与客户端实现影响。它不是给任意 V2Ray 配置增加一个 tun 字段。v2rayN 的相关功能应按当前界面与配套内核说明设置，右侧仅展示接管之后可用的路由片段。首次启用前先确认普通代理可用，再检查管理员权限、其他虚拟网卡和 DNS 路径；接管成功也不意味着所有目标都应走代理，局域网访问仍需合适的分流规则。
在 JSON 手册中查看 →V2Ray / Xray 路由片段，不是 TUN 网卡定义。
{ "routing": { "rules": [{ "type": "field", "ip": ["geoip:private"], "outboundTag": "direct" }] }}先读启动错误，再读连接错误。端口被占用、字段不支持与握手失败属于不同阶段；临时增加日志详细程度后，应在定位结束时恢复合适级别，并在分享前移除服务器地址和访问凭据。
把订阅更新、内核启动、系统代理和目标请求分别验证。保留能工作的基线配置，记录本次更改；当结果异常时，先回退这一步，比同时替换协议、DNS 与路由更容易得到可复现结论。
03 / PROJECT V · V2FLY · XRAY
开源指代码与许可的公开方式；协议支持、配置兼容性和连接结果，需要分别确认。
“V2Ray 客户端”常被用来统称这一类图形工具，但界面程序、连接内核与服务端并不是同一个组件。界面负责把选择转成配置，内核按配置处理连接，服务端还必须使用相容的参数。理解这条链路后，下载、配置和排错可以各自找到入口，不必把所有异常都归结为客户端本身。
Project V 是围绕网络代理功能形成的开源项目体系，V2Ray 是其中广为使用的核心实现。入站、出站、路由、DNS 等配置概念由此成为理解生态工具的共同语言。它们描述连接处理过程，不对应某一家服务商，也不等同于一份可直接使用的订阅。本站以这些结构组织手册，是为了让读者能够从界面中的选项找到配置层的含义。
学习时可以沿着连接方向阅读：应用先进入本地入站，内核取得目标信息，路由规则选择出站，出站再发起远程连接。DNS 可能参与目标解析与规则判断，日志则记录运行结果。这个顺序比逐个背诵所有字段更实用，也便于解释为什么“本地端口已开放”并不能证明远程握手已经成功。
V2Fly 社区延续 V2Ray 的开发，Xray 则从相关代码基础分支演进，形成独立的功能与发布路线。两者保留许多相近的配置概念，但新增协议能力、传输选项、默认行为与字段约束可能不同。涉及 REALITY、XTLS 等功能时，应查明所用内核的实际支持情况，不能仅凭文件名都叫 config.json 就判断配置可以互换。
客户端中显示的协议名称只是第一层信息，还要核对传输方式、TLS 参数、服务器名称和服务端要求。某个字段在另一条内核路线中存在，不代表当前内核会接受它。配置加载失败时优先查看日志指出的字段与层级；能够加载但不能连接时，再检查双方参数和网络路径，避免在语法错误与握手错误之间来回混淆。
阅读内核差异说明 →v2rayN 面向桌面系统，提供服务器列表、订阅分组、系统代理与配置管理入口。v2rayNG 面向安卓，使用 Xray 内核；v2flyNG 则提供基于 V2Fly 的安卓备选路线。它们都是开源客户端，但并不是同一个程序的不同皮肤。菜单位置、默认设置、可导入格式以及配套内核的管理方式，都需要按各自客户端理解。
图形客户端降低了填写原始 JSON 的门槛，但不会改变服务器要求的认证与传输条件。复制分享链接时，应保留完整内容；导入后仍要检查协议、地址、端口和传输参数。切换客户端之前可以先导出需要保留的资料，避免把界面选项的默认值误当作服务端给定值。桌面与安卓之间迁移时，也要重新确认系统代理和 VPN 接管方式的差别。
开源许可规定代码使用、修改与再分发的条件，不能用一个许可名称概括客户端、内核和全部依赖。V2Ray 核心采用 MIT 许可；Xray 核心采用 MPL 2.0 许可。图形客户端与随附组件也各有许可说明，需要重新分发或修改代码时，应逐项阅读对应条款，保留所要求的声明，而不是把“免费使用”理解为不附带任何条件。
公开源代码让实现细节能够被阅读与讨论，但不会替使用者确认订阅来源、服务端行为或本机设置。实际使用中，仍应保护订阅链接与认证资料，只导入可信来源的配置，并理解脚本、证书和网络权限的作用。本站的定位是整理下载入口与中文配置参考，不替代各组件的许可文本，也不把开源属性作为连接效果的保证。
软件更新改变客户端程序或配套内核；订阅更新改变服务器列表与分组资料。前者可能调整界面入口、默认选项或配置兼容性，后者可能替换地址与连接参数。排查更新后的异常时，先记录到底更新了哪一层，再比较更新前后的差异。单纯重新获取订阅，不会修复本地端口占用，也不能让缺少某项功能的内核自动获得支持。
更新前保存客户端设置与必要的自定义规则，更新后先用原本可用的单条配置验证。确认内核能启动、基本连接正常，再测试路由、DNS 和 TUN 等组合功能。客户端的发布节奏与内核发布节奏未必一致，是否需要更换内核应以配套关系和实际功能需求为依据，不应在不了解兼容性的情况下把组件全部替换。
查看导入与连接步骤 →先确认订阅是否能获取，再确认服务器资料是否被正确解析；接着看内核能否启动、本地监听是否建立，最后验证目标请求。若只有部分域名异常，检查解析结果与路由命中；若所有请求都失败，优先核对当前选中服务器和握手日志。延迟测试与实际应用请求也不完全等价，测试结果只能反映特定方法下的一次探测，不能代替完整连接验证。
记录问题时保留错误文本、操作顺序、代理模式和所用内核名称，移除订阅地址、认证值与可识别的服务器资料。术语不清楚时先查入站、出站、订阅与分流的定义，再对应到实际设置。这样提供的信息更容易复现，也能减少把“浏览器没有读取代理”误判为“协议不支持”的情况。JSON 示例合并前仍需检查括号、逗号、数组层级和出站引用。
查阅配置与连接术语 →04 / NOTES
从节点选择到流量接管，按具体问题展开阅读。
完成首次连接后，再处理更细的需求：节点选择关注测试方法和服务参数，内核选择关注功能支持，TUN 则关注应用流量如何进入处理链。下面三篇文章按发布时间倒序列出；阅读时先找与当前问题对应的层次，避免为了处理某个应用的代理设置而直接改动整个路由体系。
系统代理只能覆盖遵守代理设置的程序，TUN 模式通过虚拟网卡扩展流量接管范围。文章说明管理员权限、开启步骤与路由配合，并区分“进入内核”和“最终走代理”这两个结果，便于检查局域网与 DNS 相关问题。
阅读全文 →梳理 Project V 生态中两条内核路线的关系，比较 REALITY、XTLS 等功能支持。结合 v2rayN、v2rayNG 与 v2flyNG 的使用方式，说明为何配置外形相近仍需要核对字段、传输条件与服务端要求。
阅读全文 →延迟低并不等于所有请求都更快。文章区分真连接测速与 TCPing，解释流量倍率和地区选择的含义，并结合 VLESS、VMess、Trojan 的配置条件，说明如何在测试结果之外核对实际应用表现。
阅读全文 →