OpenWrt 系的系统(iStoreOS、ImmortalWrt 等)现在装 Docker 已经很容易了,商店里点一下就有。但「能跑起来」和「能长期稳定跑」是两件事。下面五条是这段时间踩出来的。
一、数据目录必须放外挂盘
OpenWrt 的根文件系统是 overlay,写在外挂的 ext4 分区上,容量通常只有 1–2G。你一 docker pull 一个几百兆的镜像,或者某个容器开始写日志,很快就满了。
根分区满的后果比想象中严重:不是某个服务挂掉,而是整个系统开始出各种莫名其妙的错误——配置存不进去、SSH 登不上、界面转圈。
所以第一件事是把 Docker 的数据目录搬走:
# /etc/docker/daemon.json
{
"data-root": "/mnt/sda1/docker"
}
改完 service docker restart。原来的镜像要重新拉一遍,但一劳永逸。
判断有没有搬成功:
docker info | grep "Docker Root Dir"
二、restart 策略别用 always,用 unless-stopped
always 和 unless-stopped 的区别只在你手动 docker stop 的时候体现:always 会在 Docker 重启后把容器拉起来,哪怕是你特意停掉的;unless-stopped 尊重你的意愿。
长期运维里这个区别很大。你需要临时停一个服务排查问题,结果重启 Docker 之后它又自己起来了——很烦。
services:
app:
restart: unless-stopped
三、时区别忘
容器默认是 UTC。日志里时间差 8 小时还是小事,有些应用直接用容器时区做业务判断(比如定时任务、文章发布时间)就会错。
两种写法,选一个:
environment:
- TZ=Asia/Shanghai
或者挂载宿主机的时区文件:
volumes:
- /etc/localtime:/etc/localtime:ro
推荐第一种,不依赖宿主机的文件结构。
四、端口冲突先查 netstat,别猜
80 和 443 在 OpenWrt 上大概率被 uhttpd(LuCI 管理界面)占着。直接映射会起不来,报 address already in use。
先看清楚谁占着:
netstat -tlnp | grep -E ':(80|443|8080)\b'
确实要腾端口的话,改 LuCI 的监听端口比杀进程靠谱:
uci set uhttpd.main.listen_http='0.0.0.0:8088'
uci commit uhttpd
/etc/init.d/uhttpd restart
改完记得用新端口进后台,别把自己锁在外面。
五、备份要验证,不是有个脚本就算数
这条是踩过最狠的坑。备份脚本放在 cron 里天天跑,看起来一切正常,真要用的时候才发现:
- 数据库 dump 是个 0 字节文件(权限问题,
>重定向失败) - 数据目录打包时文件正在写,tar 报错但脚本没退出
- 备份目录本身在系统盘上,系统盘满了,备份也一起没了
所以验证方法是三个:
- 看文件大小——和预期量级对不对
- 看脚本退出码——
set -e加上|| exit 1 - 定期试还原——在另一台机器上真的解一次
没有验证过的备份,等于没有备份。这句话听起来像废话,但踩过的人都知道它不是。
小结
这五条没一条是 OpenWrt 独有的,但在这类「小主机 + 家用网络」的环境里,容错空间比云服务器小得多:盘小、没有快照、断电没人管。多做一步预防,后面少熬一夜。