OpenWrt 上的 Docker:安装、存储、网络与重启恢复
状态:Docker 平台是 VM 上的 E2;AdGuard Home、Home Assistant、NAS、USB/SSD 存储和真实路由器重启仍是 E1。不要因为包能装就在 16 MB/128 MB 路由器上跑 Docker。
Docker 适不适合这台设备
Section titled “Docker 适不适合这台设备”Docker 需要:
- RAM:本实验 VM 只有 512 MB,daemon 加容器很紧;
- 存储:镜像和层增长快;本实验把根分区扩到 2 GB;
- 可写数据目录(默认
/opt/docker); - 端口发布对应的防火墙策略;
- 重启后
docker0/veth 失败的恢复方案。
如果路由器只有 16 MB Flash 或 128 MB RAM,应该另用 x86/N1 主机。
apk updateapk add dockerd docker/etc/init.d/dockerd enable/etc/init.d/dockerd startdocker info本实验在 OpenWrt 25.12.6 安装 Docker 29.6.1。包会拉 containerd、runc、kmod 和较大的 dockerd;先看剩余空间。
镜像加速(按地区)
Section titled “镜像加速(按地区)”本实验直接拉 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 dockerddocker 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 docker0docker run --rm hello-worlddocker 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:alpinecurl -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。
真正重要的重启失败
Section titled “真正重要的重启失败”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 restartip link show docker0docker run -d --name rh-test-http3 -p 8082:80 nginx:alpinecurl -sS http://127.0.0.1:8082dockerd restart 后 docker0 出现,新容器可用。但本实验没有证明带 --restart unless-stopped 的容器能在重启后无人工干预自动恢复;它没有。
含义:
--restart不能替代重启后检查docker0;- 启动顺序/钩子修复是设备相关的,必须实测;
- 如果断电后必须可靠,做真实重启并加监控;
- 不要因为容器当前在跑就说“Docker 会自动启动”。
应用示例(E1)
Section titled “应用示例(E1)”本实验没有测试这些:
| 应用 | 额外问题 |
|---|---|
| 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 |
镜像/层/日志占满小根分区 |
- 先停应用/容器,保持路由器可管理;
ip link show docker0,缺失就重启dockerd;- 看
docker ps -a和容器错误; - 存储没了,先修挂载再启动 Docker;
- 只在理解时清理残留容器/网络;生产机不要盲目 prune;
- Docker 不是必需时停用:
/etc/init.d/dockerd stop; /etc/init.d/dockerd disable。
E2 实测记录(2026-10-26)
Section titled “E2 实测记录(2026-10-26)”- 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 或不必要端口。