这篇教程解决什么问题?

你已经能照着 Ubuntu 或 Fedora 的图文把 Clash Meta(Mihomo)跑在别的发行版上,一换到 Debian 12,却开始遇到「浏览器能出墙、终端还在直连」或「TUN 一开就起不来」之类的问题。Debian 与衍生版在包名、默认安全模块、无头与桌面的服务边界上和 Ubuntu 并不完全等价,直接照搬教程常会在缺依赖、无权限、自启没挂对单元上卡住。

本文做三件事:用 apt 把系统侧工具链和证书基础补齐,再落地Clash Meta + systemd 自启的固定目录与单元写法,最后按表排查TUN 模式下的漏流、断线以及常见「安装/启动期」报错。更泛化的 TUN 概念与多平台对比见《Clash TUN 模式完全指南》;Mihomo 配置迁移与核心差异可参考《Clash Meta(Mihomo)核心升级指南》。若你更熟 Ubuntu 的叙述,可先浏览《Ubuntu 安装 Clash Meta:systemd 自启与 TUN 逐步配置》,再回本文对 Debian 特有差异点。

Debian 12 上先用 apt 补齐什么?

Debian 12(bookworm)默认可直接装到较新的内核,一般已包含 TUN/转发所需能力,但「能跑 mihomo 二进制」与「能改路由、赋权、排障」仍是两件事。建议至少用 root 或 sudo 安装下列一类依赖(包名在稳定仓库中可用,具体以你镜像为准):

  • 路由与排障:iproute2 提供 ip / ss,排查策略路由、接口与规则;
  • 权限与可执行位:若用 setcap 给二进制挂能力,需 libcap2-bin;
  • 证书与下载:ca-certificates、curl 便于你验证订阅与直连;
  • 解析辅助:dnsutils 或 bind9-dnsutils 便于做 dig / nslookup 对比。

你无需也不应在发行版里「apt 装一个叫 clash-meta 的万能包」替代官方渠道——Mihomo 在 Linux 上通常仍是自管二进制 + 工作目录。安装包请优先用本站下载页取得与文档一致的版本;若你核对协议或要自行编译,可另行访问上游仓库,但请不要把 GitHub Release 当作新手首下载入口,避免版本与教程脱节。

Debian 默认倾向于「稳定、少惊喜」,因此与你习惯的 Fedora dnf+SELinux 或 Arch 滚更相比,安全模块与网络栈的默认行为更保守;遇到权限被拒绝时,先查 systemd 的 capability、再查 AppArmor 配置,而不是反复换节点。

安装二进制、目录与最小可跑配置

在 Debian 上建议一机一主路径:例如把可执行文件放到 /usr/local/bin/mihomo 或 ~/.local/bin/mihomo,把配置、Geo 数据与规则缓存放在 /etc/mihomo 或 ~/.config/mihomo。目录一旦混用,systemd 里写的 -d 和你在终端手敲的路径就会打架,自启后读到的不是你以为的那份 config.yaml。

先保持不开 TUN,只用 mixed 端口或独立 HTTP/SOCKS 做本机回环与 curl -x 冒烟;确认日志无致命错误、规则能命中,再开 TUN。若端口模式都不稳定,先处理 YAML、DNS 与策略组,否则打开 TUN 只会把问题模糊成「路由全乱了」。规则编写与顺序可对照《零基础入门:如何为 Clash 编写自定义分流规则》。

systemd 自启:单元怎么写才「Debian 友好」?

Debian 12 的默认引导已是 systemd。桌面用户常选用户级 ~/.config/systemd/user/,用 systemctl --user enable --now mihomo.service;VPS 或无头机常用系统级 /etc/systemd/system/,在联网就绪后再起服务。下面是一段示意骨架,路径与账户请替换为实际环境,注释保持英文以方便复制:

[Unit]
Description=Mihomo (Clash Meta) on Debian
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/usr/local/bin/mihomo -d /etc/mihomo
Restart=on-failure
RestartSec=3

[Install]
WantedBy=multi-user.target

改单元后执行 systemctl daemon-reload。若 TUN 需要能力,在 [Service] 中按需加入 AmbientCapabilities=CAP_NET_ADMIN 等与发行版安全策略匹配的组合,以 journalctl -u mihomo 的报错为据,而不是复制网上「万能单元」。用户级自启在纯 SSH 无图形会话上可能不自动启动,与 linger、登录会话相关,和 Ubuntu 的坑类似;服务器场景优先系统级与专用账户。

需要对比 RPM 系服务写法与 SELinux/防火墙时,可交叉阅读《Fedora 工作站装 Clash Meta:dnf、systemd 与 TUN 实测配置步骤》;AUR/滚更环境则看《Arch Linux 用 AUR 装 Clash Meta》,用来理解差异而非照抄包管理命令。

启用 TUN 模式:权限、模块与「漏流」的第一道闸

在 config.yaml 打开 tun.enable 后,Mihomo 要在 Linux 上创建虚拟接口并参与策略路由,通常需要 CAP_NET_ADMIN 等级别的网络管理能力,并依赖 ip 能正常改表。可先用 lsmod | grep tun 粗查(多数 bookworm 内核上 tun 为常见路径);若你自行裁剪过内核,需确认 TUN 支持未被去掉。

YAML 侧常见起点(需与你的 DNS、入站、策略组一致,勿整段照抄到生产环境):

tun:
  enable: true
  stack: system
  auto-route: true
  auto-detect-interface: true

若日志出现创建失败、改路由失败,先核对服务用户是否有能力、是否被 AppArmor/安全加固拦截,再查是否与本机其他 VPN/容器/NetworkManager 插件抢同一张表。gvisor 与 system 栈在延迟与兼容上各有利弊,换栈应作为有对照的实验,且一次只动一项。

「能连上但漏流」和「常断线」怎么对照查?

这两类是搜索里最高频的困惑,但成因层级不同。建议用下面这张分诊思路,从左到右只推进一层,避免把节点质量、TUN 未接管、规则漏写和 DNS 污染搅成一团。

现象 优先核对的层级 在 Debian 上可执行的线索
浏览器快、apt/git 慢或直连 未走 TUN 或只开了 HTTP 端口 看进程是否经内核路由、终端 env | grep -i proxy 是否为空;必要时显式为 shell 设代理变量
部分域正常、部分总解析失败 DNS 与 fake-ip 链 用 dig 与核心日志对比;关注 DNS 被劫持、分流顺序是否在 GEOIP 前显式覆盖该域
长时间下载中途掉线 节点 UDP、时间同步、本机 keepalive 查 VPS 到上游 NAT、笔记本休眠;这类问题多与规则命中无关,但要与「稳定性」分栏记录
刚启用 TUN 就整机断网 默认路由/策略表冲突 看 ip rule 与 ip route 是否被多软件叠加;先停其它接管程序再单测

更细的「已连接却无网络」可对照《已连接但无网络?从日志、DNS 与规则顺序排查》,把 Clash 日志、系统 DNS 与规则命中三点对齐。漏流在本质上往往是「流量根本没进 TUN」或「进了但 DNS 在另一条轨」,先确认这一点,再调节点与协议。

常见「安装/启动期」报错与含义

将命令行与 journal 里的信息当成枚举表,会节省大量误重装时间:

  • 可执行无法运行、提示找不到动态库:多为架构错误(x86_64 与 arm64 混用)或 glibc 过旧。Debian stable 的 libc 以「稳」为主,应下载与当前系统架构匹配、且为官方在同类环境测试过的构建产物;
  • Permission denied 创建 TUN/改路由:回退到上文的 capability 与 systemd 用户;不要用「全程 root 跑桌面二进制」当长期解;
  • address already in use:previous 实例、docker 或别的代理仍占端口,先用 ss -lntp 看占用;
  • YAML parse error:缩进与全角字符;用校验工具在改 TUN 前先保证最小配置能启动。

无头服务器与桌面的补充注意

在 VPS 上请谨慎把管理端口或 mixed 口绑到 0.0.0.0,务必配合本机回环、SSH 隧道、防火墙与来源限制。Debian 上 nftables / iptables-legacy 与云厂商安全组是两层皮,TUN 改表后转发表也要放行,否则容易误判成「TUN 坏了」。笔记本场景注意休眠与 NetworkManager 对 DNS 的覆盖,和 Ubuntu GNOME 下的「代理与环境变量两轨」问题同源,可延续 Ubuntu 一节的拆层思路。完整文档与端口说明可参见《使用文档》。

小结

在 Debian 12 上跑 Clash Meta,并不是「和 Ubuntu 一模一样」的复制粘贴,而是把apt 依赖、二进制位置、systemd 生命周期、TUN 能力四层对齐。把 Clash TUN 模式当作路由层总闸,把 systemd 自启当作可预测的重启契约,把安装报错拆到架构、库、权限与配置四类,再对照漏流/断线表做分层验证,从 Fedora、Ubuntu 或 Arch 换机过来的经验才不会再被发行版细节绊住。

相比在多个渠道间来回找包,用本站统一下载页能显著降低「教程写着 A、机器却是 B」的隐形成本;Mihomo 在规则、DNS 与多模式组合上的可维护性,也让你在桌面与轻量服务器上都能用同一套思路迭代策略。

当你需要对比 Windows、macOS 或旁路由时,可继续读站内跨平台与网关类文章。若尚未在本站获取客户端,可直接从当前目录前往下载,再按本文顺序做一次自测。

→ 立即免费下载 Clash,开启流畅上网新体验

前往本站下载页获取客户端