最新

NAS 怎么用 Watchtower 自动更新 Docker 镜像

镜像有新版本却一直懒得手动拉,容器就停在旧代码上。讲清 Watchtower 怎么部署、更新频率怎么定,以及权限和回滚的风险。

容器镜像隔一阵就有新版本,手动拉取、删旧容器、再重建这一套做几次就懒得干了。Watchtower 干的就是把这个循环自动化:它自己跑成一个容器,定时去镜像仓库比对,发现新版本就拉下来,然后用新镜像把原来的容器重建一遍。

它只管 Docker 容器,NAS 自带的套件和系统更新都不归它管。各家用容器管理界面的叫法不同,找不到入口时在套件里搜容器或 Docker 更快。

入口在哪

Watchtower 不在套件中心里,它本身就是一个要运行的容器。入口有两个:NAS 的容器管理界面里新建容器,或者用 SSH 登录后执行 docker 命令。

它能发现别的容器,靠的是把宿主机的 Docker 控制接口挂进容器内。也就是说,它拿到的权限等同于在这台机器上执行 Docker 命令,这一步决定了后面所有风险,先想清楚再挂。

具体步骤

  1. 先确认 Docker 服务正常:容器管理界面能看到运行中的容器列表,或者 SSH 里执行 docker ps 能列出容器。
  2. 记下要自动更新的容器名。更新是按容器名匹配的,名字写错就不会被覆盖。
  3. 新建 Watchtower 容器:镜像填 containrrr/watchtower,把宿主机的 /var/run/docker.sock 挂到容器内同路径,不要映射任何端口。
  4. 设检查间隔,比如 --interval 86400 表示一天检查一次。想让它凌晨跑,就改成按时间表达式在指定时刻检查。
  5. 加 --cleanup,更新完顺手删掉旧镜像,否则一层层旧版本会把硬盘吃掉。
  6. 只想管某几个容器,就把容器名写在启动命令末尾;没写进去的容器不会被碰。
  7. 启动后看一次日志,确认它能列出容器、没有报连不上 Docker。

几个坑

  • 挂了 Docker 控制接口,等于把宿主机控制权交出去,镜像来源必须是可信的官方仓库,别用来源不明的同名镜像。
  • 更新方式是重建容器,服务会中断几十秒。数据库、长时间跑的任务尽量不放进取自动更新的范围。
  • 只认同名标签。镜像写死了版本号的,仓库发了新版本也不会被换掉,这类容器还得手动升级。
  • 带数据库的应用跨大版本升级常常要迁移表结构,自动更新可能直接起不来,先备份再放手。
  • 私有仓库的镜像需要登录凭据,没配的话拉取会失败,日志里能看到未授权。
  • 开了清理,回滚时旧镜像已经不在了,只能重新拉或者用备份恢复。
  • 不要给它配端口映射和外部访问,它不需要被访问,暴露出去只是多一个入口。

怎么验证

先看日志:每次检查都会打印发现新版本、拉取、停止旧容器、启动新容器的过程,没有新版本也会留下检查记录,能据此确认它确实在跑。

再看启动时间:用 docker ps 看容器的创建时间,如果它在你设定的时间点变了,说明确实被重建过。

最稳的做法是拿一个不重要的容器先试:把它单独写进监视范围,跑一轮确认服务能起来,再慢慢扩大范围。

常见问题

更新完容器起不来怎么办

先看日志里的报错,多数是配置不兼容或者需要迁移数据。回退的办法是把镜像标签改回原来的版本号,用原来的挂载和端口重建一次;配置有备份的,把配置目录一并还原。所以更新前给配置目录做一份快照,比事后找原因省事得多。

它会不会把 NAS 自带的套件也升级

不会。它只看 Docker 里的容器,套件中心的更新还得你自己去点。反过来说,容器里的应用升级了,套件那边不会有任何提示。

能不能只在半夜检查

可以,除了按间隔秒数,它还能按时间表达式在固定时刻检查,比如每天凌晨一次。半夜更新对家用影响小,但如果那时正好在跑备份或下载,照样会被打断。

一句话总结:Watchtower 靠挂载 Docker 控制接口定时比对镜像,把更新做成自动的,代价是交出宿主机权限加上一次短暂中断,先小范围试、先备份配置。