Administrator
发布于 2026-11-18 / 0 阅读
0
0

在 OpenWrt / iStoreOS 上用 Docker 跑服务,五条实操经验

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 报错但脚本没退出
  • 备份目录本身在系统盘上,系统盘满了,备份也一起没了

所以验证方法是三个:

  1. 看文件大小——和预期量级对不对
  2. 看脚本退出码——set -e 加上 || exit 1
  3. 定期试还原——在另一台机器上真的解一次

没有验证过的备份,等于没有备份。这句话听起来像废话,但踩过的人都知道它不是。

小结

这五条没一条是 OpenWrt 独有的,但在这类「小主机 + 家用网络」的环境里,容错空间比云服务器小得多:盘小、没有快照、断电没人管。多做一步预防,后面少熬一夜。


评论