Windows
v2rayN · Desktop / WPFv2rayN 提供 Desktop 与经典 WPF 两种界面。Desktop 使用跨平台界面方案,WPF 保留熟悉的桌面操作方式;两者都需要继续完成订阅导入和代理设置。首次安装按下载页说明确认系统与运行环境,不要把一种界面的设置路径机械套用到另一种界面。
解压包应放在可写的独立目录,避免直接在压缩软件窗口内运行。迁移已有配置前先退出旧实例,保留原配置备份,再检查本地监听端口是否冲突。出现启动错误时,先看运行环境提示,再处理代理设置。
设置目录 / CLIENT SETTINGS
图形客户端负责整理配置,内核负责实际连接。先导入服务器信息,再确定哪些应用经过代理,最后核对路由和域名解析;不要一次更改所有选项。
订阅用于集中获取服务器配置,单条分享链接只导入一条记录。v2rayN 可在「订阅分组设置」中添加地址,保存后执行订阅更新;v2rayNG 可从菜单进入同名设置。剪贴板导入适合已复制的分享链接,不能把网页标题当作配置。导入后先核对分组、协议和地址,再选为活动服务器。订阅更新失败时保留原有记录,先检查链接是否完整,不要反复删除分组;订阅地址可能包含访问凭据,截图时应遮盖。
v2rayN
订阅分组 → 订阅分组设置 → 添加
保存分组 → 更新订阅
v2rayNG
菜单 → 从剪贴板导入
查看订阅导入步骤 →
先导入,再连接
路由决定已进入内核的连接使用哪个出站,不负责让应用自动接入代理。初次配置可先使用「绕过局域网」,让本地设备地址保持直连,再按需要添加域名规则。规则通常按顺序匹配,宽泛条件放在前面可能遮住后面的精确条件。编辑自定义规则时,出站标签必须与当前配置一致,不能只复制字段名。与系统代理开关相比,路由的作用范围在内核内部;应用未经过内核时,修改规则不会改变它的连接路径。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
理解规则与出站标签 →
先确认流量入口
v2rayN 的「自动配置系统代理」会把系统代理地址指向客户端的本地监听端口,遵循该设置的浏览器等应用才会进入内核。「清除系统代理」用于撤销系统代理设置,并不删除服务器配置。路由中的全局代理则决定进入内核后的出站,两者不能互相替代。部分应用需要单独配置代理,TUN 也属于另一种流量接入方式。首次使用先验证系统代理路径,避免同时启用多个接管方式;退出后若网络异常,再检查系统代理是否残留。
系统代理 → 自动配置系统代理
路由 → 绕过局域网
停止使用时:
系统代理 → 清除系统代理
查看模式选择与连接验证 →
入口 ≠ 分流
内核承担协议握手、传输和路由执行,客户端界面只是配置入口。v2rayNG 主要使用 Xray,v2flyNG 面向 V2Fly 内核生态;v2rayN 的可选内核与当前发行包、协议类型有关。切换前需要同时检查协议、传输方式、安全层和扩展字段,不能仅凭名称相近判断兼容。例如 REALITY 是安全层相关技术,不应当作与 VMess 完全同类的独立协议。更换内核后应重新生成配置并查看日志,已有的自定义 JSON 也需要单独核对。
核对顺序
协议类型 → 传输方式 → 安全层
↓
当前内核支持情况
查看协议与内核技术参考 →
按字段判断兼容
DNS 将域名转换为地址,解析使用的服务器与最终连接的出站并不是同一个概念。浏览器安全 DNS、系统解析器和内核内置 DNS 可能同时存在;只修改客户端中的一项,不代表所有应用都采用相同解析路径。出现域名访问失败时,先记录报错并确认应用是否进入代理,再检查 DNS 服务器是否可达、路由是否需要解析以及 IPv6 是否可用。下面片段只说明内置 DNS 的服务器字段,不能单独构成可连接的配置,也不替代完整路由设置。
{
"dns": {
"servers": ["localhost"]
}
}
查看 DNS 设置与排查顺序 →
解析成功不等于连接成功
平台选择 / DOWNLOAD ENTRY
先确认操作系统,再确认处理器架构。下面的入口会打开下载页对应平台;桌面端与安卓端使用不同客户端,不要按名称相似程度选择安装包。
v2rayN 提供 Desktop 与经典 WPF 两种界面。Desktop 使用跨平台界面方案,WPF 保留熟悉的桌面操作方式;两者都需要继续完成订阅导入和代理设置。首次安装按下载页说明确认系统与运行环境,不要把一种界面的设置路径机械套用到另一种界面。
解压包应放在可写的独立目录,避免直接在压缩软件窗口内运行。迁移已有配置前先退出旧实例,保留原配置备份,再检查本地监听端口是否冲突。出现启动错误时,先看运行环境提示,再处理代理设置。
先在「关于本机」查看芯片信息:Apple 芯片选择 Apple Silicon,Intel 处理器选择 Intel。安装完成后将应用放到固定位置,再处理系统给出的安全与网络授权提示。架构选错可能导致应用无法启动,不能通过修改订阅解决。
系统代理与更广泛的网络接管涉及不同权限,首次使用建议先完成基本代理链路验证。遇到开发者验证提示时,应先确认安装来源与系统提示内容,再按对应教程操作;不要为了消除提示而批量关闭系统保护设置。
优先查看使用 Xray 内核的 v2rayNG;需要 V2Fly 内核配置时,再考虑 v2flyNG。多数较新的设备可选择 arm64,设备架构不明确时查看系统信息或选择通用包。两款客户端分别维护配置,安装另一款并不会自动迁移原有订阅。
首次连接通常需要确认系统 VPN 授权。后台连接被中断时,检查电池优化和后台运行限制,而不是先更换协议参数。同一时刻应明确由哪个应用接管 VPN;测试结束后关闭不使用的连接,避免把应用之间的接管冲突误判为服务器故障。
根据发行版的软件包管理方式选择 deb 或 rpm,再区分 x64 与 arm64。安装包格式、处理器架构和桌面运行环境是不同条件,文件可以下载不代表当前系统一定能够运行。安装报依赖错误时,先查看软件包管理器的具体提示。
不同桌面环境对系统代理的支持存在差异,部分程序仍需独立设置代理地址。先用明确支持代理的应用验证本地监听,再决定是否使用其他接管方式。需要额外权限的功能只在理解用途后开启,不建议把整个图形客户端长期以高权限运行。
开源生态 / PROJECT & CORE
选择客户端时看平台,判断配置能否运行时看内核。界面相似、订阅相同,都不等于功能完全一致。
图形客户端导入 · 编辑 · 启停
代理内核握手 · 传输 · 分流
服务器配置协议 · 地址 · 安全层
V2Ray 源于 Project V 的模块化代理工具体系。它将流量入口、出站连接、传输方式与路由规则分开组织,使同一套内核能够适应不同使用场景。用户在图形界面里填写的服务器信息,最终通常会转换为内核读取的配置。因此,「V2Ray」有时指技术生态,有时指具体内核,不能把它简单理解为某一个桌面窗口或某一款安卓应用。
对首次使用者而言,这种分层最实际的意义是排错可以分步进行:应用是否接入本地代理、内核是否正常启动、服务器参数是否匹配,分别对应不同环节。只有先确定故障发生在哪一层,后续修改才有依据。重新安装界面程序不会自动修复服务器端的证书问题,更换订阅也不会消除本地端口冲突。
V2Fly 是 V2Ray 的社区维护延续,Xray 则从相关代码基础分支发展,形成自己的功能演进路线。两者共享部分配置概念,但扩展特性、字段支持和更新节奏并不完全一致。读取配置时应以实际使用的内核为准,而不是仅凭客户端名称包含相同字母就判断支持情况。技术参考页会按协议与安全层拆开比较,帮助确认配置需要哪些能力。
例如 VMess、VLESS、Trojan 与 Shadowsocks 属于协议选项,WebSocket 等属于传输方式,TLS 与 REALITY 又涉及安全层。它们不是一张互斥的同类名单。订阅中出现一个熟悉的协议名,也不能说明整条配置一定兼容;还要核对传输、安全层、服务器名称和相关扩展。服务器端与客户端参数需要成套匹配,单方面替换协议通常无法建立连接。
v2rayN 面向桌面系统,提供服务器列表、订阅分组、系统代理和路由等图形入口;v2rayNG 面向安卓设备,主要结合 Xray 内核使用;v2flyNG 则提供面向 V2Fly 内核的安卓使用路径。三者均属于开源客户端项目,客户端本身不等于服务器服务。安装完成后仍需使用有权访问的服务器配置,客户端名称也不能作为某个订阅来源可信的证明。
开源许可证约束代码的使用、修改和分发,不等于承诺任何网络环境下都能连接。界面程序、内核及其依赖组件可能适用不同许可证,具体权利义务应查看对应发行资料。对于日常使用,开源生态的价值在于实现方式和配置逻辑可以被讨论、检查与改进,而不是把某个项目标签直接等同于性能或隐私结论。
客户端更新通常涉及界面、配置生成逻辑、依赖与随包内核;订阅更新则刷新服务器记录。二者解决的问题不同。缺少某种协议特性时,应检查内核支持与客户端配置生成能力;地址过期或服务器参数变化时,应检查订阅。不要把一次订阅更新理解为客户端已经升级,也不要认为更新界面后所有自定义配置都会自动适配。
更新前先备份本地设置,记录当前使用的代理方式和路由规则。更新后先验证原有基本连接,再逐步恢复自定义 DNS、规则和高级接管方式。如果出现新的错误,保留具体日志,比较更新前后的设置差异。下载页集中提供安装入口,首页不固定展示版本信息,避免将客户端选择与短期发行变化混在一起。
首次配置 / QUICK CHECK
下面按首次使用的顺序检查。每次只改一项并重新测试,可以保留清晰的排错线索。
客户端是管理配置和启动内核的工具,安装包本身不提供服务器记录。先导入完整的分享链接,或在订阅分组中添加订阅地址并执行更新。若更新后仍为空,检查分组筛选、链接有效性和返回格式,不要将网页地址或说明文字当作分享链接。查看导入步骤 →
已连接通常说明客户端或内核进入运行状态,不代表所有应用的流量都被接管。桌面端先确认系统代理已配置,再确认目标应用是否遵循系统设置;安卓端还需检查是否启用按应用分流。路由只处理已经进入内核的流量,单独更换路由模式不能解决入口缺失。查看代理模式说明 →
先看日志中的错误阶段。连接超时、域名解析失败、证书验证失败和配置解析失败需要不同处理。检查系统时间、服务器地址、端口和安全层参数,再根据错误定位 DNS。协议必须与服务器配置匹配,不能将随意更换协议作为通用修复方法。查看 DNS 排查步骤 →
优先迁移订阅或兼容的分享链接,再分别调整每台设备的系统代理、监听地址与路由。桌面环境的目录、端口占用和网络权限与安卓设备不同,自定义 JSON 也可能依赖特定内核字段。迁移后先测试一条基本配置,确认可用后再恢复复杂规则。核对配置兼容性 →
使用心得 / RECENT NOTES
从平台权限、订阅更新和配置结构三个角度补充操作细节。遇到问题先保留报错原文,再对照对应检查项,不必从头重装所有组件。
先区分 Apple 芯片与 Intel 安装包,再按系统提示处理开发者验证、系统代理和网络相关权限。将安装阶段的拦截与连接阶段的报错分开,避免用修改服务器参数的方式处理本机授权问题。
阅读 macOS 权限处理 →订阅更新后列表为空,不一定代表客户端无法连接。按链接有效性、Base64 编码格式、更新时是否走代理、User-Agent 与分组设置逐项检查,区分获取失败、内容解析失败和列表筛选造成的空白。
阅读订阅自查清单 →从日志、DNS、入站、出站到路由,逐段理解客户端生成的配置。重点核对 tag 与 outboundTag 的引用关系,知道一条规则影响哪个出站,再决定是否需要手动编辑,而不是把配置片段直接拼接使用。
阅读配置结构解析 →