誰需要這條路線:Debian 12 和 Ubuntu 教學哪裡不一樣
若你已能照 Ubuntu 上的 Clash Meta 與 systemd 教學完成二進位部署,換到 Debian 12(bookworm)仍可能感到「同樣指令卻在細節上差一截」:例如預設安裝的網路工具組合、systemd 的慣用路徑、以及雲端映像上是否內建額外強化。本文目的不是重複圖形用戶端安裝,而是補一條 從 apt 到 TUN、再到 systemd 自啟 的完整實作鏈,讓你與站內的 Fedora 工作站篇、Arch 與 AUR 篇 並列,形成 Linux 多發行版地圖上的 Debian 系缺口。
在開始前請確認:你擁有目標機器上的 sudo 或 root 能力、清楚代理合規邊界,並理解 TUN 會影響全系統路由與解析;若觀念尚未攤開,建議先讀 Clash TUN 模式介紹 再回來實作,會比較不會一開 TUN 就全機打結。
以 apt 補齊執行期依賴:比「能下載可執行檔」再多想一步
從官方或可信來源取得與 CPU 架構一致 的 Clash Meta(Mihomo)靜態或動態連結二進位後,請在 Debian 12 上至少確認下列幾件事:有完整的 根憑證以驗證 HTTPS 訂閱;有足夠的 時鐘(systemd-timesyncd 或 ntp 類服務)避免 TLS 在邊界情況下失敗;以及具備觀測與偵錯用的基本工具。以下指令為常見的「最小加值」示範,實際選項以你的機房政策與精簡程度為準:
sudo apt update
sudo apt install -y ca-certificates curl iproute2 dnsutils
若你會用腳本或 iptables 語意除錯,可視需要再補 nftables/iptables 其中一邊的對應工具;Debian 12 預設的防火牆故事多半落在 nft 一側,但舊式文件仍常寫到 iptables 命名,兩邊的實體規則不要重複、互相覆蓋。若你打算在伺服器上長期讓 Clash 綁定低端埠,亦要同時顧及 CAP_NET_BIND_SERVICE 與實際執行身分,與 TUN 所需的 CAP_NET_ADMIN 一併寫入思維,不要只用「全給 root」一筆帶過。
核心模組與 /dev/net/tun:TUN 不是「有檔案就好」
在 Linux 上,TUN 裝置通常由 tun 相關核心能力提供。你在使用者空間看到 /dev/net/tun 存在,但行程仍回報 權限不足 時,常見原因包含:執行使用者不在對應群組、能力集沒有下發、或 AppArmor/SELinux 類的強化(在 Debian 桌面包較有機會出現針對自訂執行檔的額外輪廓)。建議的排查順序是:先用可重現的短命令觀察節點,而不是一次開滿 TUN 與所有規則集。
在乾淨的伺服器上,先確認 modprobe tun 不會在開機之後靜默失敗;若你使用雲廠商精簡核心,有時要檢查額外核心模組套件或是否誤刪了虛擬化場景下需要的介面。對於要長期讓非 root 帳號操作 TUN 的佈局,實務上常見的兩條路是:以 capabilities 下發到固定二進位,或以 被允許的群組+明確的裝置權限 管理;兩者都要搭配稽核,而不是在文件裡寫死某個 777 權限。
目錄約定、手工驗證、再談自啟
與 Ubuntu 那篇相同,我們仍採 先前台成功、再寫成守護 的節奏。建議的目錄分層包括:可替換的執行檔、受版本庫或備份保護的 config.yaml、與寫入快取/GeoIP/下載規則用的工作目錄。初次啟動時以示意命令替換實際路徑,並把完整輸出保留一段時間,讓 權限錯誤、DNS 名稱、訂閱位址、埠占用 都能一眼看見,而不是在 journalctl 裡撈碎片:
/opt/mihomo/mihomo -d /var/lib/mihomo -f /etc/mihomo/config.yaml
升級前後若行為有落差,可交叉比對 Mihomo 升級要點 與上游發行說明;Debian 的長支援週期常讓人「兩年內不碰機器」,但核心與上游參數預設仍會前進,靠備份+可重播的最小範本最能降低風險。
在開 TUN 前,讓 config.yaml 先站穩
在開啟 TUN 之前,請讓 本機 mixed/HTTP/SOCKS 埠與 最粗的基本規則 已可預測地命中。若一開始就同時疊 TUN 與 fake-ip,卻沒有釐清誰是「最後一哩的解析者」,在 Debian 上你會很常看見 瀏覽器偶發成功、curl 全失敗 或相反,因為兩邊的解析/快取路徑不同。先把 DNS 相關段落寫到「你能用自己的話轉述一遍」的程度,再開 TUN,會比較不會產生「明明連上節點,卻有半數流量沒走策略」的錯覺。
規則排序仍遵守「越明確越前面、MATCH 在後面」;TUN 會把多數本機程式的 IP 層行為交給核心處理,使任何誤命中的後果被放大。若你同時有桌面環境的「系統代理」面板、殼層的 http_proxy、與 TUN 三路並存,排查時要單一變因,不要一次改三個層次。
在 Debian 12 寫 systemd:使用者單元與系統單元的取捨
一般桌面/單一使用者常駐,使用者層級的 systemctl --user 較容易與家目錄內的設定檔一致;在無登入圖形介面、專用閘道或容器母機上,則可以選 系統層級 的單元,並搭配一個專用系統帳號。以下為結構性範本,實際欄位請改為你的路徑、帳號與能力政策(範例中的英數註解可保留在單元檔外,避免 parser 不預期的延伸):
[Unit]
Description=Mihomo (Clash Meta) on Debian
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=mihomo
Group=mihomo
ExecStart=/opt/mihomo/mihomo -d /var/lib/mihomo -f /etc/mihomo/config.yaml
Restart=on-failure
RestartSec=3
AmbientCapabilities=CAP_NET_ADMIN CAP_NET_BIND_SERVICE
CapabilityBoundingSet=CAP_NET_ADMIN CAP_NET_BIND_SERVICE
NoNewPrivileges=yes
[Install]
WantedBy=multi-user.target
寫好後依序 daemon-reload、enable --now,用 systemctl status 與 journalctl -u 單元名稱 -b 檢查;若出現 不斷重啟,優先讀日誌裡的結束原因與設定檔第一個錯誤行,再回退到「前台一鍵可跑」的基準。針對雲主機的網路熱拔插、或實體介面在開機階段尚未就緒,After=network-online.target 能降低競態,但不能取代「實測斷網重連後仍恢復」的驗收。
啟用 TUN:讓系統與 Clash 的路由、DNS 疊在正確的順序上
在設定檔中啟用 TUN 之後,請以三層合流的視角檢查:一層是 YAML 的 tun 區塊,一層是 作業系統是否允許建立與寫入路由,一層是 名稱解析 是否仍導向符合策略的 upstream。TUN 一旦建立,任何迴送 DNS 或 自我指涉的上游位址 都容易造成「斷續有網、長連結一直失敗」的現象;這類症狀常與 Clash 本身無關,而是主機解析鏈自洽性的問題。若你需要全面理解 fake-ip 與策略邊界,仍請以 TUN 專文 為觀念主架構。
Debian 桌面常見的 NetworkManager 與伺服器常見的靜態 netif 設定在「喚醒、重掛、切換有線與 Wi‑Fi」時會重寫路由;若你在這些事件後觀測到策略漏接,要優先看系統是否改寫了預設路由或 DNS 尾綴,而不是急著先把規則寫到上千行。對於以 Debian 作旁路閘道或家用伺服器的情境,亦請同步檢查轉送與路徑(ip rule、ip route 的變化),因為 TUN 只是其中一層,不是單一開關。
常見安裝與執行錯誤對照(精簡版)
權限與裝置類
看見 Operation not permitted 或 cannot open /dev/net/tun 時,依序想:執行身分、能力、裝置節點、以及安全強化。若你以前台 root 能跑、放進 systemd 卻失敗,多半是在單元檔的 User/Capability 組合上與實際需求不一致;此時要優先讓「最小權限集」在紙上畫出來,而不是反覆在社群貼上整份設定檔卻刪減敏感內容。
埠與位址佔用
address already in use 代表監聽埠衝突;在 Debian 上同時有別的代理、容器轉送、或舊的 Clash 行程殘留時很常出現。用 ss -lntp 一類工具找出占用者,再決定是改你的埠、還是移開對方。若你刻意與 docker 或 libvirt 併存,要同步檢查釋出埠的命名空間,否則表面上改了 YAML,實際仍被別層佔用。
DNS 與假 IP
症狀是「ping 8.8.8.8 正常、網站一直轉圈」或「只 HTTPS 有問題」,要先拆名稱解析;若同時用 fake-ip,請在切換 TUN 前畫出 本機 resolv 實際指向。Debian 上常見的 systemd-resolved 與手動的 /etc/resolv.conf 爭奪,會讓你以為「我改了 A」,其實開機還是「B 生效」。在不清楚誰是權威時,寧可先記錄現況、再做最小改動。若你正在對照全站關於「有連上卻無法上網」的說法,可延伸閱讀 有連上卻無法上網的排查,邏輯是相通的,只是從單一軟體放寬到作業系統層面。
「能連卻漏流、突然斷線」的逐步分診
當 測速或節點儀表板看起來正常,但實際應用卻有固定類型的流量不經核心,請依序自問:TUN 是否真的啟用?策略是否有更優先的 DIRECT 誤中?本機應用是否硬編碼了 IP 或內建 DNS?若只有特定程式漏接,幾乎永遠要回到「該程式的代理設定」與「是否忽略系統路由」兩點。若你是從 純埠代理 切到 TUN,記得在過渡期關掉殼層的 ALL_PROXY 測一次、再關 TUN 測一次,釐清兩路徑是否同時啟用;雙邊併用時的日誌最難讀,這是預期現象,不是單一參數能「神奇修好」。
若斷線偏週期性,觀察是否與 DHCP 租約、PPPoE 重撥、或雲內的網路重新配置同一時間軸。若斷在高併連或長下載,觀察節點的 UDP/TCP 行為、以及本機的連線表是否被打滿。這兩大類的修法完全不同;先用關聯性證據分桶,比急著到處加規剃更能縮小範圍。若你更在意旁路閘道、而非單機桌面,可再對照 OpenWrt 旁路與 TUN 相關章節 的風險敘事,兩邊的檢查表可以互相借用。
圖形用戶端與核心分工:何時要回到下載頁
本頁專注核心與系統層。若你其實想要「開箱圖形介面+內建編輯器」的體驗,也可以先看本站 用戶端下載頁 有彙整的選項,再把「真正跑策略的核心」與「哪個畫面在管設定檔」釐清;兩邊不衝突,但要選定一條權威來源,不要同一份檔在兩個管線裡被覆寫。需要概念索引時,使用說明與文件 仍是跨平台可對照的錨點。
結語:讓 Debian 12 的「可維運」變成可敘事的流程
在 Debian 上跑 Clash Meta 的關鍵,是把 apt 與核心假設、TUN 權限、systemd 觀測、DNS 實況 變成可以說出來的句子,而不是一串串複製的指令。你會犯錯的地方,幾乎永遠落在「兩層以為相同、實則沒有對齊」的縫裡。把可重播的最小實驗、與一張你能信賴的錯誤對照,放在同一目錄裡,通常比尋求更大的規剃集更划算。
相較於在論壇之間四處拼湊過期片段,把流程寫在固定位置、讓團隊成員都能讀得懂,是 Debian 與雲端長期佈署真正省時間的做法;若你重視圖形化與跨平台體驗、又不希望捨棄可稽核的設定檔,在開源生態中選擇文件清楚、釋出節奏穩定的產品路線,日常維運會可預測得多。