使用教程

v2rayN桌面端安装教程:Windows/Linux/macOS三步搞定

v2rayN 以 zip 压缩包形式发布,解压即用,无需安装向导。只要运行环境(.NET)就绪,三步即可完成:下载 → 解压 → 导入订阅。本文按 Windows、Linux、macOS 三平台分别说明,并附常见问题。

第一步:从官方渠道下载

所有版本仅通过官方 GitHub Releases 发布,请认准 github.com/2dust/v2rayN/releases,不设任何第三方下载站。按平台与架构选择对应文件:

  • Windows:v2rayN-windows-64.zip(x64)、v2rayN-windows-32.zip(x86)、v2rayN-windows-arm64.zip(ARM64)
  • macOS:v2rayN-macos-64.zip(Intel)、v2rayN-macos-arm64.zip(Apple Silicon)
  • Linux:v2rayN-linux-64.zip(x64)、v2rayN-linux-arm64.zip、v2rayN-linux-riscv64.zip、v2rayN-linux-loong64.zip

建议下载后先比对 Release 页面公布的 SHA-256 校验值,再解压运行,避免镜像站或运营商劫持。

第二步:准备运行环境并解压

  1. Windows:安装 .NET 8.0 Desktop Runtime(windowsdesktop-runtime),解压 zip 后双击运行 v2rayN.exe。
  2. macOS:解压后将 v2rayN.app 拖入"应用程序"目录,首次打开时若被 Gatekeeper 拦截,右键应用选择"打开"即可。Apple Silicon 与 Intel 分别下载对应版本。
  3. Linux:使用发行版包管理器安装 .NET 8 运行时(如 Ubuntu 可用 dotnet-sdk 或 runtime),解压后在终端执行目录内的 v2rayN 可执行文件。桌面环境需安装 libgtk 等依赖。

首次启动会自动创建配置目录(Windows 位于 %AppData%\v2rayN),后续订阅与设置均保存在本地。

第三步:导入订阅并连接

节点需要自行准备:v2rayN 只负责连接与管理,不内置任何节点。导入订阅链接即可批量添加节点。
  1. 打开 v2rayN,点击菜单"订阅分组 → 订阅分组设置"。
  2. 点击"添加",填写订阅链接(URL),保存并执行"更新订阅"。
  3. 节点列表自动同步,右键可测试延迟(TCPing),按延迟排序选择可用节点。
  4. 双击节点建立连接,系统代理默认开启,浏览器即可正常访问。

如需代理所有流量,可在"设置"中切换 TUN 模式;仅需部分应用走代理时,可在"路由"中自定义分流规则(参见《v2rayN路由规则与分流详解》)。

常见安装问题

运行报错"找不到运行时"怎么办?
Windows/Linux 需先安装 .NET 8 运行时。Windows 选择 windowsdesktop-runtime-8.0.x-win-x64,Linux 按发行版安装 dotnet 运行时包,完成后重启客户端。
macOS 提示"无法打开,因为无法验证开发者"?
右键 v2rayN.app 选择"打开",在弹出的对话框中点击"打开"即可;也可以在"系统设置-隐私与安全性"中允许运行。这是 macOS 对新下载应用的常规安全提示。
订阅更新失败或节点连接失败?
先确认订阅链接在浏览器中可访问,再检查系统时间是否准确(影响 TLS 与协议校验)。也可在"设置-内核设置"中切换 Xray 与 sing-box 内核后重试。

开始使用 v2rayN

免费开源 · 支持 Windows / Linux / macOS · 最新版 v7.24.4

立即下载
相关阅读

你可能还关心