跳转到内容

OpenWrt 上的 Docker:安装、存储、网络与重启恢复

状态:Docker 平台是 VM 上的 E2;AdGuard Home、Home Assistant、NAS、USB/SSD 存储和真实路由器重启仍是 E1。不要因为包能装就在 16 MB/128 MB 路由器上跑 Docker。

Docker 需要:

  • RAM:本实验 VM 只有 512 MB,daemon 加容器很紧;
  • 存储:镜像和层增长快;本实验把根分区扩到 2 GB;
  • 可写数据目录(默认 /opt/docker);
  • 端口发布对应的防火墙策略;
  • 重启后 docker0/veth 失败的恢复方案。

如果路由器只有 16 MB Flash 或 128 MB RAM,应该另用 x86/N1 主机。

终端窗口
apk update
apk add dockerd docker
/etc/init.d/dockerd enable
/etc/init.d/dockerd start
docker info

本实验在 OpenWrt 25.12.6 安装 Docker 29.6.1。包会拉 containerd、runc、kmod 和较大的 dockerd;先看剩余空间。

本实验直接拉 Docker Hub 超时,换镜像后可用:

终端窗口
uci add_list dockerd.globals.registry_mirrors='https://docker.m.daocloud.io'
uci commit dockerd
/etc/init.d/dockerd restart

这不是通用推荐。使用你信任的镜像,并核对 image digest;镜像可能过期或不可用。

默认数据目录是 /opt/docker/:

终端窗口
uci show dockerd
docker info | grep -E 'Docker Root Dir|Storage Driver'
df -h /opt
  • /opt/docker 要放在真实磁盘、USB SSD 或 NVMe,不要放很小的 overlay;
  • 存储要在 Docker 启动前挂载,否则 Docker 会在根分区重建数据;
  • 用 docker system df 看占用,清理不用的镜像/容器;
  • 不要把 Docker 数据放在重启会消失的文件系统。

本实验用的是 VM 根分区(2 GB),不是 USB/SSD;这部分仍是 E1。

终端窗口
ip link show docker0
docker run --rm hello-world
docker run --rm -v /tmp/docker-test:/data alpine \
sh -c 'echo hello > /data/hello && cat /data/hello'
docker run -d --name rh-test-http -p 8082:80 nginx:alpine
curl -sS http://127.0.0.1:8082

本实验:

  • hello-world 拉取并运行;
  • Alpine 卷把 /tmp/docker-test/hello 写到宿主机;
  • nginx 发布 8082:80 并返回默认页。

真实路由器上:

  • 不要默认把 Docker 端口发布到 WAN;
  • 只开需要的端口和 zone;
  • 注意 53 端口与 dnsmasq/AdGuard 冲突;
  • host 网络绕过 Docker 端口映射,要理解暴露面;
  • 不要把 Docker socket/API 暴露到 LAN。

reboot 后 Docker 启动了,但 docker0 不存在:

终端窗口
ip link show docker0
# Device "docker0" does not exist
docker ps -a
# rh-test-http Exited (255)
docker start rh-test-http
# failed to create endpoint ... adding interface veth... to bridge docker0 failed:
# Device does not exist

新容器也同样失败。恢复步骤:

终端窗口
/etc/init.d/dockerd restart
ip link show docker0
docker run -d --name rh-test-http3 -p 8082:80 nginx:alpine
curl -sS http://127.0.0.1:8082

dockerd restart 后 docker0 出现,新容器可用。但本实验没有证明带 --restart unless-stopped 的容器能在重启后无人工干预自动恢复;它没有。

含义:

  • --restart 不能替代重启后检查 docker0;
  • 启动顺序/钩子修复是设备相关的,必须实测;
  • 如果断电后必须可靠,做真实重启并加监控;
  • 不要因为容器当前在跑就说“Docker 会自动启动”。

本实验没有测试这些:

应用 额外问题
AdGuard Home 53 端口冲突、host/bridge、上游 DNS
Home Assistant 存储、USB Zigbee/Z-Wave、host 网络
NAS/文件服务 磁盘挂载、权限、SMB/NFS、断电
下载工具 磁盘 I/O、VPN namespace、合法内容

一次只加一个应用;先看 RAM、存储和防火墙。

现象 先查 常见原因
docker: not found 包、PATH 只装了 dockerd;补装 docker
dockerd 起不来 logread、磁盘、配置 数据目录错;缺 kmod;端口冲突
拉取超时 registry/镜像、DNS、代理 Docker Hub 被挡;镜像失效
重启后 docker0 没了 ip link、服务顺序 dockerd 在网络/网桥就绪前启动
veth “Device does not exist” docker0、重启 dockerd 残留 bridge/network namespace
发布端口访问不到 docker ps、防火墙、绑定地址 没发布;WAN 被挡;zone 错
容器 OOM/被杀 free、docker stats RAM 不够
磁盘满 df、docker system df 镜像/层/日志占满小根分区
  1. 先停应用/容器,保持路由器可管理;
  2. ip link show docker0,缺失就重启 dockerd;
  3. 看 docker ps -a 和容器错误;
  4. 存储没了,先修挂载再启动 Docker;
  5. 只在理解时清理残留容器/网络;生产机不要盲目 prune;
  6. Docker 不是必需时停用:/etc/init.d/dockerd stop; /etc/init.d/dockerd disable。
  • OpenWrt 25.12.6 x86 VM 200;Docker 29.6.1;apk 安装 containerd/runc。
  • 镜像 https://docker.m.daocloud.io;hello-world 拉取并运行。
  • Alpine 卷写入 /tmp/docker-test/hello;nginx 发布 8082:80 并返回 HTTP。
  • 重启后 docker0 丢失;已有和新容器都报 veth ... Device does not exist。
  • /etc/init.d/dockerd restart 重建 docker0;新 nginx 容器在 8082 可用。
  • 未测:USB/SSD 数据目录、AGH/HA/NAS、真实路由器断电、防火墙暴露、容器重启自启。
  • 只有平台 E2;应用和存储是 E1。
  • 没有独立评审。
  • Docker 攻击面大;不要暴露 daemon 或不必要端口。

来源

Router.Homes

独立的 OpenWrt 实操笔记。每页写明固件、设备、包管理器与恢复路径。

图标:Solar by 480 Design, CC BY 4.0