Windows
首推 v2rayN。下载页提供桌面版与经典 WPF 版：桌面版使用跨平台界面，WPF 版保留经典窗口布局。跟随教程时，先确认使用哪一种界面，菜单位置可能不同。安装后若无法启动，先核对系统要求与桌面运行库，再检查程序是否完整解压到可写目录。
适合需要订阅分组、服务器列表与路由设置的桌面使用场景。不要在压缩包预览窗口中直接运行程序。
前往下载 Windows 客户端 →订阅、路由与系统代理
客户端窗口负责管理配置，内核负责处理连接。订阅分组保存服务器来源；系统代理让遵循系统设置的应用连接本地端口；路由规则再决定这些连接走向哪里。这三项处在不同层次，不必同时修改。初次配置时先确认一条服务器记录能够使用，再逐项加入分流与其他入口。
按来源管理订阅分组
在“订阅分组”中添加订阅地址，并给分组取一个能够辨认来源的名称。更新后先选中该分组，再检查服务器列表，避免把其他来源的记录当作更新结果。分享链接适合导入单条记录，订阅地址适合持续同步，两者不能互相替代。订阅中包含的地址与参数属于连接配置，不要公开转发。下面是识别单条 VMess 分享链接时可能遇到的字段片段，不是完整连接配置。
{
"v": "2",
"ps": "示例别名",
"add": "example.com",
"port": "443",
"net": "ws",
"tls": "tls"
}按规则顺序选择出站
路由规则通常按从上到下的顺序匹配，命中后选择对应出站。可以先让私有地址直连，再添加域名集合规则，最后保留明确的默认去向。“绕过大陆”是预设名称，实际范围仍由加载的规则决定。下面片段将私有地址交给 direct；这个标签必须对应已存在的出站。导入自定义规则前先备份，并确认 geosite 与 geoip 数据可用，不能只看规则名称判断效果。
{
"routing": {
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}把应用连接交给本地端口
“自动配置系统代理”修改操作系统的代理设置，让遵循该设置的应用进入客户端；“清除系统代理”移除这项入口；“不改变系统代理”保留现有设置。它们不负责决定目标是否直连，出站仍由内核路由处理。若应用有独立代理选项，应核对其地址与实际监听端口。下面仅示意回环地址上的 HTTP 入站，端口可以调整，应以客户端当前设置为准，不要默认开放给局域网。
{
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http"
}
]
}为其他应用设置 TUN 入口
TUN 模式通过虚拟网络接口接收流量，适合需要覆盖不遵循系统代理设置的应用。先在普通代理入口验证连接，再启用“启用 Tun 模式”，并按系统提示授权。它涉及路由表、DNS 与虚拟接口，出现异常时应先关闭该模式，恢复基础连接后再排查。下面是 sing-box 格式的接口字段片段，仅用于辨认配置结构；是否使用这类配置取决于客户端实现，不应直接粘贴到 Xray 配置。
{
"type": "tun",
"tag": "tun-in",
"address": ["172.19.0.1/30"],
"auto_route": true,
"strict_route": true
}按协议参数选择内核
图形界面与代理内核是两部分。界面导入服务器信息，内核执行协议、传输与路由。切换前先核对协议类型、TLS 以及传输参数，不能认为同一份配置在所有内核中都有相同行为。下面的 freedom 出站是 Xray 与 V2Fly 生态中常见的直连配置形式。切换后先重载并查看日志，确认配置能够启动，再验证实际访问；不要同时改内核、DNS 和路由，否则难以定位失败原因。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}迁移连接信息，分别配置入口
桌面设备优先查看 v2rayN，安卓设备优先查看 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。跨设备迁移通常使用订阅地址或单条分享链接，不直接复制整个应用的数据目录。服务器参数可以共用，系统代理、虚拟接口与授权却需要各设备单独设置。下面的日志字段可在阅读内核配置时作为识别示例；实际日志位置由客户端决定。分享截图前，也要遮住订阅地址和服务器连接信息。
{
"log": {
"loglevel": "warning"
}
}订阅决定服务器来源，系统代理决定流量入口，路由规则决定连接出站。
分流示意中的 direct、block 与 proxy 是出站标签，不是固定的协议名称。标签可以由配置定义，规则中的写法需要与出站一致。例如，阻断出站可以使用 blackhole 协议，但标签仍可命名为 block。复制规则时应同时核对引用关系，避免出现“规则已保存，内核却无法启动”的情况。
DNS 设置也会影响匹配结果。域名规则与 IP 规则看到的信息不同，应用自行解析、客户端解析和远端解析不一定经过相同路径。若基础访问正常而个别站点走向不符，先查看日志中记录的目标与出站，再检查规则顺序和解析策略。不要直接把全部连接改为全局来代替定位问题；测试结束后还应恢复原来的预设。
四个平台的客户端选择
先确定操作系统，再确认处理器架构和安装格式。客户端名称相近，不代表安装包可以互换。下载页集中列出可选入口与系统要求；本页只负责平台导航，不在首页混放安装文件。已有客户端时，更新前先备份订阅分组与自定义规则，并记下当前使用的入口模式。
macOS
选择 v2rayN，并在系统“关于本机”中查看芯片信息。Apple Silicon 对应 ARM 架构，Intel 对应 x64 架构，不能只按文件名是否相似来选。安装后先打开客户端完成订阅导入，再设置系统代理。涉及虚拟网络接口时，应单独阅读授权提示，确认请求来自刚启动的应用。
迁移配置时优先使用订阅地址或分享链接；桌面系统之间的代理入口和应用数据目录并不相同。
前往下载 macOS 客户端 →Android
优先选择使用 Xray 内核的 v2rayNG；需要 V2Fly 内核时，可查看备选 v2flyNG。多数主流设备可选 arm64，无法确认架构时查看通用版入口。导入后选中一条服务器记录，再启动连接并处理系统的 VPN 授权提示。出现断连时，应同时检查后台运行限制与省电设置。
二维码适合迁移单条配置，订阅适合持续更新服务器列表；不要把订阅二维码公开上传到公共页面。
前往下载 Android 客户端 →Linux
选择 v2rayN，并按发行版的软件包体系区分 deb 与 rpm，再核对 x64 或 arm64。图形桌面的系统代理设置与命令行应用的代理配置是两条路径；浏览器能够访问，并不能说明所有程序都已使用代理。先测试图形客户端的基础连接，再决定是否为其他程序单独设置代理入口。
涉及 TUN 模式时，还需确认权限和系统网络管理方式。不要通过扩大监听范围来解决本机端口设置错误。
前往下载 Linux 客户端 →从订阅导入到访问验证
客户端提供连接工具，服务器配置需要自行准备。安装完成并不等于已有可用服务器；如果列表为空，应先取得有权使用的订阅地址或分享链接。下列顺序适合首次配置，也适合在改动较多后回到基础状态重新验证。
-
导入配置，确认来源
打开 v2rayN，在“订阅分组”中添加订阅地址，保存后执行订阅更新。只有单条分享链接时，可复制链接后在主窗口按 Ctrl+V 导入。两种方式的更新路径不同：订阅由来源同步，单条链接通常需要手动替换。导入完成后检查协议、地址、端口与传输信息，确认列表中出现了预期记录，再选中需要使用的服务器。
若更新后列表仍为空，先检查是否复制了完整地址，以及当前分组是否被筛选条件隐藏。不要连续添加同一订阅来尝试修复，也不要在公开截图中展示完整订阅地址。安卓客户端可使用其导入菜单完成同类操作，按钮位置以当前界面为准。
-
设置入口，再选择路由预设
在桌面客户端选择“自动配置系统代理”，让遵循系统设置的应用进入本地代理端口。随后查看路由预设：使用“绕过大陆”时，匹配到直连规则的目标可以直接访问；使用“全局”时，也应理解预设中可能保留的特殊规则。系统代理与全局路由并不是同一个开关，开启其中一个不会自动完成另一层设置。
首次测试先保留默认 DNS 与普通代理入口，暂不叠加 TUN 模式。若某个应用有自己的代理设置，要检查它是否覆盖系统设置。安卓端启动连接时按提示处理 VPN 授权，之后再观察客户端连接状态与实际访问结果。
-
打开目标页面，结合日志判断
使用遵循系统代理的浏览器访问需要测试的目标，检查页面能否完整加载，再查看客户端日志。TCPing 只说明某一段 TCP 连接的可达情况，不能替代包含协议握手、TLS 和目标访问的实际验证。数值正常但页面打不开时，应继续核对服务器参数、系统时间、DNS 解析与所选出站，而不是仅按测试结果反复换序。
每次只改一个变量，重载后重新访问同一目标，便于比较。测试结束准备退出桌面客户端时，先清除系统代理，再关闭程序，避免应用继续连接已经停止监听的本地端口。需要进一步排查时，记录报错文本与操作顺序，比单独描述“无法连接”更有帮助。
Project V、V2Fly 与 Xray 的关系
“V2Ray”常被用来泛指一组代理工具，但项目背景、内核和图形客户端需要分开理解。Project V 是相关网络工具与技术的项目背景，V2Ray 是其中广为使用的核心组件。V2Fly 社区延续 V2Ray 相关开发；Xray 从这一生态中分支发展，形成自己的功能演进与配置支持范围。相近的术语并不代表所有字段都能直接互换。
内核处理连接，客户端组织操作
代理内核负责协议握手、传输、DNS 和路由等工作，图形客户端负责把这些能力组织成菜单、服务器列表与设置页面。v2rayN 提供桌面配置界面，并可在支持范围内选择相应内核；v2rayNG 面向安卓设备，使用 Xray 内核；v2flyNG 是使用 V2Fly 内核的安卓备选。选型先看设备与服务器要求，不必把客户端名称直接当作协议名称。
例如，VMess、VLESS 与 Trojan 属于连接协议层面的名称，WebSocket 属于传输方式，TLS 属于连接安全相关设置，而 REALITY 的可用性还取决于对应内核及配置。分享链接把这些参数放在一起，界面则将它们拆成不同输入项。排查时要逐项对照服务端提供的信息，不能只因协议名称一致就认为配置完整。
开源许可与配置责任分开看
三款图形客户端都属于开源软件，客户端、内核与规则数据可能采用不同的开源许可。阅读源码、修改和分发时，应分别遵守对应组件附带的许可文本；例如，V2Fly 的 V2Ray 核心与 Xray 核心采用 MPL 2.0，不能据此推断所有图形客户端也采用相同许可。客户端是免费使用的连接工具，服务器资源和订阅服务则是独立事项。
开源描述的是代码与许可关系，不替代对具体配置来源的判断。订阅地址可能携带访问标识，分享链接也可能包含连接凭据。备份时应妥善保存，发送日志或截图前先移除这些信息。订阅转换还会增加一个处理配置的环节，若只是把配置迁移到另一台设备，应先尝试客户端原有的订阅或分享导入方式。
更新时分别核对界面、内核与规则
客户端更新可能调整界面、配置生成方式或附带组件；内核更新可能改变协议行为与字段支持；规则数据更新则会影响域名和地址集合的匹配范围。因此，“已经更新客户端”不一定表示所有配置数据都随之更新。操作前先备份，阅读对应更新说明，更新后先检查能否启动，再测试原本可用的目标，最后验证自定义分流。
若同一配置更新后出现异常，可以先恢复备份，确认问题是否与本次改动有关。不要在尚未定位原因时反复覆盖整个数据目录，也不要把其他设备的完整目录直接搬来替换。需要跨设备使用时，优先迁移服务器连接信息，在新设备上重新设置系统代理、权限与 TUN 入口，这样更容易保留清晰的配置边界。
了解本站内容范围 →配置迁移、代理模式与启动排查
完成基础连接后，再根据具体问题补充设置。需要电脑与手机共用配置时，先比较订阅、分享链接和备份的边界；不确定流量为何直连时，先区分系统代理与路由；客户端打不开时，则应从运行环境开始查起。每篇文章只处理一个场景，便于按步骤复现和回退。
电脑与手机共用一套 V2Ray 配置：订阅链接、分享二维码与备份导出方案
比较订阅地址共用、单节点分享链接与二维码、配置备份导入三种思路，说明在 v2rayN 与 v2rayNG 之间迁移时各自的取舍。
阅读配置迁移说明 →系统代理与路由模式怎么选：全局代理和绕过大陆规则的实际差别
讲清系统代理开关与路由预设是两层独立设置，对比全局与绕过大陆两种规则的流量走向、适用场景和常见误配。
阅读入口与路由说明 →v2rayN 打开就闪退怎么办：.NET 运行库缺失与权限问题排查
从桌面运行库版本、解压路径权限、安全软件拦截到配置文件损坏，按出现频率排列闪退原因，每项给出可直接执行的处理步骤。
阅读启动排查步骤 →