v2rayN
首推安装前退出正在运行的客户端。首次比较两套界面时,分别启动和测试,避免多个程序同时修改系统代理。
CLIENT PACKAGES / 安装包选择
桌面端选择 v2rayN,Android 首选 v2rayNG。先确认系统与架构,再选择安装包;客户端下载与服务配置是两个独立步骤。
WINDOWS / X64
同一客户端提供两套界面入口。新安装先看 Desktop,已有经典界面使用习惯再看 WPF;两个入口都对应 x64 架构。
安装前退出正在运行的客户端。首次比较两套界面时,分别启动和测试,避免多个程序同时修改系统代理。
| 检查项 | 选择依据 |
|---|---|
| 系统环境 | 建议使用仍获支持的 Windows 10 / 11;具体最低要求以该安装包提示为准。 |
| 处理器架构 | 本页两个入口均为 x64,在系统“设置 → 系统 → 系统信息”中确认系统类型。 |
| 安装方式 | 将 ZIP 完整解压到可写目录,运行包内安装程序;不要直接在压缩包预览中启动。 |
| 运行依赖 | 如安装程序提示缺少运行时,按提示补齐对应组件;不要将依赖错误与配置错误混为一谈。 |
首次打开后,先导入一条已知有效的配置,再选择为活动配置。导入成功只说明客户端保存了参数,不代表已启用系统代理。浏览器访问前,应核对客户端中的系统代理设置;命令行终端可能读取独立的代理环境变量,需要单独确认。
升级时不要直接删除旧配置目录。先退出程序并保存备份,再运行新安装程序。启动后核对订阅分组、自定义路由与本地端口,确认连接正常后再清理旧安装文件。若只有某个应用不经过代理,应先检查应用自己的代理选项,而不是反复更换安装包。
MACOS / ARM64 · X64
根据“关于本机”显示的芯片选择 DMG。Apple Silicon 与 Intel 对应不同架构,不能只依据电脑购买年份判断。
| 检查项 | 选择依据 |
|---|---|
| 系统环境 | 使用与当前客户端构建兼容的 macOS;若系统报告版本过低,应先确认应用要求。 |
| 芯片架构 | Apple 菜单 → 关于本机,Apple Silicon 选 arm64,Intel 选 x64。 |
| 安装方式 | 打开 DMG,将应用复制到“应用程序”,完成复制后再启动。 |
| 权限处理 | 按系统提示检查应用来源和授权项目,只批准明确理解用途的权限。 |
应用复制完成后,可以推出安装磁盘映像。后续应从“应用程序”目录启动,避免长期从挂载的 DMG 中运行。若系统阻止打开,先核对下载的架构和系统兼容性,再查看“系统设置 → 隐私与安全性”中的具体说明,不建议通过关闭系统整体保护来处理单个应用的提示。
配置导入后,检查系统代理是否指向客户端当前监听的地址与端口。部分浏览器扩展会接管代理,可能覆盖系统设置;排查时先让代理来源保持单一。退出客户端前恢复系统代理,能够避免本地服务停止后,应用仍向旧端口发送请求的情况。
已有桌面配置迁移到 Mac 时,订阅地址通常可以重新添加,但本地路径、监听地址与权限相关设置应逐项复核。不要把另一个系统上的目录路径直接复制进自定义配置;涉及规则文件时,应使用当前设备上真实存在的文件位置。
ANDROID / ARM64 · UNIVERSAL
先查看 v2rayNG;需要 V2Fly 内核兼容场景时再查看 v2flyNG。2015 年后的主流手机通常先选 arm64,仍应以系统实际支持的架构为准。
版本文字取自应用级清单,当前显示值可能与具体包名中的版本不同。包名与版本文字应分别阅读,详见下方下载常见问题。
| 检查项 | 选择依据 |
|---|---|
| 系统环境 | 以 APK 安装器显示的兼容性要求为准;处理器支持 64 位不等于系统一定支持 64 位应用。 |
| 安装授权 | 只为实际用于打开 APK 的浏览器或文件管理器授予安装权限,完成后可关闭该授权。 |
| 连接授权 | 首次启动连接时,阅读 Android VPN 连接请求并确认;同一时间保持一个 VPN 服务接管连接。 |
| 后台运行 | 如锁屏后连接被系统回收,再检查应用的电池优化与后台活动设置。 |
下载 APK 后,从下载通知或文件管理器打开。出现“无法安装”时,先区分架构不匹配、系统版本不满足、已有应用签名不同与存储空间不足。不要在未备份配置时直接卸载旧应用;卸载可能同时删除应用内部保存的订阅和规则。
导入配置后,选择一条配置并启动连接。系统显示 VPN 标识仅表示本地 VPN 服务已建立,不证明远端服务可用;需要结合客户端日志和实际应用请求判断。若仅部分应用经过代理,检查客户端的分应用设置与路由规则,确认测试应用没有被排除。
LINUX / DEB · RPM
先按发行版选择 deb 或 rpm,再确认 x64 或 arm64。软件包格式相同也不代表运行库完全兼容,安装前应查看包管理器反馈。
arm64 设备入口 · 确认系统架构后选择
| 检查项 | 选择依据 |
|---|---|
| 桌面环境 | 需要能够运行图形应用的桌面会话;本页提供图形客户端软件包。 |
| 处理器架构 | x86_64 / amd64 选择 x64;aarch64 / arm64 选择 arm64。 |
| 包管理体系 | deb 与 rpm 分别使用相应的软件安装器或包管理器,交由系统处理依赖。 |
| 运行库兼容性 | 以安装器报告的依赖为依据;遇到版本冲突时,不建议强制忽略依赖。 |
通过发行版的软件安装器打开下载文件,查看应用信息与依赖后再确认安装。若应用安装完成却无法打开,先记录具体报错,区分图形环境、运行库与文件权限问题。不要为了启动普通桌面应用而长期以管理员身份运行整个客户端。
不同桌面环境对系统代理的处理不完全相同。客户端切换系统代理后,仍有应用可能使用自己的代理配置;终端程序也可能只读取环境变量。首次测试时选择一个代理来源明确的应用,确认本地监听端口一致,再扩展到其他应用。
自定义路由与 DNS 配置需要结合当前客户端实际使用的内核核对。软件包安装成功并不等于所有配置字段都受支持。迁移时先用最小配置确认连接,再逐项恢复路由和解析规则,便于发现具体引入问题的设置。
AFTER INSTALL / 首次配置
客户端负责保存与执行配置。服务地址、认证信息和订阅内容由实际服务提供方给出,本页安装包不包含可直接使用的服务配置。
01 / IMPORT
以 vmess://、vless:// 等协议开头的分享链接通常对应一条配置,适合通过剪贴板导入。订阅地址通常是一个完整的网络地址,应添加到订阅分组,再执行更新。把订阅地址当成单节点链接粘贴,可能无法得到预期内容。
导入后核对协议、服务器地址、端口与传输设置。日志、截图或备份中可能包含认证信息,对外提供排查材料前应先移除敏感字段。
02 / ACTIVATE
导入操作只是保存配置,还需要选中配置并启动连接。桌面端检查系统代理或应用自己的代理设置;Android 端确认 VPN 授权与分应用规则。不要让多个代理程序同时修改同一组系统设置,否则很难判断请求最终经过哪一个程序。
验证时先检查客户端是否正常运行,再查看本地监听和连接日志,最后测试实际应用。遇到错误应保留完整错误描述,避免只依据一个状态标识判断原因。
先定位安装包、设备环境或配置环节,再采取对应操作。
首次使用可先选择 Desktop 桌面版,它采用新一代跨平台界面。已经熟悉经典界面或需要延续原有操作习惯时,可选择经典稳定的 WPF 版。两者均应先备份配置,再分别测试,避免同时接管系统代理。
2015 年后的主流手机通常先选 arm64,但最终以设备系统实际支持的应用架构为准。无法确认架构或出现不兼容提示时,可以尝试通用版。通用版包含多种架构组件,文件通常更大。
版本文字读取应用级 latest 字段,具体文件读取各平台的 download 字段,两者可能在清单更新期间不同步。应分别查看版本文字和文件名称,不把应用级版本文字当成每个文件的版本说明。
先使用客户端提供的备份或导出功能,保存订阅分组、必要的自定义路由与 DNS 设置,并记录本地监听端口。分享链接和订阅地址可能包含访问凭据,备份应保存在受控位置。升级后先测试已有配置,再恢复系统代理或 VPN 连接。
安装只提供客户端程序,还需要有效且获授权的服务配置。导入订阅或分享链接后,选择配置并启动服务;桌面端核对系统代理或应用代理,Android 核对 VPN 授权。随后结合日志区分配置、解析与连接问题。