Windows
v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留经典操作布局。首次安装时先查看系统要求,已有配置则先备份订阅分组与路由设置。
安装后先导入一个有效订阅,再选中服务器并设置系统代理。TUN 涉及额外权限和网络接口,不必在首次验证时同时开启;先确认基础代理可用,更容易区分配置错误与权限问题。
前往下载整理四平台客户端入口,说明订阅导入与路由分流的配置顺序。
v2rayN 静态界面示意。菜单名称与布局可能随客户端更新调整,指示灯与开关不代表本机连接状态。
CLIENT DIRECTORY
桌面端从 v2rayN 开始;Android 首选 v2rayNG,使用 V2Fly 内核配置时可考虑 v2flyNG。先核对系统与处理器架构,再进入对应下载入口。
v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留经典操作布局。首次安装时先查看系统要求,已有配置则先备份订阅分组与路由设置。
安装后先导入一个有效订阅,再选中服务器并设置系统代理。TUN 涉及额外权限和网络接口,不必在首次验证时同时开启;先确认基础代理可用,更容易区分配置错误与权限问题。
前往下载v2rayN 按 Apple Silicon 与 Intel 芯片提供安装入口。在系统的“关于本机”中查看芯片或处理器信息,按实际架构选择,而不是只根据电脑外观或购买年份判断。
把应用安装到合适位置后再运行。若系统出现安全提示,先确认下载来源及应用信息,再按系统设置中的提示处理。导入订阅后仍需选择代理模式;仅打开窗口并不会让全部应用自动使用代理。
前往下载v2rayNG 使用 Xray 内核,v2flyNG 使用 V2Fly 内核。主流较新的设备通常选择 arm64,架构不确定时可查看通用版。两款应用的协议能力与参数处理仍应以实际内核支持为准。
首次启动连接会请求系统 VPN 授权。授权仅是接管流量的前提,不代表远端服务器可用。若锁屏后断开,再检查后台运行、省电限制与分应用代理规则,避免把系统回收误判为订阅失效。
前往下载v2rayN 提供 deb 与 rpm 安装入口,并区分 x64 和 arm64。先确认发行版的软件包格式,再确认处理器架构;包格式一致并不意味着桌面依赖、权限策略和系统代理行为完全相同。
图形桌面的系统代理通常只影响遵循该设置的程序。终端工具、容器及自行维护代理配置的应用需要分别确认。启用 TUN 前应检查权限与现有虚拟网络,出现异常时先恢复原网络路径再排查。
前往下载客户端负责保存配置并调用内核,不等同于可用服务器。订阅是批量获取服务器参数的一种方式,其有效期、访问权限和格式由提供方决定。安装前准备好来源可信的订阅或完整配置,避免把“安装完成”当成“连接完成”。
首次使用只导入一个来源,选择一个服务器,以一种代理模式完成验证。成功后再增加订阅分组、自定义路由或 TUN。每次只改一个设置,并记录修改前后的现象,后续发生故障时才有明确的回退位置。
CONFIGURATION NOTES
图形客户端把常用配置组织为菜单;内核按照生成的配置处理流量。以下片段用于说明字段关系,不是可直接连接的完整配置。
订阅用于集中更新服务器参数,不是客户端登录账号。先在订阅分组中保存链接并命名,再执行更新;导入成功后仍需选中要使用的服务器。多个来源应分组保存,方便定位失效链接,也避免更新时混淆手动配置。遇到解析失败,先检查链接有效期、响应内容及格式支持,不要连续重装客户端。订阅通常携带访问凭据,分享日志或截图前应遮盖完整链接。下方为不可用的格式示例。
https://subscription.example.com/list?token=xxxx
路由按域名、目标地址、端口等条件选择出口,规则顺序会影响最终结果。把明确的例外放在较宽泛规则之前,并确认引用的出口标签已经定义。域名规则与地址规则依赖不同信息,修改 DNS 后也应重新检查命中情况。以下片段把私有地址交给直连出口,适合说明规则结构;它不是完整分流方案,也不包含全部 DNS 设置。导入他人规则前,应先确认内核支持的语法与规则资源。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}
系统代理把本地代理地址写入操作系统设置,主要影响遵循该设置的应用;TUN 则借助虚拟网络接口接管符合路由条件的流量,常需额外权限。两者不是连接质量的高低档位。排查时先选一种方式,避免叠加其他网络工具。下方展示本地 SOCKS 入站字段,端口是配置示例,并非所有安装的固定值。应用自行填写代理时,必须与客户端实际监听的地址、端口和协议保持一致。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
]
}
客户端负责编辑与管理,内核负责协议处理,切换内核不等于自动转换所有配置。先核对协议、传输方式与安全参数是否被目标内核支持,再检查生成配置和启动日志。桌面端可按客户端提供的选项选择内核;Android 两款客户端对应不同内核路线,不应把它们视作只换名称的同一应用。下方日志字段可帮助理解内核配置层,但无法单凭日志级别判断某个服务器是否兼容。
{
"log": {
"loglevel": "warning"
}
}
多平台同步在这里指迁移订阅或配置,不代表客户端带有内置云同步。订阅可以在不同设备分别导入,本地监听端口、系统代理、TUN 权限和分应用规则则应按平台重新设置。迁移前备份原配置,迁移后先更新订阅并测试单个服务器,再恢复路由。下方是可用来理解直连出口的配置片段;完整配置能否复用取决于内核与字段支持,不能只凭文件扩展名判断兼容性。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}
PROJECT / CORE / CLIENT
项目、内核和图形界面属于不同层次。分清这三层,有助于选择客户端,也能缩小配置失败时的排查范围。
PROJECT V
V2Ray 是 Project V 生态中的代理工具,围绕入站、出站、路由与传输等概念组织配置。日常所说的“V2Ray 客户端”往往指管理这些设置的图形应用,而不是单一内核程序。理解这个区别后,就能解释为什么同样一条订阅在不同应用里会呈现不同菜单,也能理解界面更新与协议能力更新为什么不一定同时发生。
服务器配置通常由协议、地址、端口、身份信息、传输方式和安全参数共同组成。只看到 VMess、VLESS 或其他协议名称,还不足以判断一条配置能否连接。传输层选项、服务端要求以及客户端实际调用的内核都需要对应。教程中的名词应作为核对参数的线索,而不是把某个协议名称当作速度或稳定性的保证。
V2FLY / XRAY
V2Fly 社区持续维护 V2Ray 相关实现;Xray 是从 V2Ray 发展出的另一条内核路线。两者共享一部分配置概念,也各自演进。教程中出现相似的 JSON 字段,不代表所有新增选项都能跨内核使用。导入失败、启动报错和运行后连接失败属于不同阶段,处理时应先识别实际内核,再对照该阶段的错误信息。
更换图形客户端时,优先迁移由双方支持的订阅或分享链接。直接复制整份自定义配置可能连同平台特有路径、资源文件引用和监听设置一起带入。遇到不兼容字段,应先保留原始配置并查清用途,避免删除报错字段后虽然能启动,却改变了原有路由或安全行为。内核选择的依据是配置需求,而不是名称更新与否。
OPEN SOURCE
v2rayN 是桌面端开源图形客户端,集中管理服务器、订阅分组、路由和内核调用。v2rayNG 是使用 Xray 内核的 Android 开源客户端;v2flyNG 则沿用 V2Fly 内核路线。三者提供的是配置与连接工具,服务器来源需要另行准备,订阅服务的可用性也不由图形界面决定。选择时先看平台,再看所需协议与设置是否支持。
V2Ray 与 Xray 内核采用 MPL-2.0 许可证;这三款图形客户端采用 GPL-3.0 许可证。许可证描述代码使用、修改与分发的条件,不等同于远端服务的使用条款,也不能替代对订阅来源的判断。客户端、内核及随包组件可能分别适用不同许可证,涉及再分发或修改时,应以相应项目随附的许可证文本为准。
开源意味着代码和协作过程可以被检查,并不意味着所有来源的安装文件、配置与订阅都具有相同可信度。涉及账号或订阅凭据的内容应保存在受控位置;公开求助时只提供必要的错误信息,并隐去身份字段、完整地址中的访问令牌以及其他能恢复订阅权限的内容。
MAINTENANCE
客户端更新可能调整界面、依赖环境、配置生成方式或随附内核。升级前保留订阅来源、自定义路由和重要本地设置,并阅读当前发布说明。升级后先验证启动与订阅更新,再验证系统代理或 TUN,最后检查自定义规则。一次更改多个环节会让故障难以归因,尤其是同时替换订阅、切换内核并调整 DNS 时。
内核升级也不能修复所有连接问题。过期订阅需要更新来源,系统时间错误需要先修正时间,权限不足需要处理系统授权,远端不可用则需要核对服务状态。保留可复现的测试条件比反复安装更有效:同一网络、同一服务器、同一目标应用,每次只调整一项,再记录日志变化。
READING PATH
RECENT NOTES
从本地网络、订阅分组和 Android 后台权限切入。先定位发生问题的环节,再决定是否修改配置。
按本地网络、系统代理与 TUN、客户端路由规则、内核日志、节点参数的顺序逐层排查,判断超时出在本机还是服务端。
阅读文章同时使用多家订阅时,用订阅分组隔离来源,配合别名关键词过滤、排序与批量测试,让服务器列表保持清晰。
阅读文章v2rayNG 依赖 Android VpnService 接管流量。梳理授权弹窗、厂商省电策略导致的后台断连,以及分应用代理的配置方式。
阅读文章