Clash Verge Rev Linux 配置教程：装好后连不上先这样查
简答：先执行 uname -m 确认架构，再安装对应 DEB、RPM 或 AUR 包；启动后导入 Clash/Mihomo 配置并激活，先开系统代理，再用实际端口测试 curl，最后排查终端代理、DNS 与 TUN。
定义：Clash Verge Rev 是基于 Tauri 的 Linux 图形客户端，内置 Mihomo 内核，可管理 Clash/Mihomo 配置、系统代理和 TUN 虚拟网卡。
先确认架构，再选择 Linux 安装包
本文与 Clash Verge Rev 项目及其开发者无隶属关系，仅整理公开资料和可照做的 Linux 配置步骤。官方项目说明 Clash Verge Rev 是基于 Tauri 的图形客户端，并内置 Mihomo 内核；它是原 Clash Verge 的延续项目，不是同一个名称的旧版安装包。可先查看项目仓库说明。
先在终端执行以下命令，不需要另装工具：
uname -m
cat /etc/os-release
| 检查结果 | 常见对应文件名 | 优先安装方式 | 适用系统 |
|---|---|---|---|
x86_64 | x64、amd64、x86_64 | DEB 或 RPM | 多数 Intel、AMD 64 位电脑 |
aarch64 | arm64、aarch64 | DEB 或 RPM | 64 位 ARM 设备 |
armv7l | armv7、armhf、armhfp | 以发布页资产为准 | 32 位 ARM 设备 |
| 无桌面环境 | 不适合安装 GUI 包 | 改用 Mihomo 命令行程序 | 纯命令行服务器 |
截至 2026-10-24，官方 v2.5.8 发布页标记为 Latest，Linux 资产列出了 DEB 与 RPM，并分别显示 64 位、ARM64 和 ARMv7 选项。下载前仍应打开v2.5.8 Release 页面，核对页面是否有 Latest 标记以及 Assets 中的实际文件名；不要只根据本文示例文件名下载。
按发行版安装：DEB、RPM 与 AUR
Ubuntu、Debian、Linux Mint 等 Debian 系：下载实际 DEB 文件后进入所在目录。下面的文件名只是占位示例，必须替换为真实文件名。
cd ~/Downloadssudo apt install -y ./Clash.Verge_x.x.x_xxx.deb- 如果出现依赖错误，先执行
sudo apt update，再重复安装命令。 - 正常标准是 apt 没有以错误退出，并且应用菜单中可以启动 Clash Verge Rev。
官方安装文档给出的 Debian 系安装方式就是使用 apt install 安装本地 DEB，可查看官方文档《下载与安装》。
Fedora、RHEL、Rocky、AlmaLinux：下载与架构匹配的 RPM 文件，进入下载目录后执行：
sudo dnf install ./Clash.Verge-x.x.x-1.x86_64.rpm
其中 x86_64.rpm 只是示例；如果 uname -m 返回 aarch64 或 armv7l，应替换成发布页对应架构的文件名。openSUSE 可尝试：
sudo zypper install ./实际文件名.rpm
正常标准是包管理器完成安装且应用能从桌面菜单启动。官方文档同时列出 RPM 的 dnf/yum 安装方式，但不同发行版的依赖处理可能不同，因此不要把 Fedora 命令强行套用到 openSUSE。
Arch、Manjaro、SteamOS：官方文档给出的 yay 安装准备步骤如下，执行前确认系统已更新：
sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si
然后安装正式版：
yay -S clash-verge-rev-bin
官方文档也列出测试版包 clash-verge-rev-autobuild-bin，排查问题时不建议同时混用正式版和测试版。安装完成后，菜单中出现应用并能打开窗口，才算通过安装阶段。
Ubuntu 20.04：官方 Linux FAQ 明确提到需要额外安装 libwebkit2gtk 和 libjavascriptcoregtk，且依赖关系较复杂，建议升级到 Ubuntu 24.04。不要从其他发行版复制依赖命令；如果必须继续使用 20.04，应根据 apt 报出的缺失包逐项处理。来源：官方文档《Linux 常见问题》。
首次启动：导入配置、激活配置，再选节点
Clash Verge Rev 客户端本身不包含节点。你需要已有的 Clash/Mihomo 兼容订阅链接，或一个本地 YAML 配置文件。订阅链接属于敏感信息，不要粘贴到公开 issue、群聊或截图中。
- 打开客户端，进入配置或订阅页面。
- 远程订阅选择订阅链接导入或订阅链接配置，粘贴链接并保存。
- 等待配置下载完成，确认配置列表中出现新项目。
- 点击该配置进行激活，再进入代理页面选择策略组或节点。
- 先不要开启 TUN，先用系统代理做基础验证。
官方文档说明远程订阅支持订阅链接导入、订阅链接配置和 URL Schemes，本地配置支持新建配置文件导入与拖拽导入；如果出现 client error(Connect)，官方建议尝试其他导入方式。订阅链接配置仍失败时，文档提到可以勾选“允许无效证书（危险）”重试，但只应在确认订阅来源和风险后使用。来源：官方文档《订阅导入》。
没有节点时，可以先用下面的最小配置测试客户端是否能读取 YAML。它只包含直连策略，不提供任何节点：
mixed-port: 7890
mode: rule
proxies: []
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT
rules:
- MATCH,DIRECT
这是本地格式验证示例，不代表任何服务订阅。常见订阅链接可能直接返回 YAML，也可能返回编码后的配置文本；如果导入失败，可先在浏览器或命令行下载响应，确认内容是否为可识别的 Clash/Mihomo 配置，不要把订阅链接公开。
系统代理、终端代理与 TUN：按范围逐层开启
| 方式 | 主要覆盖对象 | 先做什么 | 如何判断 |
|---|---|---|---|
| 系统代理 | 读取桌面系统代理设置的浏览器和应用 | 激活配置、选节点、打开系统代理 | 浏览器访问测试页面正常 |
| 终端代理变量 | 读取 HTTP_PROXY、HTTPS_PROXY 的命令行工具 | 查看端口后手动 export | 显式代理 curl 返回 HTTP 响应 |
| TUN | 更多不读取系统代理的程序 | 先确认系统代理正常，再在界面开启 TUN | 出现 TUN 网卡或相关路由，日志无权限错误 |
官方快速入门说明，系统代理通过修改操作系统代理设置，TUN 则安装虚拟网卡以接管不支持系统代理的程序，例如部分命令行工具和游戏。来源：官方文档《快速入门》。
查看客户端代理端口：在 Clash Verge Rev 的设置页面查找端口或混合端口字段，记下实际运行值。不要默认使用 7890，因为端口可能被修改，也可能因端口冲突而变化。Linux 终端还可以用以下命令观察本机监听端口：
ss -lntp | grep -E '127.0.0.1|0.0.0.0'
ss 通常由 iproute2 提供；若没有该命令，先安装发行版对应的 iproute2。正常标准是能看到类似 127.0.0.1:7890 的监听项，并且端口与客户端设置页一致。若只看到其他程序的端口，不要把它当作代理端口。
为当前终端设置代理变量：将 7890 替换为客户端实际端口：
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export HTTP_PROXY="$http_proxy"
export HTTPS_PROXY="$https_proxy"
这只对当前终端会话生效。清除变量可执行：
unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY
如果你的客户端只开放 SOCKS 端口，应使用对应的 socks5h://127.0.0.1:端口 写法；端口和协议必须以客户端设置页实际显示为准。
验证清单：症状、命令、正常结果与下一步
| 症状或目标 | 可执行检查 | 正常结果 | 失败后先查哪里 |
|---|---|---|---|
| 配置是否真的激活 | 查看配置页的激活状态，再到代理页确认策略组和节点 | 当前配置有激活标记，策略组能显示节点 | 回到“导入配置、激活配置” |
| 代理端口是否监听 | ss -lntp | grep -E '127.0.0.1|0.0.0.0' | 看到与客户端设置一致的监听端口 | 检查内核是否启动、端口是否冲突 |
| 显式 HTTP 代理是否可用 | curl -x http://127.0.0.1:7890 -I https://example.com | 返回 HTTP 响应头而不是长时间超时 | 把 7890 换成实际端口，检查节点和内核 |
| 终端变量是否生效 | env | grep -i proxy | 能看到当前会话的代理变量 | 重新执行 export，或检查变量中的端口和协议 |
| Git 是否单独失败 | git -c http.proxy=http://127.0.0.1:7890 ls-remote https://github.com/git/git.git HEAD | 返回远程引用信息 | 确认 Git 代理协议、端口和证书错误 |
| apt 是否使用独立代理 | sudo apt -o Acquire::http::Proxy="http://127.0.0.1:7890" update | 能获取索引，或只出现软件源自身错误 | 检查端口、代理协议和软件源连接 |
| TUN 是否创建网卡 | ip addr | 启用 TUN 后能看到新增虚拟网卡或路由变化 | 查看客户端日志、服务模式和权限提示 |
| DNS 是否仍走原路径 | 在浏览器打开可信 DNS 泄漏检测页面，记录检测到的 DNS 服务商和地区 | 结果符合你的预期网络路径 | 检查 TUN、DNS 覆写、IPv6 与系统 DNS |
example.com 只是示例域名，不代表代理一定能访问所有目标。关键是使用 -x 显式指定客户端实际监听端口；直接执行普通 curl -I，不能证明请求经过 Clash。apt 也不会因为系统代理开关打开就自动采用同一设置，因此需要使用临时的 Acquire::http::Proxy 参数，或按需写入 apt 的独立配置。
验证顺序建议固定为：配置激活→端口监听→显式 curl→终端变量→Git/apt→TUN。前一步失败时不要跳到下一步。
常见 Linux 报错速查
| 现象 | 官方资料给出的处理方向 | 执行方式 |
|---|---|---|
| 纯命令行环境无法启动 | Clash Verge Rev 是 WebView 图形程序，需要桌面环境 | 改用 Mihomo 命令行程序，不要继续反复安装 GUI 包 |
| Ubuntu 20.04 依赖错误 | 需要 libwebkit2gtk 和 libjavascriptcoregtk，官方建议升级到 24.04 | 优先升级系统；继续使用时只按 apt 实际报错处理 |
| Error 71、framebuffer 或 GBM 报错 | 官方 FAQ 指向部分 NVIDIA + Wayland 环境 | 尝试 WEBKIT_DISABLE_DMABUF_RENDERER=1 后启动应用 |
| Failed to initialize GTK | 官方 FAQ 给出的环境变量值为 0 | 尝试 WEBKIT_DISABLE_DMABUF_RENDERER=0 后重新启动 |
| BadWindow | 可能是 XWayland 兼容层问题 | 尝试 GDK_BACKEND=x11 后重新启动 |
| GNOME 托盘不显示 | 当前公开 FAQ 未给出统一的 Linux 托盘修复步骤 | 先确认主窗口和代理功能正常，再检查桌面环境托盘扩展；未核实的第三方扩展不要直接安装 |
| TUN 权限错误 | 不能用一条命令覆盖所有发行版 | 先关闭 TUN，确认系统代理可用，再按客户端界面提示安装服务或授权，并查看日志 |
上述环境变量需要在启动程序前设置。可执行文件名可能因安装方式和桌面菜单启动器不同而变化，因此不建议直接假设名为 clash-verge。更稳妥的做法是从终端启动桌面菜单对应的程序，或在应用启动器属性中查看实际命令。Linux FAQ 原文可查看官方 Linux 常见问题页面。
常见问题
Clash Verge Rev 能在没有桌面的 Linux 服务器上运行吗？
不能直接运行。官方 Linux FAQ 说明它是需要 WebView 图形界面的 GUI 程序；无桌面环境应改用 Mihomo 命令行程序。
Ubuntu 应该下载 DEB 还是 RPM？
Ubuntu、Debian、Linux Mint 等 Debian 系优先下载 DEB，并使用 sudo apt install -y ./实际文件名.deb 安装；RPM 不应作为 Ubuntu 的首选包。
为什么普通 curl 测试不能证明代理生效？
普通 curl 默认不会自动读取 GNOME 或 KDE 的系统代理设置，且目标地址可能直连。应使用 curl -x http://127.0.0.1:实际端口 -I 目标地址，或先设置 http_proxy 和 https_proxy。
TUN 应该在安装后立即开启吗？
不建议。先确认配置已激活、端口在监听、显式 curl 正常，再开启 TUN；之后用 ip addr 和 ip route 查看是否出现虚拟网卡或路由变化，并检查客户端日志。
截至 2026-10-24 应该下载哪个版本？
官方 v2.5.8 Release 页面标记为 Latest。下载前仍应重新打开发布页，核对 Latest 标记和 Assets 文件名，因为版本与架构资产可能继续变化。
相关阅读
参考资料
- Clash Verge Rev 项目仓库
- Clash Verge Rev v2.5.8 Release
- Clash Verge Rev 官方文档：下载与安装（clashverge.dev）
- Clash Verge Rev 官方文档：快速入门（clashverge.dev）
- Clash Verge Rev 官方文档：订阅导入（clashverge.dev）
- Clash Verge Rev 官方文档：Linux 常见问题（clashverge.dev）