CONFIGURATION / FIELD INDEX
先分清应用入口、内核配置与远端服务，再定位需要修改的字段。
客户端窗口负责保存服务器资料、组织订阅分组和生成运行配置；内核负责接收入站连接、判断路由与建立出站连接。两者不是同一层设置。修改系统代理不等于修改路由，更新订阅也不等于更新内核。排查问题时先判断发生在哪一层，再查看对应的设置页或日志，可以减少反复重装与同时改动多个选项带来的干扰。
REFERENCE CATALOGUE
JSON 是理解配置结构的共同入口，不代表同一文件能够跨内核直接通用。客户端、内核和协议各有适用边界，字段名称相同也应核对取值与版本文档。
首次使用可以先通过图形界面完成订阅与系统代理设置；需要调整域名分流、本地监听或解析行为时，再对照字段手册阅读生成的配置。不要把完整运行配置作为普通订阅链接导入，也不要将客户端备份文件当作内核配置文件。
查阅 JSON 手册 →路由处理的是已经进入内核的流量。先为出站设置明确的标签，再让规则通过域名、地址或端口匹配到对应出口；多个规则重叠时，应把范围较小的例外放在较前位置。系统代理只影响遵循该设置的应用，不会替代路由规则。遇到网站走错出口，先查看命中的规则，再检查默认出站与域名解析策略。与逐项切换服务器相比，按规则分流可以保留固定的流量走向，但仍需维护规则数据。
订阅导入用于从链接读取服务器资料，适合需要定期同步的配置集合。先新建分组并保存订阅地址，再执行更新，确认服务器列表出现实际条目后选择活动服务器。更新失败时，应区分链接过期、返回内容格式不符和请求连接失败，而不是反复导入同一个地址。订阅通常只更新其负责的服务器资料，并不统一管理所有本地设置；监听端口、系统代理和自定义路由仍需单独检查。订阅地址含访问权限，不应公开分享。
客户端界面显示协议类型，不代表当前运行内核支持该条目的全部选项。需要同时核对协议、传输方式、安全层与内核能力，尤其是带有特定安全机制的配置。v2rayNG 以 Xray 内核为主，v2flyNG 使用 V2Fly 内核；桌面客户端的实际行为则取决于选中的内核与配置。相较于只看服务器名称，核对这些结构字段更适合定位导入成功却不能连接的情况。切换内核前保留原配置，避免将兼容性问题误判为网络问题。
入站定义本地监听地址、端口以及接收连接的协议。仅供本机使用时，应优先保留回环监听地址；需要局域网访问时，再结合防火墙和访问控制调整。流量识别可以为部分连接补充目标域名信息，帮助路由匹配，但不能替代完整的域名解析设置。与系统代理相比，入站属于内核接收层；端口被占用时，即使客户端窗口能打开，入口也可能没有建立。修改监听端口后，需要同步更新手动填写该端口的应用。
DNS 配置决定内核如何查询域名，而应用或系统可能仍使用各自的解析路径。排查解析失败时，先判断请求由谁发起，再检查解析服务器是否可达、查询策略是否适合当前网络。路由中的域名策略影响匹配阶段是否尝试解析，出站的目标解析又可能有独立设置，不能只修改一个服务器地址便认定全部流量已改变。相比直接使用地址连接，保留域名有助于域名规则工作；是否采用应由实际配置与内核行为决定。
传输方式、安全层和服务器身份验证是不同配置维度。使用 TLS 时，需要确认服务器名称、证书链与系统时间；使用 REALITY 时，应按服务端资料填写相应参数，不能把 TLS 示例整段照搬。遇到证书报错，先记录具体错误并核对名称与时间，不将跳过验证作为常规解决方法。与只改协议名称相比，逐项核对传输字段更能识别配置不一致；排查完成后还应复查日志，确认实际使用的是预期配置。
CLIENTS / PLATFORM DIRECTORY
先确认操作系统与处理器架构，再选择客户端和安装包格式。
桌面平台使用 v2rayN，安卓平台按内核需求选择 v2rayNG 或 v2flyNG。下载中心集中展示安装包入口及选择说明，本页不列具体版本。首次安装之前，建议先查看系统信息中的架构名称；软件包格式、处理器类型与图形界面类型是不同维度，文件能够下载并不意味着适用于当前设备。
v2rayN 提供桌面版与经典 WPF 版两个界面入口。桌面版采用跨平台界面，WPF 版沿用经典桌面操作方式；选择时先考虑熟悉的界面与当前系统环境，不要把两种界面理解为两个不同协议。安装完成后，通过图形界面导入订阅、选择活动服务器，再检查本地监听和系统代理。
已有配置的设备应先在客户端中备份资料，再决定是否迁移界面。首次运行遇到依赖提示时，按提示确认运行环境；出现端口占用则查看日志与监听设置，不必直接重装。退出客户端前清除系统代理，有助于避免应用继续指向已经停止的本地入口。安装步骤见首次使用教程。
前往下载v2rayN 的安装包区分 Apple Silicon 与 Intel。先在“关于本机”中查看芯片或处理器信息，再进入对应下载入口；不要仅凭设备外观或购买年份判断。安装后确认应用位于预期目录，并根据系统实际提示处理首次打开的安全检查，不应把所有启动失败都归因于网络连接。
完成订阅导入后，先检查活动服务器是否选中，再设置需要的代理方式。系统代理只对遵循系统设置的应用生效，部分程序需要在自身设置中填写代理。休眠唤醒、切换网络或关闭客户端后出现连接异常，可以先查看代理开关与本地入口是否一致，再检查远端连接日志，避免同时修改多个层级。
前往下载v2rayNG 使用 Xray 内核，是下载中心的安卓首推客户端；v2flyNG 使用 V2Fly 内核，作为对应生态的备选。主流较新设备通常选择 arm64，无法确认设备架构时可查看通用包入口与系统信息。两款客户端的内核不同，导入相同资料后仍应检查协议与传输选项是否受支持。
首次建立连接需要确认系统 VPN 授权。若设备已有其他 VPN 类应用运行，应先判断是否存在服务冲突。订阅成功更新只表示资料已获取，不代表已选中活动服务器或建立连接；连接后仍需根据日志和实际访问检查状态。后台中断时可查看系统电池管理设置，不把延迟测试结果作为持续连接的唯一依据。
前往下载v2rayN 提供 deb 与 rpm 软件包入口，另按处理器区分 x64 和 arm64。选择时同时核对发行版的软件包体系与设备架构，不能只看其中一项。桌面图形客户端还依赖可用的图形环境；安装包管理器提示依赖缺失时，应先根据当前发行版的说明补齐环境，再尝试启动应用。
不同桌面环境处理系统代理的方式可能不同，浏览器与其他应用也可能有独立代理设置。完成导入后，可以先在目标应用中核对本地入口地址与端口，再逐层检查系统设置。监听默认保留在本机范围，确需局域网访问时再配置防火墙与权限。安装成功、内核启动和应用流量进入代理，应分别确认。
前往下载PROJECT V / CORE FAMILY
开源项目、运行内核与图形客户端，分别回答配置从何而来、连接如何处理、用户在哪里操作。
Project V 是围绕代理与网络工具形成的开源项目生态，V2Ray 是其中广为使用的名称。配置结构将入口、出口、路由、解析与策略分开描述：入站接收本地应用连接，出站定义连接目标的方式，路由在它们之间选择路径。理解这套分层，比记住某个按钮所在的位置更便于跨客户端阅读设置，也能帮助判断问题发生在本地接收阶段还是远端连接阶段。
图形客户端通常根据界面设置生成内核运行配置，因此不宜在不了解保存机制时直接编辑生成文件。再次启动、切换服务器或更新设置后，这类修改可能被覆盖。需要长期保留的自定义规则，应优先使用客户端提供的规则管理或自定义配置入口，并记录配置由哪一层管理。阅读手册时也要区分演示片段与完整文件，单独一个字段不能承担全部连接流程。
V2Fly 社区延续 V2Ray 核心项目的开发与维护，Xray 是从相关代码基础发展出的另一条内核路线。两者在配置结构上有共同背景，但协议能力、字段细节和新增功能并非始终一致。REALITY 等特定能力需要按实际内核支持情况判断，不能因为客户端能够显示某个名称，就默认全部参数在另一个内核中仍然有效。
排查兼容性时，应同时保留客户端名称、运行内核、协议、安全层与传输方式这些信息。仅说“使用 V2Ray”不足以复现问题。若导入后没有条目，先检查内容格式；若内核无法启动，查看字段与依赖；若启动成功却连接失败，再核对服务端参数与网络条件。按阶段检查可以让日志与操作对应起来，也避免把所有错误归入同一个原因。
v2rayN、v2rayNG 与 v2flyNG 均属于开源图形客户端。开源意味着代码按各自项目的许可证提供，使用、修改和再分发应遵循对应条款。客户端代码、内核代码以及随包组件可能适用不同许可证，不能用一个项目的许可概括全部组件。开源属性也不代表任意配置都符合使用场景，网络访问权限与服务使用规则仍需分别确认。
三款客户端的侧重点是把配置与连接操作放入图形界面，并非提供远端服务器本身。安装软件后仍需要合法可用的服务器资料或订阅内容。订阅来源负责其服务地址、有效期与访问权限，客户端负责读取和使用这些资料。本站整理下载与技术说明，不提供连接凭据；分享配置截图或日志前，应先移除订阅地址、用户标识和其他访问资料。
客户端更新主要涉及界面、配置生成逻辑与集成能力，内核更新涉及连接处理和协议实现，订阅更新则同步服务器条目。三者不是一次操作的不同名称，也不应互相替代。订阅失效时升级客户端未必有帮助；内核缺少字段支持时，反复刷新订阅也不能补齐能力。更新之前先明确需要解决的问题，再选择相应入口。
调整环境前保留可恢复的配置备份，并记录原先的活动服务器、路由模式与监听设置。更新后先观察能否正常启动，再测试订阅读取和实际访问。自定义 JSON 尤其需要留意字段迁移与默认行为变化；遇到错误时回到具体日志，而不是一次性关闭全部验证或删除全部规则。下载中心负责安装包选择，操作步骤与字段含义分别收录于教程和JSON 手册。
阅读顺序：首次安装先看教程，遇到陌生名称查术语表，需要修改配置时再按字段查手册。连接问题涉及多个层级时，保留最小复现步骤，比连续切换设置更便于定位。
TECHNICAL NOTES / RECENT ENTRIES
从代理模式、服务器选择与本地端口三个入口，区分设置问题与连接问题。
技术笔记按具体操作场景组织，不要求先通读全部配置字段。阅读时先核对报错发生的阶段，再选择相应文章：应用没有进入代理时看代理模式，部分服务器表现不同时看选择方法，内核提示无法监听时看端口排查。单次测试反映的是当时条件，修改设置后应以相同方式重新测试，并记录前后差异。
用系统自带命令查出占用本地监听端口的进程，说明在参数设置里修改 socks 与 http 端口后，系统代理和浏览器需要同步调整的地方。
阅读技术笔记 →讲清真连接延迟与 TCP 延迟测试的差别，结合倍率计费、地区距离和 VLESS、VMess、Trojan 等协议特性，整理挑选节点的判断顺序。
阅读技术笔记 →解释系统代理开关与路由模式是两层设置，对比全局、绕过大陆和直连三种路由的流量走向，按使用场景说明组合方式。
阅读技术笔记 →