Linux / Windows / macOS 桌面客户端

V2Ray for Linux: v2rayN 客户端

从桌面安装、订阅导入到连接验证,按实际设置项配置 v2rayN;安卓设备可选择 v2rayNG。

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY

按设备选择下载入口

桌面客户端v2rayN 安卓客户端v2rayNG / v2flyNG 内核生态Xray · V2Fly 配置方式订阅 / 分享链接 / JSON

客户端功能与配置入口

从客户端选择到代理模式

先确定设备和内核,再配置订阅、分流与流量接管。界面为设置示意,具体名称可能随客户端更新调整。

v2rayN 桌面,统一管理连接配置

v2rayN 把订阅、服务器配置、路由规则和运行日志放在同一个桌面界面中。安装后先确认本地监听端口,再导入服务方提供的链接,选择活动配置并启动内核。系统代理适合遵循系统设置的浏览器和应用;终端工具则可单独指定代理地址。桌面版便于在不同系统间沿用操作习惯,但文件路径、网络权限和 TUN 授权仍需按系统分别处理,不能直接照搬另一台设备的运行环境。

查看桌面配置步骤 →
v2rayN · 本地代理
监听地址127.0.0.1
本地监听端口10808
日志等级warning
参数设置

客户端下载安装

按系统与架构选择安装包

桌面使用 v2rayN,安卓优先了解 v2rayNG。安装包类型、芯片架构和客户端内核是三个不同的选择维度。

v2rayN 提供新一代跨平台界面的桌面版,以及经典 WPF 版。首次安装可以先看桌面版;已有 WPF 使用习惯时,可按运行环境选择。两种界面不意味着订阅服务不同,连接仍取决于配置内容与内核兼容性。

启动异常先检查运行环境、目录写入权限与安全软件提示,不要连续覆盖配置目录。更新前保存个人设置,确认新界面中的监听端口与原来一致。

v2rayN 安装包按 Apple Silicon 与 Intel 芯片区分。先在“关于本机”中查看芯片信息,再选择对应架构。应用首次打开时,系统可能要求确认开发者相关提示,网络和代理配置权限也需要按实际提示授权。

安装完成不等于系统代理已经启用。先让客户端启动内核,再检查代理模式与浏览器请求;遇到权限提示时按教程逐项处理,不建议直接关闭系统安全机制。

Android

v2rayNG 首推

v2rayNG 使用 Xray 内核,v2flyNG 是 V2Fly 内核备选。主流较新手机通常选择 arm64 包;不确定设备架构时,可先阅读通用版说明。不要仅凭两个客户端名称相似,就认定它们支持完全相同的协议字段。

首次连接需要确认系统 VPN 授权。若切换到后台后断开,检查电池优化和后台运行限制;同时运行其他占用 VPN 接口的应用,也可能让连接被替换。

v2rayN 的 deb 包适用于采用对应包管理体系的发行版,rpm 包用于另一类发行版;还要区分 x64 与 arm64。先确认发行版、处理器架构和桌面环境,再选安装包,避免把包格式与处理器架构混为一谈。

Linux 上不同应用读取代理设置的方式并不一致。桌面代理、终端环境变量与应用自身代理配置应分别检查;只有在确实需要更广泛接管流量时,再考虑 TUN 模式和相关网络权限。

查看全部客户端 →

首次连接流程

导入、连接、验证

客户端负责读取配置和启动代理,不会自动提供可用服务器。准备好有权使用的订阅地址或分享链接,再按顺序操作。

首次测试尽量保持配置简单:一个活动配置、一种代理接入方式、一个明确的测试请求。连接稳定后再添加复杂分流和自动更新,出现问题时更容易找到改动来源。

查看完整教程 →
  1. 导入订阅或分享链接

    在订阅分组中填入完整地址,保存后执行更新;单条分享链接则通过对应导入入口添加。看到配置条目后,核对协议、服务器地址和传输设置。订阅刷新失败与配置连接失败属于不同阶段,应分别查看日志,不能只靠反复更新订阅解决。

  2. 选择配置与代理模式

    把准备测试的配置设为活动项,再启动连接。桌面先用系统代理或应用指定代理,安卓确认 VPN 授权。真连接测试可以辅助判断当前配置是否可用,但结果与测试目标和网络状态有关,不应只凭一次测试就删除整组配置。

  3. 分别验证浏览器与命令行

    浏览器打开测试页面,再用明确指定代理地址的命令检查请求。浏览器可用而终端不可用,通常应先看终端是否配置代理;两者都不可用,再检查内核日志、本地端口和远端连接。每次只改一个设置,保留能够复现问题的操作顺序。

Project V 开源生态

客户端、内核与配置字段

界面负责管理,内核负责执行。理解这层关系,比只记住一个客户端名称更有助于选型和排错。

Project V 生态

图形客户端

v2rayN · v2rayNG · v2flyNG

代理内核家族

Xray · V2Fly

具体功能取决于客户端调用的内核及其配置支持。

Project V 与 V2Ray 的关系

Project V 是围绕网络代理能力形成的开源项目生态,V2Ray 是其中常见的核心名称。日常所说的“安装 V2Ray”,往往实际指安装一个图形客户端,再由客户端管理代理内核。订阅管理、托盘菜单和配置编辑是界面层的功能;接受本地连接、建立出站和执行路由,则由内核完成。区分这两层,才能判断错误来自界面设置还是内核运行。

V2Fly 与 Xray 的内核家族

V2Fly 延续 V2Ray 相关开发,Xray 是由 V2Ray 衍生并独立发展的内核项目。两者在部分协议与配置概念上相近,但功能、字段和更新节奏并不完全相同。尤其是 VLESS、REALITY 或某些传输选项,需要核对所用内核的实际支持。REALITY 属于连接安全相关技术,不能因为它常与协议名同时出现,就把它当成可以任意互换的独立代理协议。

三款客户端的开源属性与分工

v2rayN、v2rayNG 与 v2flyNG 都是开源客户端项目。桌面端的配置管理需求优先看 v2rayN,安卓端按 Xray 或 V2Fly 的兼容需求选择另外两款。开源意味着代码与相应许可可供了解,不代表任何来源的订阅都可信。客户端、内核以及随附组件可能采用不同的开源许可,涉及修改、再分发或打包时,应分别阅读对应许可文本和发布说明,不能只按客户端名称推断全部依赖的授权条件。

程序更新与订阅更新是两件事

更新程序是更换客户端组件,更新订阅是重新获取服务器配置;前者不会自动延长服务有效期,后者也不会自动补齐内核缺少的功能。升级前记录原有代理模式、端口、路由和 DNS 设置,升级后先验证基础连接,再恢复进阶选项。配置文件包含的认证信息和订阅地址应妥善保管,提供日志时移除敏感内容,并保留足以定位问题的错误类型、发生时间与操作步骤。

需要手动编辑 JSON 时

先确认编辑的是客户端自身设置,还是交给内核执行的配置。内核 JSON 中,inbounds 定义本地入口,outbounds 定义流量出口,routing 把规则指向出站标签,dns 处理解析设置。字段名字相似不代表不同内核可以完整互换。手动修改前备份原文件,先检查 JSON 语法,再逐段验证行为;被客户端自动生成的文件还可能在下次启动时重写。

打开配置文件参考大全 →

配置与排错文章

首次连接与桌面故障排查

遇到问题时先定位阶段:程序能否启动、订阅能否更新、内核能否连接、应用是否实际使用代理。

查看全部文章 →