版本与包名以 v2rayN 官方发布页 为准。官方文件说明列出的支持版本为 Debian 12+、Ubuntu 22.04+、Fedora 36+ 和 Red Hat 9+;下文以 Debian / Ubuntu 与 Fedora 系列为例。
开始前:核对发行版和 CPU 架构#
- 打开系统设置里的 关于,确认发行版名称、版本和处理器架构。终端用户也可以运行
dpkg --print-architecture:amd64对应 Linux x64,arm64对应 Linux ARM64;Fedora 系列通常用uname -m查看x86_64或aarch64。 - Debian / Ubuntu 下载
.deb;Fedora / Red Hat 下载.rpm。不要把 macOS 的 ZIP、Windows 包或不同 CPU 架构的包混用。 - 如果发行版低于官方最低版本,先升级受支持的系统,避免在旧系统上强行安装依赖。
第一步:下载并安装#
- 打开 官方最新稳定版,展开 Assets,按上一步的发行版与架构选择
v2rayN-linux-64.deb、v2rayN-linux-arm64.deb,或相应的v2rayN-linux-rhel-x64.rpm/v2rayN-linux-rhel-arm64.rpm。 - 双击
.deb或.rpm,使用系统的软件安装器完成安装。若桌面环境没有图形安装器,官方支持在下载文件所在目录运行:
# Debian / Ubuntu x64;ARM64 将文件名替换为 v2rayN-linux-arm64.deb
sudo apt install -y ./v2rayN-linux-64.deb
- 从系统应用菜单启动 v2rayN。便携 ZIP 也可使用,但需先完整解压、给主程序执行权限,再以普通用户运行;首次使用建议先用系统安装包。
- 若系统提示缺少依赖,先记录错误并核对发行版是否受支持,不要从不明站点单独下载运行库。
第二步:添加订阅并选择节点#
- 在 v2rayN 中打开 订阅分组相关设置,新增分组,填写备注和完整的 HTTPS 订阅地址,保存后更新订阅。
- 等待节点出现在列表。列表为空时查看日志与更新结果,检查网络和 URL;不要把私人订阅粘贴到公开在线转换网站。
- 在节点列表选择一个活动配置,再使用客户端的系统代理功能。Linux 的桌面环境与软件包界面可能不同;如果看不到系统代理入口,先按 官方界面说明 定位同名功能,不要直接改全局网络配置。
- 打开浏览器访问常用网页及目标站点验证。系统代理通常只影响遵循桌面代理设置的应用;确实需要接管其他应用时,再按官方说明评估 TUN 权限。
- 使用结束后清除系统代理,再停止客户端。这样可避免客户端退出后桌面仍指向本机代理端口。
订阅表单、更新和日志判断可参考 v2rayN Windows 教程;Linux 包和系统代理的具体界面以本机桌面环境为准。
日常使用与进阶分流#
每次连接前后的检查#
- 更新订阅并确认列表中有可用节点,选中节点后再启动服务。
- 查看客户端的运行状态和核心日志,确认无启动错误;然后启用系统代理。
- 用浏览器分别打开一个直连网站和目标网站。GNOME、KDE 等桌面环境对系统代理设置的呈现不同,确认本机代理地址 / 端口已被桌面识别。
- 暂停使用时清除系统代理,再停止客户端。若某个桌面应用不读取系统代理,再查该应用的代理选项;确有需要时才评估 TUN 及权限要求。
域名分流与多节点选择#
v2rayN Linux 支持的路由能力取决于所选核心及发行包。可先使用客户端已有路由规则,再为单个域名设置代理或直连出口;把范围明确的规则放在通配规则之前,分别验证域名和普通网页。
若当前界面提供 多服务器优选延迟或负载均衡,只选择该核心明确支持的节点后再生成配置。优选延迟按探测结果选出口;负载均衡用于在多个连接间分配出口,不能将一个下载任务的带宽简单叠加。生成多服务器配置后再修改路由时,重新生成该配置以纳入新规则。操作逻辑可参考 v2rayN Windows 的分流与多节点步骤。
常见问题#
| 现象 | 先检查 |
|---|---|
| 软件中心拒绝安装 | .deb / .rpm 是否与发行版对应、架构是否正确、系统版本是否受支持 |
| 应用菜单里没有 v2rayN | 安装结果、桌面应用菜单刷新;也可按官方便携包说明运行 |
| 客户端能运行但浏览器不通 | 活动节点、客户端日志、系统代理是否生效、浏览器是否使用系统代理 |
| 关闭客户端后网络异常 | 清除系统代理并确认没有残留本地代理地址 |
| 需要 TUN | 先看官方权限与依赖说明;启用后逐项测试,不与其他 VPN 同时接管流量 |
| 客户端运行但桌面应用仍直连 | 检查桌面系统代理是否应用到当前会话;注销重登或重启该桌面应用后复测 |
| 某些应用正常、另一些不通 | 该应用可能不遵循系统代理;先查应用自身网络设置,再评估 TUN |
| 订阅更新超时 | 检查设备时间、网络可达性、完整 URL 与更新日志;切换网络后单独重试 |
| 分流规则不匹配 | 检查所用核心、规则顺序和域名格式,用一条小范围规则测试 |
| 多节点功能启动失败 | 检查是否混入不支持的协议节点、核心类型是否匹配,并从日志查看具体失败项 |