这篇教程适合谁?

你已经会在自己电脑上跑 Clash,但希望把代理能力搬到一台常开的 NAS、工控小主机或树莓派上,让电视盒子、游戏机、平板等不方便装客户端的设备,通过「改默认网关」的方式走同一套分流策略。Docker 能固化运行环境与目录挂载,升级与回滚也相对可控;本文聚焦Docker Clash、旁路由、端口映射、局域网网关这一条链路,不重复展开每一条规则怎么写。

若你更关心本机 TUN 接管与漏流原理,请先读《Clash TUN 模式完全指南》;若在物理机或虚拟机上用 systemd 直跑 Mihomo,可参考《Ubuntu 安装 Clash Meta:systemd 自启与 TUN 逐步配置》。三篇文章场景不同,可以互为补充。

拓扑与地址:先画清楚「谁才是网关」

旁路网关的典型结构是:主路由负责拨号或上联(例如地址 192.168.1.1),旁路机与主路由同网段,持有一个静态局域网 IP(例如 192.168.1.2),Clash 在该机上监听 HTTP/SOCKS 等端口;你希望「指定设备」把默认网关改成 192.168.1.2,DNS 也指向旁路机或你信任的递归地址,从而让流量先到达 Clash,再由规则决定直连或出站。

实施前请确认三件事:旁路机 IP 固定(DHCP 保留或静态分配)、主路由没有开启客户端隔离(AP/访客网络常默认隔离)、旁路机到主路由二层可达。若你的 NAS 同时有多张网卡或虚拟交换机,请避免把 Docker 桥接在错误的 bridge 上,否则映射端口再正确,局域网也访问不到。

为什么常用 Docker 部署旁路网关?

对家庭用户而言,Docker 的价值主要是依赖收敛与可重复:镜像里带好 libc、时区与工作目录,换机器只要挂载同一配置卷即可恢复。NAS 厂商面板往往也优先支持容器编排,比手工安装二进制更省心。代价是你要多理解一层网络命名空间:容器内的 127.0.0.1 与宿主机不是同一个概念,「端口映射」就是把宿主机网卡上的端口转发进容器。

请从官方或可信渠道获取镜像与标签说明,核对是否与 Mihomo(Clash Meta)内核版本匹配;日常客户端安装包与版本说明仍建议以本站下载页与文档为准,避免教程与二进制来源脱节。

Docker 网络:bridge 映射还是 host?

最常见的两种做法是:bridge + 端口发布(-p),或host 网络(--network host)。前者与 NAS 图形向导兼容性最好,端口一目了然;后者让容器直接共享宿主机协议栈,省去 NAT 层,有时能少踩一层「映射了但防火墙没放行」的坑,但端口冲突会直接暴露给宿主机,且不同平台对 host 模式支持略有差异。

若用 bridge,请记住:Clash 在容器内监听的地址若是 0.0.0.0,映射到宿主后,局域网设备应访问宿主机局域网 IP + 映射后的端口,而不是容器 IP(后者对局域网其他设备通常不可路由)。若你发现只有宿主机本机能通、其他设备不通,优先检查 NAS 防火墙、套件网络模式与「仅绑定 localhost」的误配置。

端口映射:建议预留哪些端口?

具体端口以你的 config.yaml 为准,下表给出 Mihomo 系常见默认值,便于你在 Docker 或 compose 里一次性写全端口映射行,并与路由器或防火墙放行策略对齐。

用途 配置键(示例) 典型端口 备注
混合入站(HTTP/SOCKS) mixed-port 或分设 port / socks-port 7890 等 局域网设备走系统代理或手动填 HTTP/SOCKS 时常用
外部控制器 / 面板 external-controller 9090 建议仅内网访问并加密钥;勿直接暴露公网
DNS 入站(若启用) dns.listen 53 或 1053 53 常需特权映射;家庭场景可用高位端口并在客户端填端口
若你把 DNS 监听在 1053 之类的高位端口,请在电视或路由器 DHCP 选项里填「完整 IP:端口」是否受支持;部分机顶盒只接受 53,需要宿主机上用 dnsmasq 或分流转发,本文不展开具体品牌固件操作。

config 侧:allow-lan、bind 与监听地址

要让局域网其他设备使用旁路机上的 Clash,核心开关通常是 allow-lan: true,并确保 bind-address 或等价选项不要锁死在 127.0.0.1。若配置里仍写着仅本地回环监听,端口映射再多,外部也无法建立连接。与此同时,不要把未加鉴权的面板端口暴露到公网;家庭网络也建议为 external-controller 设置密钥并限制访问来源。

规则与 DNS 段仍须遵循「先放行局域网与设备自身,再 MATCH」的习惯,避免旁路机或主路由管理地址被误送入代理策略。需要规模化维护规则集时,可延伸阅读《Rule Providers 进阶教程》。

「透明代理」预期:容器里跑 TUN 的现实边界

搜索透明代理时,很多人会联想到整网段无感转发:内核把流量重定向到本机代理进程。实现这一效果通常依赖 TUN、iptables/nft 或策略路由,且进程往往需要对宿主机网络栈有足够权限。Docker 默认隔离了网络命名空间,在容器内直接启用 TUN 并接管宿主机全局路由,往往涉及 --cap-add=NET_ADMIN、--device /dev/net/tun、甚至 privileged,并与宿主机已有防火墙规则交互,排错成本显著高于「旁路网关 + 手动网关」方案。

因此,本文推荐的旁路落地路径是:旁路机提供可用的 HTTP/SOCKS(或设备支持的代理协议),由终端把默认网关指到旁路机,使 IP 层流量先到达旁路机,再由系统转发与 Clash 入站协作;这与本机 TUN「单设备全局接管」是不同层面的问题。若你确实要在 Linux 宿主机上玩透 TUN,仍以物理机或 systemd 部署为主线更清晰,容器更适合作为隔离的入站与策略引擎。

局域网设备:如何设置网关与 DNS

对 Windows、Android 等可以手动配置代理的系统,你甚至可以只填代理地址而不改网关;但电视、游戏机、部分 IoT 往往只支持改 IP 与 DNS。此时请在该设备的网络设置里把默认网关设为旁路机静态 IP,DNS 设为旁路机 IP(若 Clash 提供 DNS 入站)或你信任的公共 DNS,并确认没有「仅代理网页」之类的厂商开关阻断全局流量。

若你希望同网段其他设备仍走主路由出口,仅少数设备走旁路,请使用「按设备 DHCP 绑定」或静态 IP 方案,而不要把整网 DHCP 网关全局改成旁路机,以免全家上网路径都被迫经过 Clash,增加故障面。

主路由可选:静态路由与 DHCP 选项

某些拓扑下,你会希望主路由为「指定目的网段」追加静态路由,下一跳指向旁路机;更常见的家庭场景则是不动主路由,仅在终端侧改网关。若你使用软路由或 OpenWrt,也可以把「部分 VLAN / 部分 SSID」的默认网关直接设为旁路 IP,实现分人群策略。无论哪种方式,请保留一条不经过代理的管理通道(例如有线连接主路由 LAN),避免旁路机宕机时全屋失联。

验证步骤与排错思路

建议按顺序做最小验证:① 在宿主机上 curl 本机映射端口,确认进程存活;② 从同网段另一台设备访问 http://旁路IP:端口(若协议允许)或观察连接日志;③ 在测试设备上 traceroute 或查看默认路由是否指向旁路 IP;④ 打开 Clash 日志,确认规则命中与 DNS 行为符合预期。

现象 优先怀疑 处理方向
仅宿主机可访问映射端口 NAS 防火墙、绑定地址、端口映射未发布到 LAN 检查 allow-lan、宿主防火墙与 Docker 发布参数
设备网关已改但仍直连 设备忽略网关、分流应用自带 DNS、或隔离 VLAN 核对设备网络详情、关闭「仅浏览器代理」、检查 AP 隔离
能打开国内站,海外站超时 规则、DNS 或节点可用性 对照连接正常却无网页文的日志分层法
先保证「局域网能打到旁路机端口」,再谈规则与订阅;顺序反了会在 DNS 与策略上浪费大量时间。

小结

用 Docker Clash 做旁路由,本质是三件事:容器侧把正确的监听地址与端口映射露给局域网,配置侧打开局域网访问并收紧面板权限,终端侧把默认网关与 DNS 指到旁路机。这与 Ubuntu 上 systemd 直装、或桌面端开 TUN,是不同层级的问题;容器擅长交付与迁移,但不自动替你解决透明代理所需的内核与防火墙协作。

当你把旁路网关跑稳之后,手机与电脑仍可使用图形客户端获得更细的控制;若希望减少版本错配、统一获取各平台安装包,可从本站客户端下载页入手,再结合文档核对端口与模式说明。相比在搜索引擎里随机抓取二进制,单一入口通常更省心。

相比其他同类工具,Clash 系在规则表达、策略组与 Mihomo 生态上往往更易维护长期配置;旁路场景下,「能写清规则」与「能把端口和网关对齐」同样重要。若你尚未在本机体验过完整分流与日志排错,不妨先在常用设备上跑通,再把成熟配置迁移到 Docker 网关,能显著降低全家网络试错成本。

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

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