开源客户端 · 中文配置指南

V2Ray开源社区 v2rayN 下载

从客户端选型到订阅导入和路由分流,按系统找到安装入口,再用同一套检查顺序确认流量走向。

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks

01 设置项

V2Ray 客户端核心特性

订阅负责带来配置,系统代理或 TUN 决定流量怎样进入客户端,路由再决定流量去哪里。下面按设置项拆开看。

订阅地址与单条分享链接

订阅地址由服务提供方发给你,用来获取和刷新一组配置;单条分享链接通常只带一条连接配置。在 v2rayN 里先给订阅分组起个容易辨认的名字,保存地址后再更新该组。和逐条粘贴相比,分组更新更容易看出条目来自哪里,也能避免把临时测试的连接和常用列表混在一起。更新后先确认列表是否出现条目,再选中一项连接,不要把导入成功当成连通成功。

  • 换订阅地址前先确认要改的是哪个分组。
  • 发截图时遮住完整链接,路径本身也可能用于鉴权。
订阅地址示意 · 保留域名,不可用
https://example.invalid/list

若拿到的是以 vmess:// 或 vless:// 开头的单条链接,应使用分享链接导入入口。

02 安装包选型

按系统下载客户端

先确认系统,再确认芯片或软件包格式。应用名称相同,不意味着两台设备能用同一个安装包。

Windows

桌面版和经典 WPF 版都叫 v2rayN。第一次装可以先看桌面版;如果手头的教程以经典界面为准,或者已经熟悉旧菜单,再看 WPF 版。选包前到系统的「关于」页面核对系统类型,不要只凭系统名称判断架构。

如果拿到的是压缩包,先完整解压到当前账户可写的目录,再从目录启动。直接在压缩软件的预览里运行,容易只启动了主程序却缺少旁边的文件。已有配置时先备份,再换目录试跑;确认订阅与路由都还在,再清理旧目录。

前往下载

macOS

从苹果菜单打开「关于本机」。显示 Apple 芯片就看 Apple Silicon 包,显示 Intel 处理器就看 Intel 包。下载 v2rayN 后按镜像里的提示安装,再从应用程序目录打开,不要把挂载的镜像当作长期运行目录。

若启动被系统拦下,先看提示是在说系统兼容性、来源还是权限,不要为一个应用关闭整机保护。托盘里看得到应用也不等于系统代理已经生效;从客户端切换后,用一款遵循系统代理设置的应用测试,再决定要不要为终端另做设置。

前往下载

Android

需要 Xray 内核时看 v2rayNG,明确依赖 V2Fly 实现时再考虑 v2flyNG。多数近期设备可选 arm64;不确定设备支持哪种架构时可看通用包。通用包解决的是安装架构问题,不能让另一个内核支持缺少的协议组合。

从浏览器或文件管理器打开安装包时,安装权限通常是针对当前来源授予的,装完可以收回。首次连接时,系统可能弹出 VPN 授权;如果已有其他应用占用该连接,先断开它再测试。导入时也要区分整组订阅和单条分享链接。

前往下载

Linux

选 v2rayN 时先看发行版常用的软件包格式:Debian、Ubuntu 系通常选 deb,Fedora 系通常选 rpm;再区分 x64 与 arm64。两项都对上再安装,别把架构不匹配和缺少运行依赖当成同一类问题。

桌面环境的代理设置不一定会传给终端或后台服务。遇到浏览器正常而命令行超时,先核对本地监听地址与端口、命令行工具支持的代理类型,以及代理变量是否传进当前进程。确认这一层后,再检查客户端的路由与出站。

前往下载

03 项目与内核

Project V 开源生态

教程写的是客户端、内核还是服务端?先分清这三层,再判断一条操作建议能不能用在当前设备上。

从操作界面到处理连接
  1. 客户端导入、编辑并选择配置
  2. 内核接收入站连接,按规则选择出站
  3. 连接目标按匹配结果直连或交给代理出站
  1. Project V:客户端和内核为什么分开

    Project V 是理解这套工具的起点。早期的 V2Ray 侧重于把入站、出站和路由拆成可以组合的配置:入站负责接收连接,出站负责把连接发出去,路由负责在多个出站之间选择。这样一来,发起连接的应用、转发流量的内核和处理配置的图形界面,不必写在同一个程序里。社区后来出现的桌面与移动端客户端,正是在这个分工上提供了更方便的操作入口。

    这个历史背景在排查时很有用。例如,客户端里能看到一条订阅记录,只能说明界面有数据可用;要知道配置能不能加载,要看内核的启动结果;要知道某个应用有没有经过内核,则要检查它的流量入口。把这三件事混在一起,最容易在网络异常时反复导入订阅,却没发现应用根本没有使用代理。

  2. V2Fly 与 Xray:从共同基础到各自演进

    V2Fly 社区延续了 V2Ray 核心的开发与维护。Xray 从这一代码体系分出,随后各自演进。两边有相近的配置概念,有些协议和字段也看上去一样,但不能把共同来源当作兼容保证。尤其是涉及新的传输或安全层选项时,一边能读取的参数组合,另一边未必以相同方式处理。判断时优先看服务端明确要求了什么,再查当前客户端使用的是哪个内核。

    换设备时,也别默认把原来的整份配置搬过去。单条连接的必要参数、客户端保存的订阅分组,以及本机监听端口和系统代理设置,本来就是不同层次。可以先迁移连接条目,在新设备上测试一条连接,再逐项补回分流规则。这样即使连接失败,也比较容易判断是参数不兼容,还是新的本机设置尚未完成。

  3. 开源协议与代理协议不是一回事

    VMess、VLESS 描述的是通信双方怎样交换数据;开源许可证描述的是代码可以怎样使用、修改和再分发。两类文件解决的问题完全不同。V2Fly 核心采用 MIT 许可证,Xray-core 采用 Mozilla Public License 2.0。前者的再分发条件较少,仍要求保留相关版权和许可声明;后者的义务主要落在许可证覆盖的文件上,分发这些文件的修改时需要按条款提供相应源代码。

    组件分开维护,许可证也应分别看。图形客户端、随附内核和其他组件不能仅凭安装包的名字归到同一套条款。普通用户不用先读完这些文本才能配置客户端;但如果打算重新打包、修改或发布派生版本,应该逐项阅读相关组件随附的许可证。代理服务本身的账号、套餐和使用条件则由服务提供方决定,不是开源许可证的一部分。

  4. 三款客户端如何对应到配置需求

    v2rayN 是开源桌面客户端,把订阅分组、连接选择、路由和系统代理放在同一个界面,适合需要管理多组配置或给不同应用单独排查的场景。v2rayNG 是使用 Xray 的开源 Android 客户端;v2flyNG 同样开源,采用 V2Fly 内核。手机上不必因为两个应用名字像就都装一遍:先按服务端参数和当前客户端的支持范围选一款,完成一次基本连接,再比较设置差别。

    给别人说明问题时,说清应用名称、内核和发生错误的步骤,比贴一张只有「连接失败」的截图更有用。比如是订阅更新拿不到数据,还是选择条目后内核报错,又或者只有一个终端工具不经过代理?这三种情况要看的位置不同。分享日志时保留时间、步骤和错误类型,遮掉订阅地址、账号信息及不宜公开的服务端参数。

  5. 客户端更新、内核更新与订阅刷新

    客户端更新可能改动菜单布局、安装方式或配置存储;内核更新可能改变支持的字段和启动行为;订阅刷新只是从提供方拿回最新条目。它们并不会互相替代。更新前,先记下当前选中的条目、内核、路由模式和本地监听端口;需要保留的自定义规则单独备份。一次只改一层,用同一个应用和目标复测,才知道是哪项改动带来的变化。

    更新后如果所有应用同时失效,先看内核是否启动、入站是否在监听;如果只有某一个应用失效,先查这个应用自己的入口设置。订阅刷新后条目减少,也要先核对更新的是哪一组、来源是否真的删掉了条目,而不是马上覆盖本地手工配置。需要逐项操作时,可接着看全平台指南;已经能连通但流量走向不对,可以先查帮助中心的路由与代理问题。

04 技术笔记

系统代理、路由与订阅排查

从具体现象找检查入口:终端没有接入、流量进入后走错出站、多个订阅分组难整理,是三个不同的问题。

v2rayN 系统代理不生效排查:浏览器能打开但终端不走代理怎么办

把浏览器和终端拆开排查:先确认系统代理是否写入、浏览器扩展是否接管,再处理终端环境变量与本地端口,定位 v2rayN 系统代理失效的真正原因。

先别重装客户端。浏览器扩展、系统代理与终端参数可能分别指向不同入口;确认工具实际连到了哪个端口,才有必要检查转发。一旦确定某条连接没进客户端,改出站或路由就不会解决这条连接的问题。