Skip to content

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 主機。

Terminal window
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 逾時,換鏡像後可用:

Terminal window
uci add_list dockerd.globals.registry_mirrors='https://docker.m.daocloud.io'
uci commit dockerd
/etc/init.d/dockerd restart

這不是通用推薦。使用你信任的鏡像,並核對 image digest;鏡像可能過期或不可用。

預設資料目錄是 /opt/docker/:

Terminal window
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。

Terminal window
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 不存在:

Terminal window
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

新容器也同樣失敗。恢復步驟:

Terminal window
/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