使用教程
v2rayN桌面端安装教程:Windows/Linux/macOS三步搞定
v2rayN中文社区 · 2026-07-20 · 阅读约8分钟
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 校验值,再解压运行,避免镜像站或运营商劫持。
第二步:准备运行环境并解压
- Windows:安装 .NET 8.0 Desktop Runtime(windowsdesktop-runtime),解压 zip 后双击运行 v2rayN.exe。
- macOS:解压后将 v2rayN.app 拖入"应用程序"目录,首次打开时若被 Gatekeeper 拦截,右键应用选择"打开"即可。Apple Silicon 与 Intel 分别下载对应版本。
- Linux:使用发行版包管理器安装 .NET 8 运行时(如 Ubuntu 可用 dotnet-sdk 或 runtime),解压后在终端执行目录内的 v2rayN 可执行文件。桌面环境需安装 libgtk 等依赖。
首次启动会自动创建配置目录(Windows 位于 %AppData%\v2rayN),后续订阅与设置均保存在本地。
第三步:导入订阅并连接
节点需要自行准备:v2rayN 只负责连接与管理,不内置任何节点。导入订阅链接即可批量添加节点。
- 打开 v2rayN,点击菜单"订阅分组 → 订阅分组设置"。
- 点击"添加",填写订阅链接(URL),保存并执行"更新订阅"。
- 节点列表自动同步,右键可测试延迟(TCPing),按延迟排序选择可用节点。
- 双击节点建立连接,系统代理默认开启,浏览器即可正常访问。
如需代理所有流量,可在"设置"中切换 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
立即下载