开源客户端索引

V2Ray中文站v2rayN 下载与配置

按平台选择开源客户端,从订阅导入开始,查阅路由分流和内核配置。

01 配置演示

客户端设置与 JSON 字段

界面负责管理订阅和启动内核,配置文件描述内核如何接收、解析和转发流量。下列片段用于辨认字段,不能直接当作完整配置运行。

订阅条目与本地入站

订阅用于批量更新节点。以 v2rayN 为例,先添加订阅地址并更新对应分组,再从更新后的列表选择节点。列表出现条目只说明客户端读到了配置,不代表服务器已经连通。订阅地址属于客户端的管理数据,不是内核的 JSON 字段。下面的 SOCKS 入站是启动内核后给本机应用使用的代理入口,与远端订阅地址是两回事。应用手动填写代理时,应读取当前设置中的端口。

{
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks"
    }
  ]
}

查看 JSON 手册

02 安装入口

按系统选择客户端

先确定运行设备的系统,再看处理器架构。桌面设备选 v2rayN;移动设备在 v2rayNG 与 v2flyNG 之间按配置要求选择。

v2rayN 这组入口提供 x64 桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留经典界面;两者是不同的图形程序,不是两套节点协议。先打开系统的「关于」页面,查看系统类型,确认能运行对应架构的程序。

如果从旧装迁移,先退出原来的实例,再启动新程序。同一台机器上的两个客户端若使用相同的本地监听端口,后启动的一方可能报端口占用。切换之后也要检查系统代理仍指向当前程序实际监听的地址和端口。遇到启动失败,先分清是界面程序未运行,还是界面打开后内核启动失败,再查对应的错误提示。

在系统的「关于本机」中查看芯片或处理器信息。显示 Apple 芯片的设备选 Apple Silicon 对应的 arm64 安装包,显示 Intel 处理器的设备选 x64。两个入口是处理器架构的区别,不需要按订阅协议挑选,也不应根据设备外观判断。

打开磁盘映像后,将应用移到「应用程序」再启动,便于之后从固定位置打开。首次测试可先用一个读取系统代理的浏览器,避免同时切换多个网络选项。无线网络与有线网络的代理设置可能属于不同网络服务;如果换网络后行为变化,要在当前使用的网络服务里核对设置,而不是先重新导入订阅。

多数近年的设备可选 arm64 包,前提是系统支持运行该架构的应用;不确定时可看通用包。通用包通常打包了多套架构的原生库;它仍须满足客户端自身的系统要求。v2rayNG 采用 Xray 内核,需要对照 V2Fly 行为时再选 v2flyNG。

首次使用 VPN 模式时,系统会要求确认连接权限。若设备已有另一个应用建立 VPN,先检查两者是否冲突。连接建立后,如果某个应用表现不同,先检查客户端是否启用了按应用筛选,再看它是否在纳入或排除列表中。此时安装架构通常不是排查重点;架构问题主要出现在安装或加载原生库的阶段。

先按发行版选包格式,再按设备选架构。采用 Debian 软件包体系的发行版通常选 deb,采用 RPM 软件包体系的发行版通常选 rpm。两种格式都有 x64 与 arm64 的对应入口;包格式正确并不意味着架构也正确,两项需要分别核对。

如果包管理器报告缺少依赖或不兼容,先记录软件包给出的提示,在安装阶段解决问题,再打开 v2rayN。启动后,桌面应用是否读取系统代理取决于桌面环境和应用本身。若浏览器可用而终端不可用,可单独检查终端工具的代理参数或环境配置,不要把终端未走代理误判为安装失败。

查看全部客户端

03 首次配置

导入、分流与连接验证

第一次只验证一个节点、一套路由和一个应用。先确认基本链路,再打开其他接入方式或调整 DNS。

  1. 01 数据来源

    导入订阅

    拿到订阅地址后,在订阅分组中添加一条记录并保存,随后主动更新该分组。保存地址与拉取条目是两步;如果列表仍为空,先确认选中的是刚添加的分组,再查看更新结果。只有一条节点分享链接时,使用对应的单节点导入入口。

    导入后先选一条协议和传输参数明确的记录。若更新报错,检查地址有没有被截断或附上多余空格;若更新成功但只少了个别节点,重点检查这些节点的格式是否受客户端支持。分享排查截图时,隐藏订阅地址、账户字段和节点凭据。

  2. 02 出站规则

    选择路由模式

    先明确哪些访问需要直连,哪些请求应交给代理节点。使用客户端的预设规则时,先确认实际选中了哪一套,并检查直连与代理目标的匹配条件。办公网或局域网服务可作为直连样本,代理侧则选一个稳定、已知可访问的目标。

    系统代理开关决定一部分应用会不会把流量交到本地入口,路由模式决定内核拿到连接后发往哪里。两项设置互不替代。如果局域网访问在改规则后发生变化,留着原节点不动,单独切回原来的规则测试,便于判断是条件匹配变了,还是应用根本换了入口。

  3. 03 实际请求

    连接并验证

    桌面端选择节点并确认内核监听就绪,再按需启用系统代理;移动端则在选择节点后建立 VPN 连接并确认系统授权。用实际应用分别访问直连样本和代理样本,同时查看客户端日志是否出现对应请求。列表延迟和连接状态不能替代这一步。

    如果两个样本都失败,先查本地入口或 VPN 状态;只有代理样本失败时,再查节点、路由命中和远端握手。浏览器成功后若还要使用命令行,再用目标工具单独测试。退出客户端前可先关闭或清除系统代理,避免其他程序继续连接已经停止的本地端口。

查看完整教程

04 开源生态

Project V、V2Fly 与 Xray

先区分界面、内核和协议。客户端名称用于选择软件,协议和传输设置用于判断连接兼容性。

客户端
管理订阅和节点,生成或加载配置
内核
读取配置,处理解析、路由与转发
协议
规定连接两端如何交换数据

查看项目介绍

  1. Project V 与客户端分工

    Project V 是理解早期 V2Ray 项目的起点。V2Ray 把流量入口、转发出口和匹配规则分开定义:同一个入站收到的不同请求,可以被路由到不同的出站。这样的结构适合把接收流量和决定流量去向分开检查,也为不同图形客户端提供了共同的配置概念。

    v2rayN、v2rayNG 与 v2flyNG 是开源图形客户端,分别提供节点管理、配置和启动入口。桌面客户端的界面设置不等同于内核文件;移动端的 VPN 授权也是系统行为。查资料时,先判断问题发生在界面、操作系统还是内核。比如软件界面能正常打开并不说明内核已经监听,而系统授予 VPN 权限也不代表远端握手一定成功。

  2. V2Fly 与 Xray 的共同语法和差异

    V2Fly 社区延续 V2Ray 内核的维护,Xray 则从 V2Ray 代码分支发展。两者在入站、出站和许多路由字段上保留相似概念,各自也有独立实现。读到同名字段时,还需核对当前内核的支持范围;特别是较新的传输和安全选项,不能把一套配置的参数直接套到另一套上。

    选型时,先确认节点参数要求,再看客户端能调用哪个内核。若某条配置在旧环境可用,在新环境报未知字段或不支持的选项,先从日志摘出字段名,再判断是客户端没有生成正确参数,还是目标内核不识别。用不含敏感信息的精简配置核对,比反复重装更容易定位问题。常见名称可在内核术语中对照。

  3. 协议、传输与安全层应分别核对

    VMess、VLESS 和 Trojan 都能在这个生态中见到,但认证方式、连接参数和安全层的要求不同。协议一栏与传输一栏描述的是不同维度:客户端能识别某个协议,并不意味着它支持该节点使用的每一种传输组合。远端地址和端口都正确时,传输参数或服务器名称不一致仍可能让连接失败。

    例如,VLESS 本身不提供内容加密,阅读相关配置时应另看实际使用的安全层,不能只从协议名称推断链路特性。客户端和内核的代码开源,也不意味着通过软件导入的第三方节点由这些项目运营。软件来源、连接设置和节点运营方需要分别判断。各术语的具体含义见协议速查。

  4. 客户端、内核与订阅的更新各有边界

    客户端更新可能调整界面或配置生成方式,内核更新可能影响可用字段,订阅更新则刷新分组中的节点列表。三者不必同时更新。排查近期变化时,先记下症状从哪一步开始:软件升级后无法启动,应看内核日志;更新订阅后只有某个节点失效,应先核对该节点的新参数。

    手工管理规则时,可记录当前使用的路由配置、关键标签与本地端口,便于变更后比对。先用一条已知可用的记录验证代理入口和远端连接,再逐项恢复自定义路由与解析设置。如果需要迁移订阅和自定义配置,含有凭据的资料应保留在受控位置;提交故障记录时通常只需提供错误类别和相关字段名。

  5. 按错误发生的位置查资料

    订阅列表为空,就从导入入口、分组和更新报错查起;列表正常但所有应用都无法访问,就看内核是否启动、端口是否监听,及应用是否把请求送进本地入口。只有部分目标失败时,再看规则命中、域名解析或远端连接。这个顺序能避免用换节点解决本地接入问题,也能避免在节点已失效时不停改系统代理。

    查界面操作时用入门指南,需要理解字段取值和结构时用JSON 手册。手册里的入站和出站片段只覆盖示例所讨论的部分;与已有配置合并时,先检查同名标签引用和默认出站顺序,再用实际请求验证。

05 使用心得

安装、代理模式与节点选择

从当前遇到的问题选读:先确定能否启动客户端,再看请求是否进入内核,最后再比较节点表现。

查看全部文章