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

V2Ray官网客户端下载

下载v2rayN 查看教程

从订阅导入到系统代理，按顺序配置路由分流。

代码开源多内核配置中文操作说明

客户端的五个配置入口

先把连接信息导入，再决定哪些应用接入代理。下面的设置切片用于说明入口，不是网页上的可操作客户端。

订阅地址，保存一次再更新

订阅适合管理一组会变动的连接配置。在 v2rayN 的订阅分组设置中填写备注与完整地址，保存后执行更新订阅。客户端会读取地址返回的内容，再生成对应的服务器条目。相比逐条粘贴分享链接，订阅保留了后续更新入口；但地址本身不是连接参数，也不能仅靠保存地址完成连接。更新后先确认分组里出现有效条目，再选择活动配置。若结果为空，应检查地址是否过期、返回内容是否为配置文本，以及更新请求是否受当前代理状态影响。

  • 备注只用于区分来源，建议按用途命名。
  • 截图或求助前，遮住完整地址与认证参数。
  • 更新失败时先保留原配置，再排查请求路径。
订阅分组设置
备注日常订阅
地址(URL)https://example.com/your-sub

示例地址仅用于说明格式，请使用已有的有效订阅。

更新订阅(不通过代理)

这五个入口分别解决不同问题：订阅和分享链接负责把配置带进来，系统代理与 TUN 负责让应用流量进入客户端，路由负责选择出站，内核负责执行具体连接。排查时沿着这个顺序检查，比同时切换多个开关更容易判断原因。仅仅导入成功，说明客户端读懂了配置，不代表服务端已经可达；浏览器可以打开网页，也不代表其他应用已经采用相同路径。

如果刚接触这些概念，先保持默认设置，完成一次最小可用配置。能够稳定复现正常连接后，再添加域名例外或启用其他接入方式。每次只改一项，并记录改动前后的表现。需要理解术语时可以查阅名词解释；需要按平台核对权限和安装细节时，再进入使用文档，不必在首次启动时就阅读全部参数。

按系统选择客户端

桌面系统选择 v2rayN，安卓设备优先了解 v2rayNG。下载页会进一步区分处理器架构和安装包类型。

Windows

 v2rayN · 桌面版 / WPF 版

桌面版采用跨平台界面，WPF 版保留经典桌面交互。初次安装可以先看界面差异与系统要求，不必为了同一组订阅同时安装两版。两种界面中的设置位置可能不同，操作时按功能名称寻找入口。

下载前在系统信息中确认处理器类型，安装后把配置放在便于管理且具备写入权限的位置。若程序提示缺少运行环境，按安装说明补齐对应组件，再继续导入订阅。

前往下载 Windows 客户端 →

macOS

 v2rayN · 桌面版

先在“关于本机”查看芯片信息，再选择 Apple Silicon 或 Intel 对应安装包。架构选择影响程序能否直接运行，与订阅使用哪种协议是两件不同的事，不应混在一起判断。

首次启动时按系统提示处理应用权限。系统代理可用后，再按实际需求考虑 TUN；涉及网络扩展或管理员授权时，先阅读平台说明，不要直接套用其他桌面系统的操作路径。

前往下载 macOS 客户端 →

Android

 v2rayNG 首推 · v2flyNG 备选

v2rayNG 使用 Xray 内核，v2flyNG 提供 V2Fly 内核选择。主流设备通常可以选择 arm64 安装包；不确定架构时先看下载页说明，再决定是否使用通用版。安装包架构与内核家族需要分别考虑。

导入订阅后选择活动配置，连接时确认系统的虚拟专用网络授权。若切到后台后连接中断，检查电池管理与后台运行限制；若另一款网络工具正在连接，先处理系统连接占用。

前往下载 Android 客户端 →

Linux

 v2rayN · deb / rpm

根据发行版的包管理方式选择 deb 或 rpm，再核对设备是 x64 还是 arm64。图形界面相近不代表桌面环境完全一致，系统代理是否被应用读取，还取决于应用本身与桌面会话的实现。

先完成普通用户环境下的启动和订阅导入，再处理 TUN 需要的额外权限。若网页与其他程序表现不同，应检查各自的代理来源，避免把桌面代理设置误认为所有进程共享的网络开关。

前往下载 Linux 客户端 →

下载客户端不会自动获得连接配置。开始前应准备已有的有效订阅地址或分享链接，并了解其来源和使用范围。换设备时可以迁移配置，但本机代理开关、系统授权和后台权限仍要重新检查。

查看全部客户端 →

首次配置的三步顺序

先确认配置被读入，再确认应用使用代理，最后验证路由。每一步都留一个可以观察的结果。

  1. 导入订阅或分享链接

    先分清拿到的文本是什么。订阅地址通常需要添加到订阅分组中，再执行更新；单条分享链接则使用剪贴板或扫码入口。不要把网页说明地址当作订阅，也不要把整段聊天记录一起粘贴到地址栏。

    更新完成后检查分组是否出现配置、备注是否符合预期，再选择要使用的条目。暂时不要修改传输与安全参数，先保留来源提供的完整设置。如果没有生成条目，应优先排查地址和内容格式，而不是开启更多代理开关。

  2. 选择接入方式

    桌面端先用自动配置系统代理验证浏览器；安卓端在启动连接时确认系统授权。目标应用如果有自己的代理设置，需要单独检查它是遵循系统、使用手动配置，还是完全忽略系统代理。

    TUN 应作为明确需求下的下一步，而不是导入订阅后的必选项。启用前确认权限，并暂停其他可能接管流量的工具。局域网共享属于另一项独立功能，个人设备本机使用时通常不需要为了连接而开启它。

  3. 验证连接与分流

    先用常用浏览器访问一个已知可达的网站，再检查真正需要代理的目标应用。若两者表现不同，先检查应用接入方式；若都失败，再核对活动配置、系统时间和客户端日志中的错误类型。

    连接正常后再使用路由预设，并逐项增加例外规则。遇到变化先回退最后一次改动，不要同时更换订阅、内核和路由。结束使用时恢复不再需要的系统代理设置，避免客户端退出后应用仍指向本地端口。

卡在某一步时，保留最小配置。“订阅能更新”“内核能启动”“浏览器能访问”是三个不同的检查结果。把问题停留在哪一层记清楚，后续排查就能少走弯路。分享日志前先遮住服务器地址、用户标识和订阅参数，仅保留必要的错误信息。

查看完整教程 →

Project V 与开源内核生态

先分清项目、内核和图形客户端，再理解更新与兼容性。名称相近，不代表它们承担同一层工作。

Project V：从工具集合到客户端生态

Project V 是理解 V2Ray 背景的一个起点，重点在于模块化的网络代理能力：入站接收流量，出站建立连接，路由规则决定流量交给哪个出站。日常说的“V2Ray 客户端”往往指带图形界面的管理程序，而不是单指其中某个可执行内核。图形界面把原本需要手动编辑的参数整理成表单、菜单与订阅分组，降低了日常配置的操作成本。

这种分层也解释了为什么同一份连接信息能出现在不同客户端中：分享格式承担配置交换，内核负责执行连接，界面负责管理。具体参数能否互通，仍要看双方对协议和扩展字段的支持。了解这层关系后，遇到导入失败就可以先检查格式，遇到启动失败就检查内核参数，而不是只根据客户端名称判断原因。

V2Fly 与 Xray：相关但独立演进

V2Fly 社区延续 V2Ray 相关开发，Xray 则是从相关技术基础演进而来的另一条内核路线。两者共享部分概念和协议基础，也在各自发展过程中形成不同功能与兼容范围。订阅提供方写出的协议名称只是检查起点，传输方式、安全参数以及具体实现要求同样重要。某个字段在一个内核中有效，不意味着另一个内核会原样接受。

选型时应先看服务端给出的配置要求，再选择能正确处理这些要求的客户端与内核组合。不要把内核名称当作笼统的性能排名，也不要为了排查一次超时就频繁更换工具。先确认系统时间、接入方式和活动配置，再核对协议能力，通常更容易保留可比较的检查结果。

开源协议：看清代码与使用边界

v2rayN、v2rayNG 与 v2flyNG 都属于开源客户端。开源意味着代码在各自许可证约定下可供阅读、使用与参与改进，不等于所有项目采用同一份许可证。客户端、所调用的内核及随附组件可能分别受不同条款约束；涉及再分发或修改时，应阅读对应项目随附的许可说明，而不是只依据界面名称作判断。

客户端免费提供，也不等于连接资源由客户端提供。订阅地址、服务器和账号来自各自的配置来源，它们的可用性与客户端代码是否开源是不同问题。本站围绕下载选择与配置方法整理说明，不提供可公开共享的订阅凭据。使用前应确认配置来源可信，并遵守所在地适用规定和网络服务条款。

社区维护：更新前先保留可用设置

开源生态通过社区持续修正兼容问题、调整界面与增加功能。客户端更新、内核更新和规则资源更新可能各自发生，因此“更新完成”需要结合对象理解。安装新界面后，旧配置能否迁移、原有内核是否仍被使用、规则资源是否匹配，都值得按更新说明逐项确认。不要仅因为界面看起来相同，就跳过迁移检查。

更新前记录当前接入方式与路由选择，备份必要的配置；更新后先验证原本能正常工作的场景，再启用新增选项。配置备份可能包含订阅和认证信息，应按敏感文件保存。若遇到行为变化，先对比设置和错误信息，再决定是否回退。有关平台权限、配置迁移和常见冲突，可继续查阅全平台使用文档。

近期技术笔记

围绕实际配置中容易混淆的入口、版本形态与错误现象展开。先按遇到的问题选文章，再回到客户端逐项验证。

如果还不能确定该查哪一类问题，先从入门指南完整走一遍操作顺序。已经能够连接、只想调整特定域名的走向时，再阅读路由相关说明，避免在基础配置尚未确认时引入额外变量。

查看全部文章 →