桌面与安卓 · 客户端配置笔记

V2Ray 客户端
v2rayN 下载与配置

按平台整理 开源客户端,从订阅导入到路由分流,对照桌面与安卓的设置位置逐项配置。

中文配置说明 Xray · V2Fly 生态
协议与安全机制
  • VMess
  • VLESS
  • Trojan
  • REALITY
内核生态
  • Xray
  • V2Fly

按平台选择客户端

先确认系统、处理器架构与安装格式,再决定客户端。桌面端从 v2rayN 开始,安卓端优先了解 v2rayNG;需要 V2Fly 内核环境时,再考虑 v2flyNG。下载页集中说明安装入口与系统要求,本页不单独分发安装文件。

Windows v2rayN · 首推

桌面版与经典 WPF 版

初次安装可先看桌面版,它采用跨平台界面;熟悉传统菜单与窗口布局的用户,可以选择经典 WPF 版。两者都要结合所用内核理解协议支持,不宜只凭界面外观判断配置能否运行。安装前在系统设置中确认设备架构,并按下载页说明选择对应入口。

已有配置时,先备份订阅分组、自定义路由与 DNS 设置,再迁移到新的程序目录。首次运行只导入一个可信订阅,选择配置后启用系统代理,通过浏览器验证访问;暂时不同时开启 TUN,便于把安装问题与接管方式分开判断。

macOS v2rayN

按芯片选择安装入口

在“关于本机”中查看芯片信息:Apple Silicon 选择 arm64,Intel 选择 x64。安装格式相同不代表处理器架构相同,选错后可能无法启动,或需要额外的兼容环境。先确认系统要求,再完成应用安装与首次打开,避免把系统权限提示误判成订阅问题。

桌面配置思路与 Windows 相通,但系统网络设置和权限位置不同。启用系统代理后,仍需确认目标应用是否读取系统代理;如果某个程序坚持直连,应先检查其自身设置。确有接管更多应用的需求时,再阅读 TUN 的权限、路由与恢复说明。

Android v2rayNG · 首推

v2rayNG 与 v2flyNG

v2rayNG 使用 Xray 内核,适合作为安卓端的起点;v2flyNG 使用 V2Fly 内核,是有明确内核需求时的备选。大部分较新的手机使用 arm64,但最终应以设备实际支持的架构为准;不确定时可查看下载页的通用版说明,不要仅按手机购买年份判断。

导入订阅后首次连接,系统会请求建立 VPN 连接的许可,这与客户端中的节点配置是两件事。分应用代理可以进一步限定哪些应用进入处理范围。若后台连接容易中断,再检查电池优化与后台运行限制;不必一开始就修改全部省电选项。

Linux v2rayN

按发行版选择 deb 或 rpm

先确认发行版采用的包管理格式,再选择 deb 或 rpm;同时区分 x64 与 arm64。桌面图形客户端需要相应的图形环境,不能把它与仅通过配置文件运行的服务端程序混为一谈。下载页把常用格式放在主要入口,另列 arm64 对应选项。

安装后先在普通桌面会话中完成订阅导入与基础连接测试。不同桌面环境对系统代理的读取方式可能不同,应用也可能有独立代理设置。需要 TUN 时,再按发行版与客户端说明处理权限;遇到异常先保存日志并恢复原来的网络设置,不要反复叠加权限改动。

客户端只提供配置与连接界面,不会自动生成可用的远端服务。订阅地址、分享链接与手动填写参数,都应来自可信且有权使用的来源。订阅通常包含访问凭据,截图、导出配置或求助时应遮住完整地址、用户标识和相关密钥。

查看全部客户端 →

系统代理、分流与订阅设置

同一套连接参数,在桌面和安卓上有不同的入口。先分清流量如何进入客户端,再决定由哪条规则处理。下面按设置目的说明;界面片段仅用于定位选项,具体名称以安装的客户端为准。

系统代理的接管范围

系统代理告诉愿意读取系统设置的应用,把连接交给本地代理端口。v2rayN 中选择自动配置系统代理后,浏览器通常可以直接测试;带独立网络设置的程序仍需单独确认。它并不等于所有流量都会进入客户端,也不等于路由已经改成全局。与安卓常见的 VPN 接管方式相比,这种入口更适合先验证桌面基础连接。退出或切换客户端前清除系统代理,可减少端口已关闭却仍被应用使用的情况。

v2rayN · 系统代理

自动配置系统代理清除系统代理
本地监听端口10808

建议按“导入订阅 → 验证系统代理或 VPN 连接 → 选择路由 → 按需启用高级接管”的顺序操作。完整路径见配置教程;需要理解域名解析、规则优先级与日常维护时,继续阅读完整手册。

Project V、V2Fly 与 Xray

先区分项目、内核与图形客户端,再阅读协议说明。三个层次解决的问题不同:项目形成技术生态,内核实现连接能力,客户端把配置操作放进桌面或手机界面。

生态关系:不是三个安装步骤

V2Ray 是 Project V 生态中的代理工具,V2Fly 延续了 V2Ray 的社区维护;Xray 则从这一生态发展出自己的实现与功能演进。阅读教程时会同时遇到这些名称,但它们不是必须依次安装的三个软件。对图形客户端用户来说,重点是当前配置最终交给哪个内核运行,以及该内核是否支持需要的协议、传输方式和安全选项。

VMess、VLESS 是代理协议名称,REALITY 属于需要结合具体配置理解的安全机制,不能把它们与客户端平台混为一类。看到订阅中包含某个名称时,应查看完整参数与兼容要求,而不是只根据名称猜测速度或稳定性。不同实现对字段的支持会随维护进展变化,旧教程中的默认值也未必适合当前环境。

客户端职责:保存配置与组织操作

v2rayN、v2rayNG、v2flyNG 都是开源图形客户端,但面向的平台与内核组合不同。v2rayN 面向桌面操作,便于管理订阅分组、切换系统代理和编辑路由;v2rayNG 围绕安卓系统的 VPN 连接与应用管理组织设置;v2flyNG 为需要 V2Fly 内核的安卓使用场景提供另一种选择。选择时先看平台与配置兼容性,再看个人习惯,不需要为了名称相似同时安装全部客户端。

图形界面能够减少手动编辑配置的工作,但不会替代远端服务,也不会修复服务本身的可用性问题。订阅可以成功导入,只能说明客户端读到了内容;内核成功启动,说明本地配置已被接受;目标网页可以访问,才是完整链路验证的一部分。把这几个阶段分开,能够减少“导入成功就一定连接正常”的误判。

开源协议:按组件理解授权范围

开源意味着相关代码以相应许可证公开,用户可以在许可条件内阅读、使用与修改。客户端、内核以及随附组件可能采用不同许可证,不能把一个项目的授权说明套用到全部组件。需要再分发或修改程序时,应分别阅读软件附带的许可文本,保留要求的版权与授权声明;普通使用者则可从这些信息理解项目来源与维护方式。

社区维护也不意味着所有功能会同时出现在不同客户端。桌面界面的选项位置、安卓端的权限处理、内核对新字段的接受情况,都可能独立变化。本页以功能目的组织说明,不把某个按钮的位置当成长期不变的标准;遇到界面差异时,先对照“系统代理、路由、订阅、DNS、TUN”这些概念,再寻找当前版本中的对应入口。

更新与维护:保留可回退的配置

客户端更新、内核更新和订阅更新是三条不同的维护路径。客户端更新主要影响界面、集成方式与系统适配;内核更新影响协议实现和运行行为;订阅更新只会重新获取服务方提供的配置。一次只处理一类变化,并在更新后做基础验证,能够更清楚地判断异常来自哪一层。长期自定义的路由、DNS 与分应用设置应单独记录,避免迁移时遗漏。

日常检查可以从常用应用开始:确认客户端仍在运行、当前配置可用、系统代理或 VPN 状态符合预期,再查看路由与 DNS。日志中的解析失败、连接被拒绝和握手错误指向不同阶段,应结合错误发生时间判断。分享日志前去除订阅地址与连接凭据;需要测速时,也应理解测试目标和方法,不把单次结果当作实际下载体验的保证。

更完整的配置顺序见从零到精通完整手册,域名解析问题可直接阅读DNS 设置章节,测速与更新方法归入日常维护章节。当基础连接已经稳定,再逐项尝试嗅探、FakeDNS 或更细的路由规则,比同时开启全部高级选项更容易维护。

V2Ray 配置与排查文章

教程按操作顺序展开,文章按具体问题补充。刚完成安装可先读新手十问;已经能够连接但体验不稳定时,按节点、线路和本地设置逐层定位;比较协议时,重点看参数与安全机制,不只看名称。