桌面与安卓 · 客户端配置指南

V2Ray之家v2rayN 下载与配置

按设备选择开源客户端,从订阅导入开始,逐步设置路由分流与 TUN 模式。

  • VMess / VLESS
  • Xray / V2Fly

设置入口 / CLIENT SETTINGS

订阅、代理与分流设置

先导入配置,再决定哪些流量进入客户端,最后调整流量的出站路径。这三件事分别对应订阅管理、代理模式和路由规则,不要把其中一个设置当成全部。

订阅地址与分享链接分开导入

订阅地址用于批量获取服务器配置,分享链接通常只描述一条配置。在 v2rayN 的「订阅分组」中添加地址、填写便于辨认的备注,保存后执行「更新全部订阅」。如果拿到的是分享链接,复制后可从剪贴板导入。列表为空时先看更新日志,不要连续创建相同分组。与逐条手动填写相比,订阅能保留分组并集中更新;右侧是导入后使用的本地入站片段,不是订阅地址的格式。

查看订阅导入步骤 →
{
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ]
}

配置窗只展示相关字段,不能直接替代完整配置。图形客户端会组合入站、出站、路由和 DNS;刚开始使用时,优先在设置界面修改,每次只改一项,并记录修改前的值。

安装入口 / PLATFORMS

按平台选择 V2Ray 客户端

桌面设备优先选择 v2rayN,安卓设备优先选择 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。先确定操作系统与处理器,再选择安装格式;不要仅凭文件名中的客户端名称判断安装包是否适用。

Windows

选择 v2rayN。下载页提供桌面版与经典 WPF 版:桌面版使用跨平台界面,WPF 版保留经典操作布局。先选熟悉的界面,再根据包内说明完成安装或解压。把程序放在可写入的固定目录,避免在压缩包预览窗口中直接启动,否则配置保存与更新可能受影响。

首次运行后先导入一条可用配置,确认内核启动,再启用系统代理。如果提示端口被占用,检查是否同时运行了另一份客户端。安装与更新前保留配置备份,切换界面版本时也先确认原有订阅分组和路由设置是否完整。

前往下载

macOS

选择 v2rayN,并按芯片区分 Apple Silicon 与 Intel 安装包。可以在系统的「关于本机」中查看芯片或处理器信息,不能只根据电脑的购买年份推断。安装完成后从应用程序目录启动,遇到系统安全提示时先阅读具体原因,再按系统提供的方式处理。

系统代理与 TUN 的权限要求不同。先让浏览器通过系统代理完成访问,再评估是否需要 TUN。电脑从睡眠恢复、切换无线网络或使用其他网络工具后,如果访问异常,先检查系统代理地址和内核运行状态,不要立即删除订阅重装。

前往下载

Android

首选采用 Xray 内核的 v2rayNG;需要 V2Fly 内核时,下载页另有 v2flyNG 作为备选。现代主流设备通常选择 arm64,不能确定处理器架构时查看设备信息或选择通用版。两款应用的配置兼容性取决于内核,不应把某个客户端能导入等同于另一个客户端也能运行。

导入订阅后选择配置,再点击连接并确认系统的 VPN 授权。需要后台持续连接时,检查电池优化和后台活动限制。若应用切到后台后断开,先检查系统是否结束了进程;若前台也无法访问,再查看连接日志与订阅更新结果。

前往下载

Linux

选择 v2rayN,再按发行版选择 deb 或 rpm,按处理器选择 x64 或 arm64。安装格式与处理器架构是两项独立条件,不能相互替代。使用发行版提供的图形软件安装器完成安装;若依赖不满足,先处理安装器给出的具体提示,再尝试启动客户端。

不同桌面环境对系统代理的读取方式可能不同,有些应用仍需单独配置 SOCKS 或 HTTP 入口。先在一个明确遵循代理设置的应用中测试,再扩展到其他应用。启用 TUN 前检查权限与已有虚拟网络接口,排错时先回到普通代理状态,减少同时变化的设置项。

前往下载

查看全部客户端 →安装包入口与适用说明集中在下载中心。

操作顺序 / QUICK START

从订阅导入到连接验证

首次配置先使用默认路由与普通代理,暂时保留 TUN 和局域网共享的关闭状态。让基本连接成立后再增加功能,出现问题时更容易定位到具体环节。

  1. 添加订阅,再更新配置列表

    在 v2rayN 打开「订阅分组」,添加订阅地址和备注,保存后执行更新。安卓端 v2rayNG 可从「订阅分组设置」管理地址,再回到主界面更新订阅。复制地址时检查是否夹带空格、换行或说明文字;分享链接应走剪贴板导入,不要当作订阅地址填写。

    更新完成后应能在列表中看到导入的配置。如果列表仍为空,查看日志区分地址访问失败、内容为空和格式不受支持。订阅链接可能包含访问凭据,不要把完整地址发到公开讨论区。客户端只负责读取配置,并不自动提供订阅服务。

  2. 选择配置,再设置代理模式

    在列表中选择要使用的服务器配置,让客户端启动对应内核。桌面端需要浏览器使用代理时,选择「自动配置系统代理」;安卓端点击连接,按系统提示允许创建 VPN 连接。首次测试保持一条明确的使用路径,不要同时开启多个承担相同接管功能的工具。

    此时先使用路由预设,不要直接粘贴整份网上配置。系统代理决定应用是否把请求交给本地端口,路由决定内核收到请求后如何选择出站。应用没有遵循系统代理时,反复更换路由规则通常不能解决接管问题,需要检查应用自身的网络设置。

  3. 验证实际访问,再处理异常

    用浏览器访问日常需要的页面,确认能打开内容,而不只看连接图标或测试结果。内核测试成功只能说明特定测试路径可用,不能代表所有应用和域名都正常。随后检查另一类目标是否按预期直连,确认分流策略没有把本地服务误送到代理出站。

    遇到异常,按「内核是否启动 → 应用是否进入代理 → 路由是否命中 → DNS 是否正常」的顺序排查。连接超时、证书错误与域名解析失败对应的原因不同,应保留相关错误信息。需要分享日志时,先移除订阅地址、服务器认证信息和个人路径。

查看完整教程 →

项目关系 / OPEN SOURCE

Project V、V2Fly 与 Xray

客户端是操作界面,内核负责协议连接与流量处理。选型时把这两层分开看,才能判断一个设置到底由哪个项目提供,以及为什么同一份分享链接在不同客户端中的表现可能不同。

从工具集合到内核分支

Project V 是围绕网络代理工具形成的开源生态,V2Ray 是其中的重要组成。V2Fly 社区延续了 V2Ray 内核的开发与维护,Xray 则是从 V2Ray 演进出的另一条内核分支。两者共享部分概念与配置结构,但后续支持的协议特性、传输方式和字段会发生变化,不能把名称相近理解成配置完全一致。

VMess、VLESS 等是协议名称,WebSocket、gRPC 等属于传输方式,TLS 则涉及连接的传输安全设置。导入一条配置时,这些参数要与服务端对应。协议名称正确,并不意味着传输路径、服务器名称和端口也正确;排错时应按字段检查,而不是把所有选项同时改动。

图形客户端与内核各自负责什么

v2rayN 提供桌面端的订阅分组、服务器选择、系统代理和路由管理界面,并将设置交给相应内核执行。v2rayNG 是安卓端采用 Xray 内核的开源客户端,v2flyNG 则提供基于 V2Fly 内核的另一种选择。三款客户端均为开源项目,界面、打包与维护节奏各自独立,功能是否可用还取决于实际使用的内核能力。

选择时先看平台,再看已有配置依赖的协议与传输特性。桌面端优先从 v2rayN 开始;安卓端优先考虑 v2rayNG,需要 V2Fly 兼容行为时再评估 v2flyNG。不要仅因内核名称不同就认定连接速度存在固定差距,服务器线路、网络环境与配置通常更直接地影响访问结果。

开源协议不是统一的一份许可

开源意味着代码按相应许可证公开,允许的使用、修改与再分发条件由各项目许可证规定。V2Fly 的 V2Ray 内核与 Xray 内核采用 MPL 2.0,客户端及其依赖还可能采用其他许可。普通使用者主要关注功能与维护说明;如果要修改、打包或分发软件,应分别阅读客户端、内核及附带组件的许可文件。

公开代码便于社区讨论实现、提交问题和审阅改动,但它不能代替使用者对配置来源的判断。订阅提供方、服务器运营方和图形客户端承担不同角色。导入前应知道配置来自哪里,使用时也应了解连接将经过哪个服务器,不要把客户端的开源属性等同于第三方服务的信誉。

更新时保留可回退的配置

客户端更新可能调整菜单、配置生成方式、内核组件和规则数据。更新前备份订阅分组、路由与必要的自定义设置,并记录当前能正常使用的组合。更新后先测试既有配置,再尝试新增功能;如果基本连接失效,优先比较日志和设置变化,而不是重复导入同一批订阅。

订阅更新、客户端更新、内核更新与规则数据更新是不同操作。订阅更新用于刷新服务器配置,不会自动解决所有客户端兼容问题;路由数据过旧也不一定需要重装应用。日常维护时先确定需要更新的是哪一层,再使用对应入口,避免在尚未定位问题前扩大变动范围。

查看三款客户端横向评测 →阅读新手到进阶手册 →

专题阅读 / ARTICLES

订阅格式、协议与局域网共享

完成基本连接后,再按使用场景查阅专题。需要给其他设备共享入口时看局域网设置;导入失败时先辨认订阅格式;比较协议时关注实际配置要求,而不是只看名称。

查看全部文章 →按问题查阅常见问题 →