desktop client / configuration guide

V2Ray for Linux v2rayN 客户端下载与配置

从订阅导入开始,按顺序设置系统代理与路由分流。

protocols
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
内核
Xray / V2Fly
客户端
3
平台
4

download

平台选择,客户端下载

桌面端使用 v2rayN,安卓端优先选择 v2rayNG。先确认操作系统与处理器架构,再进入下载页选择对应安装包;客户端名称相近,不代表安装格式与内核能力完全相同。

Windows

v2rayN / Desktop · WPF

桌面版采用跨平台界面,经典 WPF 版保留熟悉的 Windows 桌面操作方式。两种入口都用于管理订阅、选择活动节点和设置代理;按系统要求及界面使用习惯选择即可,不需要为了导入同一份订阅同时安装两版。

首次启动后,先看节点列表与日志是否正常,再开启系统代理。若浏览器可以访问而开发工具仍连接失败,应检查工具自己的代理选项。软件能够启动、内核运行和应用流量进入代理,是三个需要分别确认的环节。

前往下载 →

macOS

v2rayN / Apple Silicon · Intel

先在“关于本机”中查看芯片信息。Apple Silicon 对应 arm64,Intel 对应 x64;按处理器选择磁盘映像,比仅凭电脑外观判断更可靠。安装完成后从应用程序目录启动,并按系统提示处理首次打开所需的权限。

导入订阅后,先使用系统代理完成浏览器验证,再考虑其他接管方式。终端工具未必读取桌面网络代理设置,需要单独指定代理地址。修改系统网络选项前记下原值,退出客户端时也要确认代理设置是否已恢复。

前往下载 →

Android

v2rayNG / Xray · v2flyNG / V2Fly

v2rayNG 是安卓端的优先入口,v2flyNG 用于需要 V2Fly 内核的配置。多数较新的手机可选择 arm64;不确定设备架构时,先阅读下载页的包型说明。两款应用的内核与选项并不完全一致,不能只凭分享链接能够导入就判断配置兼容。

首次连接需要确认系统 VPN 授权。节点配置负责连接参数,应用分流负责哪些应用进入接管范围,二者不是同一个开关。如果切到后台后连接中断,检查电池优化与后台运行限制,再回到日志判断是否存在实际的连接错误。

前往下载 →

Linux

v2rayN / deb · rpm

Debian、Ubuntu 等发行版通常选择 deb,Fedora 等发行版通常选择 rpm,同时区分 x64 与 arm64。安装包格式匹配只是第一步,还要确认当前发行版的桌面环境与运行依赖满足要求。图形客户端需要在可用的桌面会话中启动。

Linux 桌面的系统代理设置与终端环境变量彼此独立。建议先通过本地 SOCKS 端口测试连通性,再设置桌面网络代理;需要 TUN 时再检查权限、路由和 DNS。逐层验证能够避免把桌面设置问题误判为节点失效。

前往下载 →

下载页按平台集中列出包型与适用说明。安装包选择完成后,返回快速上手教程继续导入配置,不必在首页寻找具体文件。

查看全部客户端 →

features

配置入口,五项核心设置

订阅解决配置来源,代理模式解决流量入口,路由解决出口选择。先区分这三层,再按需要启用 TUN 或切换内核。下方是设置项示意,实际名称与可用功能以所用客户端为准。

订阅分组与节点更新

订阅链接用于批量获取节点配置,适合需要定期同步连接参数的场景。在 v2rayN 中先建立订阅分组,填写地址并保存,再执行更新,随后选择活动节点。与逐条粘贴分享链接相比,分组便于区分来源,也方便单独更新或停用。更新通常针对节点列表,不等于同步全部本地路由规则;删除或覆盖前应保留必要设置。订阅地址可能包含访问权限信息,不宜放进公开截图、日志或共享文档。

  • 订阅分组:备注与地址
  • 更新订阅:确认列表已刷新
  • 活动节点:连接前单独选定
查看订阅导入步骤 →
v2rayN订阅分组设置
订阅分组基础设置
备注日常使用
自动更新间隔按需设置
启用更新
取消确定

设置示意:先保存分组,再从订阅菜单执行更新。

quickstart

首次连接,三个操作阶段

安装完成不等于配置完成。按“导入配置、选择入口、验证连接”的顺序进行,每个阶段只处理一类问题。这样即使某一步失败,也能保留已经确认正常的部分。

01 / import

导入订阅,确认活动节点

准备已有的有效订阅链接或分享链接。v2rayN 从订阅分组开始,保存地址后执行更新;v2rayNG 从订阅设置添加来源,再更新配置。仅把地址粘进输入框还没有完成导入,需要回到列表确认配置确实出现,并手动选择准备使用的节点。

检查协议类型、服务器端口、传输方式与安全层是否符合配置来源的说明。不要把网页地址当作订阅地址,也不要在更新失败时反复删除全部分组。先看提示属于地址不可达、内容无法解析还是导入后列表为空,再决定是调整更新方式还是核对配置来源。

订阅与单节点分享链接的区别在于管理范围:前者通常用于批量刷新,后者用于导入某一条配置。客户端不提供远端服务器账户,安装软件本身也不会生成可连接的服务。已有配置才能继续下一步。

订阅导入操作说明 →

02 / connect

选择代理入口,再选择路由模式

桌面端先启用系统代理,让遵循系统设置的应用进入本地监听端口。安卓端启动连接时按系统提示确认 VPN 授权。随后选择适合当前用途的路由预设;路由预设改变的是出口决策,不会替代应用接入代理的步骤。

日常浏览可以先用常见分流预设测试,同时访问本地资源和远程站点,观察两类请求是否都正常。开发工具、终端和部分独立应用可能不读取系统代理,应在各自设置中指定代理类型、地址和端口。没有明确需求时,不必一开始就启用 TUN 或叠加多套自定义规则。

本地监听地址通常使用回环地址。只有确实需要为同一局域网设备提供代理时,才评估开放监听范围与防火墙设置;“允许来自局域网的连接”不是普通本机使用的必需选项。

查看模式选择步骤 →

03 / verify

验证网页、DNS 与应用流量

先打开浏览器访问可用于测试的网页,再检查客户端日志中是否出现对应连接。若工具提供连接测试,可把结果作为辅助信息,但测试成功不代表每个应用都已使用代理。实际业务访问、域名解析和系统接管范围仍需要分别确认。

网页打不开时,先检查系统时间、节点配置与本地端口,再检查系统代理、DNS 和路由。浏览器正常而终端失败,优先看终端代理设置;域名访问失败而连接 IP 的测试正常,应重点检查解析路径。每次只修改一个设置,记录结果后再继续,避免同时改动让故障来源变得模糊。

验证完成后再整理日常配置:保留可用的订阅分组,记录常用路由模式,并了解退出客户端后的系统网络状态。后续更新或更换网络时,可以用相同顺序复查,而不是从头重装。

进入疑难解答 →

ecosystem

开源生态,客户端与内核的分工

V2Ray 并不是单一图形应用的名称。理解 Project V、V2Fly、Xray 与三款客户端的关系,有助于判断一份配置应当交给哪个程序,以及错误发生在哪一层。

Project V:从代理内核到图形入口

Project V 围绕模块化代理工具形成生态,V2Ray 是其中广为使用的核心项目。内核把入站、出站、路由和协议处理组合起来,图形客户端则把这些能力整理为订阅分组、节点列表和设置窗口。用户点击连接后,实际处理网络请求的通常是客户端启动或集成的内核,而不是界面本身。

这也解释了为什么同样写着 V2Ray 的配置,在不同客户端中可能有不同表现:客户端的导入解析、生成配置的方式,以及内核支持的参数都可能影响结果。排查时应区分“链接能否导入”“内核能否启动”和“目标请求能否完成”,不要把三个环节合并为一个连接状态。

V2Fly 与 Xray:相关但不等同的实现

V2Fly 延续 V2Ray 的社区开发,Xray 则是在相关技术基础上发展出的内核项目。两者有共同的技术来源,也各自演进协议能力和配置行为。常见名称如 VMess、VLESS、Trojan 表示协议,WebSocket 等名称表示传输方式,TLS、REALITY 等涉及安全层;这些名称不能相互替代。

选择内核应当从实际配置要求出发,而不是只比较项目名称。例如使用特定扩展参数时,需要确认该内核确实支持对应组合;普通配置也不应为了切换内核而随意改写安全参数。协议本身不能单独决定速度,网络路径、服务端资源、传输方式和客户端环境都会影响体验。

三款客户端:桌面管理与安卓使用

v2rayN 为桌面使用提供图形配置入口,覆盖本页列出的三个桌面平台。v2rayNG 面向安卓并采用 Xray 内核,v2flyNG 则提供基于 V2Fly 内核的安卓入口。这三款客户端均为开源项目,但各自的界面布局、导入能力和内核集成方式不同,不能把某一款的菜单路径原样套到另一款。

开源意味着源代码可以依照相应许可证查看、使用与参与改进,不等于客户端包含远端代理服务,也不意味着任意配置都适合导入。配置来源、应用权限和设备运行环境仍需独立评估。对普通使用者而言,选择适合平台和协议的客户端,比同时安装多款再混合修改设置更容易维护。

许可证与更新:界面、内核、规则分开看

客户端、内核与配套数据可能采用不同的开源许可证。使用、修改或再分发时,应分别阅读所涉及项目的许可说明;不能用一个笼统的“开源”标签替代具体条款。社区维护让问题修复和功能演进持续发生,更新是否适合当前设备,则仍要结合系统要求与变更说明判断。

日常维护也要区分更新对象。更新订阅通常改变远端提供的节点配置,更新客户端可能改变界面和配置生成逻辑,更新内核则可能影响协议实现;域名与 IP 分类数据又属于另一层。出现变化后先确认更新的是哪一部分,再对照日志复查,能够减少不必要的回退和重装。

阅读选择:只有网页无法打开,先到疑难解答按入口、解析、出口检查;需要统一桌面与手机上的节点来源,阅读多设备配置同步方案;准备手写分流规则,再看路由章节。按问题进入文档,比一次打开全部高级选项更容易定位原因。

journal

专题阅读,配置与协议说明

基础连接完成后,再处理更具体的配置问题。以下三篇文章分别讨论协议机制、多设备同步与自定义路由:先确认当前需求属于哪一层,再选择对应的设置方法。