客户端与配置文档 Xray / V2Fly

V2Ray手机版

v2rayNG 与 v2rayN 客户端下载

从安卓订阅导入到桌面路由分流,按系统选择客户端,配套中文配置文档。

永久免费 代码开源 图形配置

CONFIG / 检修通道

订阅、路由与连接设置

客户端负责把输入变成配置,内核负责执行配置。先认清这条分工,再看菜单就不容易绕圈:订阅决定服务器清单,路由决定流量去向,系统代理或 VPN 模式决定哪些应用能把请求交给客户端。设置不是开关越多越好,先跑通默认链路,再逐项调整。

V2Ray 路由规则:先匹配,再出站

路由解决“这次请求走哪里”,不负责开启系统代理。在 v2rayNG 的「设置」中选择「绕过局域网及大陆地址」,可让符合规则的流量直连;桌面端在 v2rayN 的「路由设置」中管理规则。规则按顺序匹配,具体域名应放在宽泛规则前面。下面片段只说明局域网地址直连,需要已有标签为 direct 的出站才能接入完整配置。三个客户端的菜单不同,最终都要核对规则与内核支持的字段。

routing · 局域网直连片段
{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

DOWNLOAD / 按系统选包

四个平台的客户端下载入口

桌面端首选 v2rayN,安卓端首选 v2rayNG,v2flyNG 作为 V2Fly 内核备选。平台相同也要看处理器架构:先确认系统,再确认芯片,最后挑安装包。这里的入口会直接打开下载中心对应平台,具体文件与发布信息在客户端下载卡片内查看。

Windows · v2rayN

适合需要系统代理、订阅分组和自定义路由的桌面用户。下载中心同时提供桌面版与经典 WPF 版入口:桌面版采用新一代跨平台界面,WPF 版保留经典操作方式。选择时看使用习惯与当前系统条件,不必为了导入同一份订阅同时运行两套客户端。

安装后先打开主界面,确认内核能启动,再添加订阅。若窗口启动后立即退出,按提示检查运行环境、安装目录权限与安全软件记录。系统代理开启后,通常只影响遵循该设置的应用;某个程序仍直连时,先核对程序自己的代理选项,再考虑 TUN。把系统代理和路由模式当成同一个按钮,是常见的第一处岔路。

Windows 前往下载

macOS · v2rayN

适合在桌面上用图形界面管理服务器与路由的用户。先打开「关于本机」查看芯片:Apple Silicon 选择 arm64,Intel 选择 x64。处理器架构选错时,应用可能无法正常启动,不能靠重新导入订阅解决。安装包类型与系统要求以下载中心的说明为准。

首次启动若出现系统安全提示,先确认文件来源,再依据系统设置完成授权。连接之后分别检查当前网络服务的代理设置和客户端路由,不要只看主界面的运行状态。使用 TUN 时还要处理相应权限;它与普通系统代理的覆盖范围不同。退出客户端前关闭已启用的代理,有助于避免应用退出了、系统仍向本地端口发送请求的情况。

macOS 前往下载

Android · v2rayNG / v2flyNG

v2rayNG 使用 Xray 内核,适合作为安卓端的常用选择;v2flyNG 使用 V2Fly 内核,适合已有配置依赖对应内核行为的场景。主流较新的手机通常选 arm64,架构不确定时查看设备信息,或按下载中心说明选择通用版。客户端安装完成后仍需自行导入有效配置。

第一次启动连接时,系统会请求 VPN 授权。允许后再检查是否能访问目标站点,授权成功不等于服务端已经连通。长时间待机后连接中断,可检查电池优化、后台运行限制与网络切换情况。两个客户端不宜同时建立 VPN 连接;切换测试时先停止上一款,再启动下一款,否则系统授权和后台状态容易互相干扰。

Android 前往下载

Linux · v2rayN

适合使用 Linux 桌面环境、希望以图形界面维护订阅的用户。Ubuntu、Debian 系通常选择 deb,Fedora、openSUSE 等环境通常选择 rpm;再按处理器选择 x64 或 arm64。包格式只是安装入口,依赖是否齐全、桌面环境是否可用,也会影响应用启动。

安装后先从应用菜单启动,确认配置目录可以写入。桌面系统代理并不等于所有终端程序自动使用代理,部分工具有独立的网络设置。TUN 还涉及权限与路由,建议在普通代理连接可用后再配置。登录自动启动和开机后台服务也不是一回事:前者依赖桌面会话,后者涉及独立服务管理,不能用同一条勾选说明一概代替。

Linux 前往下载

QUICKSTART / 从输入到验证

V2Ray 使用教程:三步跑通配置

准备好客户端和有效订阅地址,再开始下面的操作。软件安装包只提供本地程序,订阅和服务器连接信息需要另外准备。初次配置先保持默认参数,等最小链路跑通后,再修改分流、DNS 或多路复用。一次只动一项,回头排查时才能知道哪颗螺丝被拧过。

  1. 保存订阅,更新服务器清单

    在 v2rayN 中打开「订阅分组设置」,新增分组,填写备注与订阅地址,保存后从「订阅分组」菜单执行更新。v2rayNG 同样先在「订阅分组设置」中保存地址,再返回主界面选择「更新订阅」。不要把网页说明文字一起复制进地址栏,注意前后空格和换行。

    如果拿到的是以 vmess:// 或 vless:// 开头的分享链接,应使用「从剪贴板导入」相关菜单,而不是当作订阅地址保存。导入结束后检查服务器是否出现在主界面,端口、传输与 TLS 设置是否与提供方说明一致。订阅更新失败时先保留已有清单,检查当前网络能否访问地址;不要把“请求失败”误判成“所有服务器都失效”。

  2. 选择服务器,区分接管与分流

    在服务器列表中选中需要使用的配置。桌面端根据需求启用系统代理,安卓端启动连接并完成系统 VPN 授权。先用普通代理或默认 VPN 模式测试,不急着把所有高级开关打开。系统代理解决应用把请求交给谁,路由模式解决客户端收到请求后往哪里发,两层设置要分开检查。

    日常使用可按需要选择绕过局域网及大陆地址等路由方案。切换到全局模式只是改变进入客户端的流量走向,并不会让原本忽略系统代理的应用自动接入。若某个桌面程序有独立代理设置,应核对它使用的地址、端口和代理类型;需要更广的流量接管范围时,再按平台文档配置 TUN,并留意权限与其他网络工具的冲突。

  3. 实际访问验证,再查看日志

    打开一个确定可以访问的网页,再测试实际需要使用的目标站点。先分清是所有请求失败、只有某个域名失败,还是只有一个应用失败。客户端显示正在运行,只能说明本地状态;服务器可达、认证正确、DNS 解析正常,仍需要通过真实请求确认。列表中的测试结果也不能替代浏览器访问。

    遇到错误,按本地接管、域名解析、远端连接、路由命中顺序缩小范围。超时优先检查网络和服务器地址,认证错误核对凭据,证书或握手错误核对系统时间、服务器名称与 TLS 参数。分享日志前遮住订阅地址、用户标识和服务器敏感信息,保留错误类型与发生位置即可。准备好这些信息,比连续切换一整排开关更有诊断价值。

ECOSYSTEM / 客户端与内核分工

Project V、V2Fly 与Xray 生态

Project VV2FlyXray-core社区维护

V2Ray 是生态名称,不是一份通用安装包

Project V 以模块化网络代理工具为基础,V2Ray 是这一生态中广为使用的名称。用户搜索“V2Ray手机版”时,通常需要的是能在手机上导入配置、启动连接的图形客户端,而不是手动编辑内核配置文件。桌面上的 v2rayN、安卓上的 v2rayNG 和 v2flyNG,就处在这一层:提供界面、保存服务器资料、生成配置,并调用相应内核执行网络功能。

因此,本站把下载与配置操作分开组织。下载中心负责平台和安装包选择,上手教程负责最短操作链路,完整文档负责各平台的权限、代理与故障定位。遇到问题时先确定属于哪一层:界面打不开属于客户端或运行环境,订阅拉取失败属于地址与请求过程,连接握手失败则要看内核配置和服务端参数。名称相近,不代表排查入口相同。

V2Fly 与 Xray:有共同背景,也有各自演进

V2Fly 是持续维护 V2Ray 相关工具的社区,Xray-core 从相关代码基础发展而来,并形成自己的功能演进路线。两者有共享的配置概念,也存在协议能力、参数支持和默认行为上的差异。教程中的字段需要结合实际内核理解,不能仅凭“都叫 V2Ray 客户端”就假定所有配置互相兼容。

选择内核时先看服务端要求,再看客户端实际提供的支持。某个分享链接能被识别,只表示客户端读懂了链接格式,不保证每个参数都能由当前内核执行。尤其涉及较新的协议特性时,要同时核对客户端与内核的更新说明。更换内核可以用于兼容性验证,但不应拿它替代服务器地址、认证信息和传输设置的基本检查。

三款开源客户端,按平台和内核需求选

v2rayN 是面向 Windows、macOS 与 Linux 的开源桌面客户端,适合用图形界面维护多组订阅、切换服务器和编辑路由。v2rayNG 是使用 Xray 内核的开源安卓客户端,适合常规手机连接与订阅管理。v2flyNG 是使用 V2Fly 内核的开源安卓客户端,作为有对应兼容需求时的备选。这里的首推顺序依据平台定位,不是人为生成的速度排名。

三个客户端都属于社区维护的软件项目,软件本身免费使用。免费客户端与远端服务器服务是两件事,服务器的费用、有效期和访问条件由其提供方决定。本站整理的是客户端入口与操作说明,不把软件安装等同于已经获得远端连接资源。想比较菜单、平台与内核差异,可阅读三款客户端横向评测,再决定是否需要保留备用客户端。

开源协议:说明使用权利,也保留责任边界

Project V 生态里的客户端与内核分别发布源代码,并由各自的开源许可证规定使用、修改和再分发条件。V2Fly 的 V2Ray 核心与 Xray-core 采用 MPL-2.0,客户端则应以各自发布材料中的许可证为准。源代码可公开阅读是一项可核实的项目属性,但不能据此推导每个第三方服务器或订阅服务的行为。

实际使用中,仍要妥善保存订阅地址、理解 VPN 权限与代理范围,并遵守所处环境的网络使用规定。将配置截图、日志或分享链接发给他人前,应去除可识别账号的部分。遇到陌生配置,不要只看备注名称;检查服务器地址、端口、传输方式和路由去向,才能知道客户端被要求执行什么操作。

更新客户端,也核对配置是否仍然适用

客户端更新可能调整界面、修复导入问题或配合内核能力变化;内核更新则可能影响协议支持和配置解释方式。更新前保留订阅分组与自定义路由的备份,记录正在使用的代理方式。更新后先验证一组已知可用配置,再恢复高级设置,避免把新界面差异、旧字段兼容和网络波动混在一起判断。

本站首页不承担具体发布信息展示,当前下载文件与发布信息集中在下载中心。文档中的菜单名用于定位操作,若客户端界面发生调整,应按功能含义与更新说明核对。不要把旧截图当成必须逐像素相同的标准:关键是订阅保存在哪里、代理何时启用、规则最终指向哪个出站,这三件事始终值得逐项确认。

NOTES / 使用心得

分享链接、代理模式与启动排查

下面三篇按发布时间排列,分别处理导入入口、流量走向和客户端启动问题。先找与症状对应的文章,不必从高级参数读起。订阅导入与连接故障是不同问题,客户端还没打开时,也不需要先修改远端服务器配置。

vmess:// 与 vless:// 分享链接怎么导入:单节点链接和订阅地址的区别

单条分享链接通常对应一个服务器,订阅地址对应可以定期更新的清单。两者都能复制,却不应塞进同一个输入框。文章拆开格式差异,分别说明 v2rayNG 和 v2rayN 的导入入口,以及为什么单条链接导入成功后不会自动获得后续服务器变更。适合拿到链接后不知道从哪个菜单开始的用户。

阅读分享链接导入说明 →

系统代理、全局模式与绕过大陆怎么选:V2Ray 代理模式对照说明

系统代理开关与路由模式各管一层,名字相近,作用不同。文章对照全局、绕过大陆和直连的流量走向,解释为什么“全局”不等于接管设备上的所有程序,并按浏览器访问、局域网服务和独立代理应用等场景说明选择方法。排查某个应用仍走直连时,可以先从这篇把接管范围理清。

阅读代理模式对照 →

v2rayN 打开就闪退、启动崩溃怎么办:运行库缺失与权限问题排查

窗口尚未稳定打开,优先处理本地环境。文章从 .NET 运行环境、解压路径、安全软件记录和目录写入权限逐项检查,说明哪些提示属于客户端启动、哪些属于内核启动。每次处理一个原因并复测,避免反复重装却留下同一处权限问题。订阅是否有效,可以等主界面正常运行后再检查。

阅读启动崩溃排查 →