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。
網路與連接埠
Section titled “網路與連接埠”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 或不必要連接埠。