各平台安装包命名和说明见 官方 Wiki。
下面是我实际下载安装时总结的几点,不是官方文档,但应该能少踩几个坑。
文件名带 windows-64,解压到纯英文路径,比如 D:\Tools\v2rayN。别放桌面「新建文件夹」那种中文路径,以前遇到过 core 启动报错。
Release 页如果同时有 .zip 和 .exe:想绿色便携选 zip;要给不太会折腾的人装,exe 更直观。ARM 笔记本(少数)找 windows-arm64,和普通 x64 不通用。
点击左上角苹果图标 → 关于本机,看是「Intel」还是「Apple M 系列」。Intel 下 macos-64,M 芯片下 macos-arm64,下反了能打开但性能差或者直接闪退。
DMG 拖进应用程序文件夹;ZIP 解压后终端执行 chmod +x v2rayN && ./v2rayN。Gatekeeper 拦的话:xattr -cr /Applications/v2rayN.app(路径按实际改)。
| 发行版 | 我用的格式 | 安装方式 |
|---|---|---|
| Ubuntu / Debian / Mint | .deb | sudo dpkg -i v2rayN-*.deb |
| Fedora / CentOS Stream | .rpm | sudo rpm -i v2rayN-*.rpm |
| Arch / 其他 | .zip 便携版 | 解压 + chmod +x |
不确定架构时在终端跑 uname -m:输出 x86_64 选 amd64/x64,aarch64 选 arm64。
每次换机或重装,我按这个顺序过一遍,比出了问题再排查省时间:
URL 是 github.com/2dust/v2rayN/releases,不是搜索引擎广告里的「高速下载」。
打开软件 → 检查更新 → Core 文件。没这步,界面能开但连不上。
拷走旧目录里的 guiConfigs 或导出的 json,换机时直接覆盖。
订阅更新完 Ctrl+R 测速,挑一个节点试开网页,再设开机自启。
不能。那是 C# 源码,得自己编译。要跑程序找名字里带 windows / macos / linux 的 Assets。
With-Core 把 Xray/sing-box 打进去了,体积大,适合 GitHub 访问慢、首次下 Core 老失败的情况。普通包小,Core 靠软件内更新拉。
代理类 core 文件误报常见。只从官方 GitHub 下,对 v2rayN 目录加白名单。别去下「破解版」「免杀版」。
客户端可以跟 Release 走;Core 稳定就行,节点协议不支持了再升。geo 规则分流不对时单独更新 geosite.dat。