客户端入口
桌面使用 v2rayN，安卓优先查看 v2rayNG。先确认系统与处理器架构，再进入对应下载分组。
客户端负责保存订阅、组织服务器配置并启动内核；安装包本身不提供远端连接服务。已有订阅链接或单条配置后，再按照使用指南完成导入。更换设备时可以继续使用兼容的连接参数，但本地端口、系统代理和应用权限需要在新设备上重新确认。
下载分组提供桌面版与经典 WPF 版。桌面版采用跨平台界面，适合希望在不同桌面系统之间保持相近操作习惯的用户；WPF 版保留经典桌面界面，已有使用习惯时可按需选择。两种界面的设置位置可能不同，教程中的字段含义仍可对照阅读。
安装前在系统设置的“系统 → 系统信息”中确认系统类型。首次启动后，先检查参数设置中的本地监听端口，再配置系统代理。不要让两个客户端同时接管同一套系统代理，也不要让它们监听相同端口；否则即使订阅导入成功，应用请求也可能送到另一份配置。
前往下载 Windows 客户端根据“关于本机”中的芯片信息选择 Apple Silicon 或 Intel 安装包。芯片类型决定程序架构，与订阅里使用 VMess、VLESS 还是 Trojan 没有关系。完成安装后，先打开客户端确认配置目录和运行状态，再导入现有连接配置。
桌面应用是否经过代理，还取决于它是否遵循系统代理设置。浏览器可以正常访问，不代表终端程序也会采用相同路径。排查时应先用一个遵循系统代理的应用验证，再检查其他应用自己的代理选项。若系统提示安装权限问题，阅读系统给出的具体原因，不要通过关闭整体安全设置来替代判断。
前往下载 macOS 客户端v2rayNG 使用 Xray 内核；需要 V2Fly 内核环境时，可查看备选的 v2flyNG。多数较新的手机使用 arm64 架构，无法确认时再查看通用版说明。两款客户端的协议支持范围以各自内核为准，不能只凭名称相近就认定所有配置都能直接互换。
首次建立连接时，系统会要求确认 VPN 连接权限。这是客户端接收设备网络请求的入口，与远端服务器是否可用是两件事。连接经常在锁屏后中断时，检查系统的电池优化与后台运行限制；同时确认没有其他应用占用 VPN 连接。订阅内容、连接权限、后台策略应分别核对，避免反复重装却没有改变真正的故障条件。
前往下载 Android 客户端按发行版的包管理体系选择 deb 或 rpm，再区分 x64 与 arm64。发行版名称和处理器架构是两个独立条件：同样使用 deb 的设备，也可能需要不同架构的包。下载页集中提供这些入口，安装前先核对系统信息，避免把架构不匹配误判为程序无法运行。
图形桌面的系统代理设置通常只影响遵循该设置的应用，不会自动替每个程序配置环境变量。初次使用先保留回环地址监听，在桌面浏览器里验证连接；需要给其他程序单独设置代理时，再填写实际的协议和端口。服务启动失败应先读日志中的端口占用、权限或配置错误，不要直接扩大监听范围。
前往下载 Linux 客户端配置分段阅读器
入站接收请求，路由选择路径，出站执行连接。先看三者如何通过 tag 串联，再调整 DNS 与策略。
以下为局部配置示例，不是可直接连接远端服务的完整文件。示例采用常见的 V2Ray 配置结构；涉及具体协议或扩展字段时，应继续核对实际运行的内核。窗口里的 final 表示默认处理意图，并不是这里新增的 JSON 顶层字段。
入站定义内核在哪个地址、哪个端口接收请求，以及使用什么代理协议。本机应用通常连接回环地址，避免将代理端口暴露到局域网。示例中的 SOCKS 和 HTTP 分别监听两个端口，应用侧必须填写相匹配的协议。端口不是固定标准，客户端设置中的实际值才是依据。与系统代理不同，入站本身不会通知浏览器使用代理；两端都配置正确，请求才能进入内核。
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": true }
},
{
"tag": "http-in",
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"settings": {}
}
]
}出站负责把已接收的请求送往目标。直连使用 freedom，阻断使用 blackhole，代理出站则需要对应协议的远端参数。tag 是配置内部的引用名称，不是协议名称；routing 中的 outboundTag 必须与它完全一致。示例只展示直连和阻断，并不包含远端代理。常见配置未命中路由时使用第一个出站，因此调整数组顺序也可能改变默认路径，不能只看规则列表。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {}
}
]
}路由规则按从上到下的顺序判断，命中后选择对应出站。应把更具体的域名或地址规则放在宽泛规则之前，避免前面的条件提前接走请求。示例将私有地址交给 direct，前提是该出站已存在。IPIfNonMatch 表示域名规则未匹配时尝试解析地址再判断，并不等于所有应用都统一使用内置 DNS。geoip 与 geosite 引用的数据集合也需要可用，规则文本本身不包含这些数据。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}dns 模块设置内核内置解析器使用的服务器。它何时参与解析，还取决于路由策略、出站设置和应用提交的是域名还是地址。示例展示 hosts 静态映射与 DNS 服务器的基本结构，不代表加入这些字段就完成了所有解析流量的接管。浏览器的加密 DNS、系统解析器和内核解析器可能同时存在。排查解析路径时，应分别确认请求从哪里发起、经哪个出站发送，再判断是否符合预期。
{
"dns": {
"hosts": {
"domain:example.com": "192.0.2.1"
},
"servers": [
"https://1.1.1.1/dns-query"
],
"queryStrategy": "UseIPv4"
}
}policy 用于描述用户等级对应的连接策略，例如握手等待时间与空闲连接超时。levels 中的数字键表示等级，不是服务器编号；相关用户配置需使用对应 level 才能关联到策略。示例时间单位为秒，数值只是结构演示，不是适合所有网络的优化结论。超时设置过短可能中断较慢的握手或长连接。遇到断流时，应先确认日志与网络状态，再一次修改一个参数并比较结果。
{
"policy": {
"levels": {
"0": {
"handshake": 4,
"connIdle": 300,
"uplinkOnly": 2,
"downlinkOnly": 5
}
}
}
}订阅由客户端管理，不是 V2Ray 内核 JSON 的顶层键。客户端读取订阅内容，将连接参数转换成可运行的配置；更新订阅也不等于升级内核。订阅地址可能带有访问凭据，应避免在截图和公开日志里展示。下面仍是有效的内核配置片段，用来说明最终配置中的出站位置，而不是订阅格式。它只有直连出站，不能替代订阅导入；实际代理参数应从已有的有效连接配置生成。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}快速上手预览
先建立一条可验证的请求路径，再增加分流规则。每一步保留明确的检查点。
在 v2rayN 的订阅分组中添加已有订阅地址，为分组填写便于识别的备注，再执行更新订阅。使用单条分享链接时，走客户端的剪贴板导入入口，不要把单条链接当成订阅地址反复更新。v2rayNG 的操作入口位于订阅分组设置与主界面菜单，基本顺序相同：保存来源、获取内容、检查导入结果。
导入后先确认列表确实出现了可选配置，并核对协议类型是否符合预期。订阅返回空列表、格式错误或访问失败时，应先解决内容获取问题，而不是立即调整本地路由。订阅可能包含访问凭据，排查截图中应隐藏完整地址、用户标识和认证字段；分享问题时保留错误类型与操作步骤即可。
选中一条配置作为当前连接。列表存在配置不代表已启用，更新成功也不代表远端可达。先把“内容已导入”和“当前配置已选中”分开确认，后续的连接测试才有明确对象。
桌面端检查参数设置中的监听地址与端口，再选择“自动配置系统代理”。这一操作让遵循系统代理的应用把请求送到本地客户端；路由模式则决定请求进入内核后使用哪个出站。两者属于不同层次，不能用“全局”两个字混为一谈。修改路由不会自动让一个忽略系统代理的应用开始使用代理。
日常分流可从客户端预设模式开始，确认基础连接后再加入自定义规则。使用浏览器代理扩展时，扩展中的协议与端口要和客户端保持一致，避免扩展与系统设置互相覆盖。安卓端则先确认系统连接权限，再查看应用分流范围，确保待测试应用包含在预期范围内。
如果电脑上保留了另一款代理程序，先退出它或明确分配不同端口。端口被占用时，界面仍可能显示已有配置，但内核无法正常监听；这类问题应通过启动日志定位，而不是继续更换订阅。
启动连接后，先用浏览器访问一个已知可用的页面，观察是否能完成解析与加载，再查看客户端日志中的连接错误。一次延迟测试只能反映特定测试目标和测试方式，不能替代实际应用验证。页面打不开时，按“应用代理设置 → 本地监听 → 路由命中 → 远端连接 → DNS 解析”的顺序检查，避免同时改动多处设置。
只有部分站点异常时，对照它们使用的域名规则与地址规则；全部应用异常时，优先检查内核启动与系统代理。涉及认证或握手失败，再核对设备时间和连接参数。日志可能包含目标域名与配置标识，公开提问前应删去与故障无关的敏感信息。
完成验证后记录当前可用的模式与端口，后续每次只调整一类设置。退出桌面客户端前，可按实际需要清除系统代理，避免应用继续向已关闭的本地端口发送请求。完整教程会把每个检查点展开为操作路径。
Project V · V2Fly · Xray
Project V 是围绕网络代理工具形成的开源生态，V2Ray 是其中的重要组成。V2Fly 社区延续了 V2Ray 的维护与演进；Xray 从相关技术基础发展而来，也形成了自己的协议实现与功能扩展。它们有共同的配置概念，但不是同一个可执行程序，不能把内核名称当成可以任意替换的标签。
阅读配置时，先确认当前运行的是哪一种内核，再核对该内核支持的字段和协议组合。例如，VLESS 属于代理协议，REALITY 属于连接安全相关配置，二者不是同一层次的替代选项。分享链接能被客户端识别，也不必然意味着所选内核支持其中的每个参数；应继续检查生成配置与启动结果。
v2rayN、v2rayNG 与 v2flyNG 均以开源方式提供代码。v2rayN 面向桌面系统，将订阅、服务器选择、路由与系统代理集中在图形界面中；v2rayNG 面向安卓并采用 Xray 内核；v2flyNG 提供以 V2Fly 内核为基础的安卓选择。开源属性描述的是代码与许可方式，不等于每款客户端拥有完全相同的功能。
图形客户端解决的是操作与配置组织问题，内核负责协议处理和连接转发。遇到界面操作问题，应先查客户端设置；遇到未知字段或协议不支持，应核对内核能力。把这两层分开，可以减少将订阅格式、界面选项和内核语法混用的情况，也便于理解为什么同一份连接信息在不同客户端中呈现不同。
V2Fly 的 V2Ray 核心与 Xray 核心采用 MPL 2.0 许可。客户端项目有各自的开源许可，分发、修改或组合使用时，应分别阅读相关许可文本，不能用内核许可代替客户端许可。对普通使用者而言，更直接的判断依据是功能说明、发布记录以及实际设备上的兼容情况。
社区维护会涉及系统适配、协议兼容和问题修复，并不意味着每一次更新都要求更改现有配置。阅读变更说明时，应关注是否调整默认值、移除旧字段或改变导入行为。已有稳定配置时，先保留可恢复的副本，再测试需要的新功能；不要把批量替换字段当成通用升级步骤。
更新客户端改变图形界面和配置管理功能；更新内核改变协议处理能力；更新订阅获取远端提供的新连接信息。这三项可能通过不同入口完成，也可能有不同的更新节奏。订阅更新成功不会自动修复本机端口冲突，客户端升级也不会让过期的远端认证参数重新有效。
本手册按设置项和 JSON 键名组织内容，而不是依赖某一张界面截图。界面变化后，仍可从监听地址、出站 tag、路由条件与解析服务器这些概念定位设置。需要安装包时进入下载页；需要理解参数关联时进入 JSON 手册；已经能启动却无法访问时，则按教程的分层检查顺序缩小范围。
使用记录与排查
从列表里的字段到应用里的请求路径，按问题拆解配置，不把所有故障归到同一个设置。
解释节点列表里延迟、流量倍率、地区标识与协议类型的含义，按日常浏览、视频和游戏等场景给出取舍思路。先看测试口径，再看实际应用表现，避免只按一个数字排序。
阅读节点选择说明 →汇总订阅链接过期、更新走代理、证书与格式错误等失败原因，并演示两款客户端的定时自动更新设置。区分地址无法访问与内容无法解析，按错误阶段寻找对应设置。
阅读订阅更新说明 →按顺序核对系统代理模式、本地端口占用、时间同步、路由规则与节点可用性，把连上却无法上网的问题逐层排除。保留可复现的测试条件，比同时修改多个选项更容易定位原因。
阅读连接排查清单 →