這篇適合誰:Docker 旁路由解決什麼痛點
如果你已在電腦或手機上使用 Clash 系工具,卻希望電視、遊戲主機、掃地機器人或監控攝影機這類「不好裝用戶端」的裝置,也能穩定走同一套路由策略,常見做法是在旁路由上長駐核心:主路由仍負責撥接與 NAT,旁路由只負責承接指定裝置的流量。相較於在 Ubuntu 上直跑二進位與 systemd(可參考本站Ubuntu 安裝 Clash Meta:systemd 與 TUN),Docker Clash 的優勢在於版本可鎖定、目錄掛載清楚、重裝系統時復原快,特別適合 NAS 與輕量小主機。
本文假設你理解家用區網的基本名詞(IP、閘道、DNS),並只在合規情境下使用代理工具。流程上會先釐清網段與旁路由位址,再談容器連接埠映射如何對應到 config.yaml 的監聽埠,最後才談透明代理與 TUN 在容器內是否值得開,避免一開始就把問題混進「映像檔版本」與「主路由防火牆」兩個維度裡難以排查。
第一步:畫出拓樸,固定「主路由/旁路由/裝置」三者的 IP
旁路由能否工作,核心不是 Docker 指令背得多熟,而是IP 是否衝突、閘道是否指對、回程路由是否成立。請先決定一個穩定的區網網段,例如 192.168.1.0/24,並約定:
- 主路由(WAN 出口):例如
192.168.1.1,負責 DHCP、Wi-Fi、以及對外連線。 - 旁路由(跑 Docker 的那臺機器):使用固定 IP,例如
192.168.1.10,不要讓 DHCP 隨機改變它,否則電視與遊戲機昨天能連、今天全掛。 - 要走路由策略的裝置:要嘛在 DHCP 裡為它們保留位址,要嘛手動設定靜態 IP,並把預設閘道改成旁路由位址。
實務上請避免「旁路由自己又當 DHCP 伺服器卻與主路由搶同一個網段」這種新手地雷;除非你非常清楚二層交換與多 DHCP 的風險,否則建議維持單一 DHCP 在主路由,只把特定裝置的閘道指到旁路由即可。這樣也最利於你在路由器後台快速看出「哪些裝置正在走旁網關」。
第二步:選 Docker 網路模式:bridge 對應埠,或 host 與核心同視角
大多數教學會用 bridge 模式跑容器,然後用 -p 或 Compose 的 ports: 把容器內埠映射到宿主。此時「你在區網其他裝置上連的 IP」永遠是旁路由宿主 IP(例如 192.168.1.10),而「容器內 Clash 監聽的埠」則透過映射對外暴露,例如把容器的 7890 映到宿主的 7890。
另一條路是使用 host 網路模式(在 Compose 中常寫 network_mode: host),讓核心直接綁在宿主網路命名空間上。好處是少一層 NAT 與埠映射的心智負擔,壞處是與宿主共用埠、隔離較弱,且不同 NAS 平台對 host 模式支援度不一。若你追求「區網裝置只要指閘道,HTTP/SOCKS 埠行為與本機直跑一致」,host 模式常更直覺;若你習慣把服務關在橋接網路裡,bridge 則較符合容器思維。
無論選哪一種,請在 config.yaml 內確認 mixed-port/port/socks-port 與你對外暴露的埠一致;並記得外部控制面板或 API 埠若開在區網可存取範圍,務必加上存取控制,避免被區網內其他裝置誤觸或惡意呼叫。
第三步:端口映射對照表:從設定檔到路由器與 NAS 防火牆
以下是一個「先能連、再談分流」的最小對照思維:① 容器內核心監聽 7890(mixed)與 1053(DNS,示意);② bridge 模式將 7890:7890、1053:1053/udp 映射到宿主;③ 區網裝置把 HTTP 代理指到 192.168.1.10:7890,或僅把 DNS 指到 192.168.1.10(視你的策略而定)。數字請完全依你的設定檔替換,重點是三處要同一份真值:設定檔、Compose、以及你在電視/遊戲機上填的位址。
若你使用 Synology、QNAP 等 NAS,除了 Docker 映射,還可能在「套件防火牆」或「路由器防火牆」多一層規則。排查順序建議是:先在旁路由宿主本機用 curl 或瀏覽器確認本機埠可連,再在另一臺區網電腦用同樣方式連宿主 IP,最後才換電視遙控器輸入。這種二分法能快速分辨是「核心沒起來」還是「跨裝置被擋」。以下為概念範例(請依平台調整):
# docker-compose excerpt — replace image and paths
services:
clash:
image: your-mihomo-or-clash-image:tag
restart: unless-stopped
network_mode: bridge
ports:
- "7890:7890/tcp"
- "7891:7891/tcp"
- "1053:1053/udp"
volumes:
- ./config:/root/.config/mihomo
cap_add:
- NET_ADMIN
devices:
- /dev/net/tun
範例中的 cap_add 與 /dev/net/tun 是為了後續若你啟用 TUN/透明代理時不必再改容器宣告;若確定只用本機埠代理,可視平台安全政策精簡,但請一次記錄你的取捨,避免三個月後「為何別人能開 TUN 我不行」卻找不到差異。
第四步:把區網閘道設到旁路由:手動、DHCP 保留與分裝置策略
讓電視與遊戲機走旁路網關,本質上是把預設閘道從 192.168.1.1 改成 192.168.1.10(沿用前文示例)。做法有三種常見層級:① 在單一裝置上手動靜態 IP;② 在主路由 DHCP 為該裝置 MAC 綁定 IP,並用DHCP Option(若路由器支援)下發閘道;③ 乾脆讓該裝置使用自動取得,但把 DNS 指到旁路由,再配合策略路由——最後一種較進階,故障時也較難向家人解釋。
對遊戲機與電視這類封閉系統,通常只能做到「手動 IP+閘道+ DNS」三欄位;請把 DNS 一併規劃好,否則會出現「YouTube 開得起來、區網 NAS 打不開」這類解析路徑不一致的現象。若你使用 fake-ip 或核心內 DNS 模式,請先閱讀本站Clash TUN 模式完全指南中關於 DNS 與路由協同的段落,再把同樣原則搬進 Docker 場景,而不是照抄某個映像檔預設值。
第五步:透明代理與 TUN:在容器裡要不要開
透明代理的目標,是讓不支援代理設定的裝置也能把流量交給核心;TUN則是透過虛擬介面讓系統層流量進入使用者空間的核心做策略。兩者在 Linux 上都很強大,但在 Docker 內會多遇到權限、核心模組、宿主網路命名空間三個變因。
實測建議採「由淺入深」:先用明確的 HTTP/SOCKS 埠讓單一裝置可連,確認規則與節點穩定;再視需求開透明代理;最後才挑戰 TUN。若你在 bridge 模式下開 TUN,還要確認路由是否從宿主正確進入容器,這往往比本機直跑更難除錯。對多數旁路由需求,「裝置能設閘道+DNS」已可完成八成目標,其餘再交給進階模式。
第六步:實測檢查清單:電視、遊戲機與下載節點
① 在旁路由宿主確認容器健康(日誌無反覆重啟、訂閱可更新);② 在第二臺電腦對宿主 IP 與埠做連線測試;③ 在目標裝置上檢視 IP/閘道/DNS 是否為預期;④ 開啟串流或遊戲連線,觀察延遲與丟包是否與「直連主路由」差異過大——若差異大,先懷疑雙重 NAT 或 MTU,不一定是節點問題;⑤ 若只有特定遊戲無法連線,回到規則命中與 UDP/QUIC 是否誤走代理。
這張清單刻意與「一次改三個地方」的習慣相反:每完成一項再進下一項,你在隔週重開機或韌體更新後,也能用同一套路快速驗證。若你希望把規則維護與核心升級拆開管理,可延伸閱讀Clash Meta(Mihomo)核心升級指南,讓 Docker 映像檔與掛載目錄的邊界更清楚。更廣義的文件索引與情境說明,亦可對照本站使用說明與文件,把旁路由與桌面用戶端放在同一知識庫裡維護。
桌面與行動裝置:旁路由與官方用戶端的關係
旁路由解決的是「無法安裝 Clash 的裝置」;若你仍會在 Windows、macOS 或手機上使用圖形用戶端,建議把家用伺服器上的 Docker 核心視為「區網服務」,把隨身裝置視為另一條生命週期,兩邊的訂閱與規則可用同一套來源,但不要假設同一個埠對外暴露策略適用所有平台。欲集中取得各平台安裝包,請使用本站用戶端下載頁;原始碼與社群貢獻連結可另作參考,但下載與安裝仍以站內頁面為準。
結語:把「可驗證」寫進旁路由的日常運維
相較於一次性的腳本,Docker Clash 在旁路由場景能否長期穩定,多半取決於你是否把IP 規劃、連接埠映射、閘道與 DNS寫成可重現的步驟,而不是只記住某個映像檔名稱。當區網裝置能穩定指到旁網關,容器內的核心才真正成為「可觀測、可回滾」的服務,而不是神秘黑盒。
若你希望跨平台都有一致體驗,並在圖形介面與容器部署之間取得平衡,選擇文件完整、更新節奏穩定的 Clash 系工具,通常比四處拼湊過期教學更省時間;相比只解決單點連線問題,建立可審計的流程會讓代理設定真正經得起家人與自己的反覆驗證。