fn_b/docs/content/tutorials/verge-linux.html

<link rel="stylesheet" href="/css/tutorials.css"><div class="tutorial-body"><p>这篇教程适用于带桌面环境的 Linux 电脑，以 Ubuntu / Debian 和 Fedora 为例，完成 Clash Verge Rev 安装、订阅导入与第一次连接。只有 SSH 终端的服务器不属于这里的使用场景：Clash Verge Rev 是图形客户端，需要桌面环境。</p><figure class="guide-diagram"><div class="diagram-label">Linux 安装前的三个条件</div><div class="guide-flow"><div><b>有桌面环境</b><small>能够打开图形应用</small></div><span>→</span><div><b>选对包格式</b><small>Debian 系用 DEB，Fedora 用 RPM</small></div><span>→</span><div><b>匹配 CPU 架构</b><small>x86_64 或 ARM 等</small></div></div><figcaption>图 1 · 包格式和 CPU 架构是两回事；安装失败时，先核对这两项。</figcaption></figure><nav class="guide-toc" aria-label="文章目录"><strong>阅读路线</strong><a href="#install">下载安装</a><a href="#import">导入订阅</a><a href="#connect">浏览器连接</a><a href="#terminal">终端代理</a><a href="#daily">日常使用</a><a href="#faq">常见问题</a></nav><h2 id="install">01　找到适合发行版和架构的安装包</h2><p>从<a href="https://github.com/clash-verge-rev/clash-verge-rev/releases/latest">Clash Verge Rev 官方发行页</a>下载正式版。在终端执行下面的只读命令，确认机器架构：</p><pre><code class="language-sh">uname -m&#10;</code></pre><table><thead><tr><th>输出 / 系统</th><th>下载时的选择</th></tr></thead><tbody><tr><td><code>x86_64</code>，Ubuntu / Debian</td><td><code>amd64.deb</code></td></tr><tr><td><code>aarch64</code>，Ubuntu / Debian</td><td><code>arm64.deb</code></td></tr><tr><td><code>x86_64</code>，Fedora</td><td><code>x86_64.rpm</code></td></tr><tr><td><code>aarch64</code>，Fedora</td><td><code>aarch64.rpm</code></td></tr></tbody></table><p><code>amd64</code> 也适用于使用同一架构的 Intel 处理器，不是“只能在 AMD 电脑上安装”。其他架构需要单独核对发行文件，不能只把下载文件改名。</p><p>以下以 <strong>v2.5.8、x86_64 电脑</strong>为例。在文件管理器中打开下载文件所在目录，再在该目录打开终端。使用较新版本时，将文件名换成实际下载的名字。</p><p>Ubuntu / Debian：</p><pre><code class="language-sh">sudo apt install ./Clash.Verge_2.5.8_amd64.deb&#10;</code></pre><p>Fedora：</p><pre><code class="language-sh">sudo dnf install ./Clash.Verge-2.5.8-1.x86_64.rpm&#10;</code></pre><p>只执行适合自己发行版的一条命令。前面的 <code>./</code> 表示安装当前目录里的文件；包管理器会尝试处理依赖，确认安装计划后再继续。完成后从应用菜单启动 Clash Verge Rev，正常使用时不必用 <code>sudo</code> 启动整个图形程序。</p><p>旧系统遇到 WebKit 等依赖缺失时，先查<a href="https://www.clashverge.dev/faq/linux.html">官方 Linux FAQ</a>和发行版支持情况。官方文档特别指出 Ubuntu 20.04 的依赖问题，并建议使用较新的系统；不要强行混入其他发行版的软件源来凑依赖。</p><h2 id="import">02　导入 Clash / Mihomo 免费订阅</h2><p>在本站<a href="/freenode">免费节点页面</a>打开较新的分享，复制其中的 <strong>Clash / Mihomo</strong> 订阅地址。回到客户端：</p><ol><li>进入“订阅”，粘贴链接并导入。</li><li>等待配置下载完成，选中这张订阅卡片。</li><li>进入“代理”，确认已出现代理组和节点。</li><li>使用规则模式，在处理代理流量的组内手动选择一条节点。</li></ol><p>订阅卡片已保存，不代表它已经成为当前配置。看不到节点时，先检查是否选中卡片、链接格式是否正确；普通文章网址、v2ray 订阅与 sing-box 配置不能直接当成 Clash 配置。</p><p>免费节点可能随时失效。延迟测试可帮助排除超时线路，但最终仍要打开实际需要的网站验证。</p><h2 id="connect">03　先让浏览器通过系统代理连接</h2><p>在客户端设置中开启 <strong>系统代理</strong>，先保持 TUN 关闭，然后重新发起浏览器访问。系统代理是否被应用采用，取决于桌面环境和应用本身；Firefox 等浏览器也可能设置了自己的代理选项，需要确认其使用系统代理或正确的手动代理。</p><p>同时打开客户端“连接”页面，观察刚才请求的域名、匹配规则与出口。规则模式可能让部分网站走 <code>DIRECT</code>，所以“网页打开了”不一定证明它经过了远端节点。</p><figure class="guide-diagram"><div class="diagram-label">浏览器能用，不代表终端自动跟随</div><div class="guide-flow"><div><b>桌面应用</b><small>是否读取桌面代理设置？</small></div><span>→</span><div><b>客户端本机端口</b><small>接收连接并按规则分流</small></div><span>→</span><div><b>远端节点或直连</b><small>在连接记录中核对</small></div></div><div class="guide-branch">命令行工具通常需要自己的代理参数或环境变量；TUN 则是另一种接管方式。</div><figcaption>图 2 · 系统代理、命令行代理和 TUN 是不同的流量入口，不能只看一个开关判断全部程序。</figcaption></figure><h2 id="terminal">04　需要终端访问时，先做一次单独验证</h2><p>在客户端设置中查看实际的 <strong>混合端口或 SOCKS 端口</strong>。以下命令只给这一条 curl 请求指定代理，不会替你修改终端启动文件或全局网络设置。</p><p>把命令里的 <code>PORT</code> 替换成刚才看到的数字，再运行：</p><pre><code class="language-sh">curl --noproxy "" --proxy socks5h://127.0.0.1:PORT https://example.com/&#10;</code></pre><p><code>127.0.0.1</code> 指当前电脑；<code>socks5h</code> 让 curl 把目标域名交给 SOCKS 代理处理；<code>--noproxy ""</code> 避免已有的绕过列表让这次请求跳过指定代理。客户端仍会根据自己的规则决定最终走节点还是直连。</p><p>成功返回示例网页，说明这一条请求能通过该本机代理入口完成。它不证明所有终端程序已经使用代理，也不证明所有 DNS 查询都被接管。验证需要的真实服务时，再替换目标网址，并结合客户端连接记录判断。</p><p>常用工具如 Git、包管理器和下载器各有自己的代理设置。只有确认需要长期使用后，再按对应工具文档配置；不要为了临时试一次，就把一组不明代理变量永久写入 shell 配置。</p><h2 id="daily">05　更新节点与停止使用</h2><table><thead><tr><th>情况</th><th>操作</th></tr></thead><tbody><tr><td>某一条节点超时</td><td>换其他节点，重新发起访问</td></tr><tr><td>一批节点都失效</td><td>刷新订阅，并回本站查看较新的免费资源</td></tr><tr><td>浏览器正常，某应用不通</td><td>检查该应用的代理设置，再判断是否需要TUN</td></tr><tr><td>暂时停用</td><td>关闭系统代理；已开启TUN时也关闭它，再退出客户端</td></tr><tr><td>退出后仍有应用报代理连接失败</td><td>检查该应用、桌面设置或shell环境是否残留已停止的本机代理地址</td></tr></tbody></table><h2 id="faq">06　按故障所在的环节排查</h2><p><strong>安装时找不到文件。</strong> 核对终端当前目录和完整文件名，尤其是版本号、大小写及 <code>.deb</code> / <code>.rpm</code> 后缀。不要把网页上的示例文件名直接套到不同版本。</p><p><strong>应用打不开、白屏或报 WebKit / GBM 错误。</strong> 先记录完整错误、发行版版本、显卡和 Wayland / X11 会话类型，再对照<a href="https://www.clashverge.dev/faq/linux.html">官方 Linux FAQ</a>。显示渲染错误与节点连接错误是不同问题，不需要通过反复换订阅处理。</p><p><strong>系统代理开启后，终端还是直连。</strong> 先用上一节的单条 curl 请求验证端口，再检查具体工具是否有自己的代理选项。桌面开关通常不会自动给所有 shell 进程设置代理变量。</p><p><strong>需要接管更多应用或检查 DNS。</strong> 完成基本连接后，再按客户端要求配置服务模式与TUN权限，并验证实际效果。DNS路径可继续看<a href="/a/mihomo-dns-leak.html">DNS 防泄漏配置与验证</a>，其中的片段需要结合Linux实际网络环境调整。</p><p>如果同样要在 Mac 上使用，可先看<a href="/a/m172.html#download">Mac 客户端下载指南</a>，再按对应平台步骤操作。</p><div class="guide-footnote">参考资料：<a href="https://www.clashverge.dev/install.html">安装文档</a>、<a href="https://www.clashverge.dev/guide/quickstart.html">快速入门</a>、<a href="https://curl.se/docs/manpage.html">curl官方手册</a>。</div></div>