容器更新
Dozzle 会检查容器是否有更新的镜像,并可以更新它们:在容器菜单中逐个更新,在仪表盘上批量更新,或按计划自动更新。检查无需任何配置即可使用,更新则需要开启容器操作。
每次更新都会被监控,如果新容器无法稳定运行,旧容器会被恢复。从 Watchtower 迁移过来?请参阅从 Watchtower 迁移。
更新的过程
旧容器会被重命名并保留,直到新容器连续运行 10 秒且没有重启,并且在镜像带有健康检查时报告为健康。如果新容器无法启动、退出、重启或变为不健康,Dozzle 会删除它并恢复旧容器,更新会显示已回滚及原因。新容器会带上标签 dev.dozzle.previous-image(被替换的镜像 ID)和 dev.dozzle.previous-ref(该镜像的 repo@sha256:… 摘要,本地构建的镜像没有此标签)。已停止的容器永远不会被更新,因为它可能是有意停止的。有新镜像时它仍会显示出来,但不会提供 更新,计划会跳过它,而通过其他方式(例如 Dozzle Cloud)请求的更新会被拒绝,并提示“请先启动容器”。启动它之后即可更新。
更新检查
Dozzle 会检查容器正在运行的镜像是否仍然是其仓库提供的那一个。如果两者不同,容器菜单上会出现一个圆点,菜单中会提示有可用更新。
检查的方式是向仓库查询容器创建时所用标签的摘要,并与容器实际运行的摘要作比较。这是通过对镜像 manifest 发起一个 HEAD 请求完成的,因此不会下载任何层,也不会计入 Docker Hub 的拉取速率限制。结果会缓存六小时,而且无论有多少容器或主机在运行同一个镜像,都只会查询一次。
由于比较的对象是容器正在_运行_的镜像,所以即使主机上已经拉取了更新的镜像,容器在被重新创建之前仍然算作过期。
跟随哪个标签
Dozzle 只会跟随容器镜像引用中的那个确切标签,这一点和 Watchtower 相同。它从不查看其他标签,也不比较版本号,所以“有更新”的含义始终是“这个标签现在指向了另一个镜像”,而更新时会重新拉取同一个标签。容器能前进多远,取决于你选择的标签:
| 镜像引用 | 更新会带来什么 |
|---|---|
nginx:latest | 发布者称为 latest 的任何版本,包括新的主版本 |
postgres:18 | 新的 18.x 版本,前提是发布者会持续移动 18 标签 |
postgres:18.1 | 18.1 的补丁版本和重新构建,前提是发布者会移动该标签 |
linuxserver/speedtest-tracker:1.15.0 | 仅 1.15.0 的重新构建(例如从 1.15.0-ls175 到 1.15.0-ls176) |
linuxserver/speedtest-tracker:1.15.0-ls176 | 没有,除非发布者重新推送这个确切的标签 |
postgres:18@sha256:… | 没有。固定到摘要的引用不会被检查 |
要停留在某个次版本上,发布者必须为它发布对应的标签。如果它只发布完整的版本号,就固定其中一个,等你想升级时再自己修改。标签也可能被就地重新构建,通常是为了修补基础镜像,所以一次更新带来的版本号可能和原来相同。
检查和操作是相互独立的。无论 Dozzle 是否被允许做出改动,知道容器已过期本身就是有用的,所以即使 DOZZLE_ENABLE_ACTIONS 关闭,这个提示也会出现。只有 Update 按钮需要启用容器操作。
发布说明
有可用更新时,Dozzle 会链接到镜像的发布说明,方便你在更新前先确认是否有破坏性变更。链接来自镜像本身已带的标签:org.opencontainers.image.source(或较旧的 org.label-schema.vcs-url)中的 GitHub 仓库会链接到该仓库的 Releases 页面。很多公开发布的镜像都设置了这个标签,但大多数 Docker Hub 官方镜像(例如 nginx 和 postgres)没有,还有一些指向的是打包仓库而不是应用本身。
要设置或修正这个链接,给容器加上一个标签,值可以是任意 http 或 https URL:
services:
database:
image: postgres:18
labels:
dev.dozzle.releases: https://www.postgresql.org/docs/release/关闭它
DOZZLE_IMAGE_CHECK_MODE 控制 Dozzle 是否会去访问镜像仓库。
| 值 | 行为 |
|---|---|
automatic | 在查看容器时于后台检查。 |
manual | 从不自动检查。菜单中会提供“检查更新”操作。 |
off | 功能完全关闭。不注册任何接口,也不发出任何请求。 |
它的默认值取决于 DOZZLE_RELEASE_CHECK_MODE 的设置,所以如果你已经让 Dozzle 不自动获取版本发布信息,它也不会自动检查镜像。
services:
dozzle:
image: amir20/dozzle:latest
environment:
DOZZLE_IMAGE_CHECK_MODE: off要让某一个容器不再被检查(比如一个刻意固定了版本的容器),给它加上标签。这也会让它不参与自动更新计划。
services:
database:
image: postgres:18-alpine
labels:
dev.dozzle.update: off发现更新时也可以显示通知。该功能默认关闭,位于设置中。
哪些情况无法检查
有些容器没有可比较的对象,Dozzle 会保持沉默,而不是去猜:
- 本地构建的镜像,它们没有仓库摘要
- 固定到某个摘要的引用,它们不会变化
- Dozzle 没有登录信息的私有仓库。在 Kubernetes 中,这也包括通过
imagePullSecrets拉取的镜像,除非挂载了同一个 secret。
Kubernetes
在 Kubernetes 模式下,检查会把 Pod 状态中记录的摘要与仓库进行比较,因此在 k3s、EKS、GKE 等基于 containerd 的集群上无需额外权限即可使用。该提示仅供参考,不会附带 Update 按钮,因为 Pod 的镜像由其工作负载决定。对于 :latest 这类会变动的标签,并且设置了 imagePullPolicy: Always,执行一次滚动重启即可获取新镜像。其他情况则需要修改工作负载的 spec。在 Kubernetes 模式下,仪表盘不会显示更新按钮和更新抽屉。
更新 Dozzle 自身
Dozzle 自身容器上的 Update 操作会就地更新 Dozzle。它拉取新镜像,并把替换工作交给一个短暂存在的辅助容器,所以 Dozzle 会离开几秒钟,然后以新版本回来,配置和卷保持不变。它也可以按计划运行。关于哪些内容会保留以及哪些部署方式不受支持,请参阅 自更新的工作原理。以 Swarm 服务方式运行的 Dozzle 通过编排器更新。其他主机上的 Dozzle 代理是普通容器,和其他容器一样更新。
私有仓库
Dozzle 使用 Docker config.json 中的登录信息来检查和更新私有仓库中的镜像,也就是 docker login 写入、Watchtower 读取的那个文件。仅在主机上登录是不够的。Dozzle 运行在容器中,而 Docker daemon 不会读取这个文件,所以需要把它挂载进来:
services:
dozzle:
image: amir20/dozzle:latest
environment:
DOCKER_CONFIG: /docker
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ~/.docker:/docker:roDOCKER_CONFIG 指定包含 config.json 的目录。如果未设置,Dozzle 会查找 /config.json,因此 Watchtower 的 ~/.docker/config.json:/config.json 挂载方式同样可用。建议挂载目录:docker login 会替换该文件,而单文件挂载仍会显示旧文件。修改无需重启即可生效。
如果想把这份登录信息和你自己的分开,可以单独为 Dozzle 写一个文件,最好使用只读的访问令牌。Docker Hub 的键是 https://index.docker.io/v1/。auth 的值可以这样生成:
{
"auths": {
"registry.example.com": { "auth": "dXNlcm5hbWU6cGFzc3dvcmQ=" }
}
}printf '%s' 'username:password' | base64 | tr -d '\n'登录信息只会发送给它所对应的仓库。如果仓库拒绝,Dozzle 会不带登录信息重试,因此过期的登录信息不会影响公开镜像。Swarm 服务是例外,见下文。
文件放在哪里
文件在执行检查和拉取的地方读取,所以使用 Agent 时,每个 Agent 都需要以同样方式挂载自己的副本。使用远程主机时,Dozzle 读取自己的副本,并在拉取时把登录信息发送给远程 daemon。
在 Swarm 模式下,secret 会到达每个节点。使用 docker secret create registry_login ~/.docker/config.json 创建。服务更新会把登录信息传给 manager,效果与 docker service update --with-registry-auth 相同。之后各节点会带着它拉取镜像,被拒绝时不会去掉它重试,所以即使是公开镜像,被拒绝的登录信息也会让更新失败:请删除过期的条目,不要留着。secret 无法修改,因此新的登录信息需要新建 secret 并重新部署。
services:
dozzle:
image: amir20/dozzle:latest
secrets:
- source: registry_login
target: /config.json
secrets:
registry_login:
external: true在 Kubernetes 中,挂载 imagePullSecrets 已在使用的 secret。它必须位于 Dozzle 所在的命名空间,如果你的应用在其他命名空间中运行,请把它复制过来。Dozzle 只在检查时读取它,不需要额外权限:
env:
- name: DOCKER_CONFIG
value: /docker
volumeMounts:
- name: registry-login
mountPath: /docker
readOnly: true
volumes:
- name: registry-login
secret:
secretName: regcred
items:
- key: .dockerconfigjson
path: config.json不支持的内容
- 凭据助手(
credsStore和credHelpers),包括 Docker Desktop 的钥匙串。Dozzle 镜像不包含任何助手,配置依赖助手时会记录一条警告。请改为写一个带auth条目的文件。 - 会自行过期的登录信息,例如 Amazon ECR 令牌,因为没有任何机制会续期。
- 身份令牌(
config.json中的identitytoken)。 - Watchtower 的
REPO_USER和REPO_PASS,它们会把同一份登录信息发送给所有仓库。
一次更新多个容器
开启操作后,仪表板会一次性检查所有容器。过期的容器名称旁会出现一个小圆环,容器列表上方会出现一个 N 个更新 按钮。两者都会打开"更新"抽屉,其中列出所有有更新镜像的容器,并且默认全部选中。取消勾选你不想动的容器,然后点击 更新。
各主机并行更新,而每台主机一次只更新一个容器,这样任何守护进程都不必同时拉取十几个镜像。抽屉会显示每个容器依次经历拉取、重建和已更新这几个阶段,某个容器失败也不会影响其余容器。更新在服务器端运行,所以关闭标签页不会中断它。再次打开抽屉时,会接着显示当前的进度。
如果 Dozzle 自身的容器也在列表中,它总是最后更新,因为更新它会重启 Dozzle。
当设置了 DOZZLE_IMAGE_CHECK_MODE=manual 时,按钮会显示 检查更新,直到你点击它。关闭操作时,仪表板和现在完全一样,每个容器自己的菜单仍会提示是否有可用更新。
自动更新容器
Dozzle 可以按计划更新容器。在 设置 → 更新 或 设置向导 中设置:
- 时间: 关闭、每天或每周(周日),以及一天中的时间。等同于
DOZZLE_AUTO_UPDATE和DOZZLE_AUTO_UPDATE_TIME。 - 哪些容器: 仅 Dozzle、有标签的容器(默认)或 全部。无论选哪一项,Dozzle 自身都会按计划更新。等同于
DOZZLE_UPDATE_CONTAINERS(off、labelled或all)。
容器上的一个标签决定其余的部分:
dev.dozzle.update | 结果 |
|---|---|
auto | 按计划更新,除非 哪些容器 选的是 仅 Dozzle |
| (无标签) | 选 全部 时按计划更新。否则会被检查并显示为可用更新,由你手动应用 |
check | 会被检查并显示为可用更新,但 Dozzle 从不更新它。请自行更新,例如使用 docker compose |
off | 从不检查,从不更新 |
services:
app:
image: ghcr.io/example/app:latest
labels:
dev.dozzle.update: auto旧标签仍然有效:dev.dozzle.auto-update=true 视为 auto,dev.dozzle.update-check=false 视为 off。
到了计划时间,Dozzle 会把计划中的每个容器与其镜像仓库进行比对,只更新有新镜像的容器,Dozzle 自身最后更新。每次更新都是上文所述的安全替换,因此新容器如果无法稳定运行,旧容器会被换回来。已停止或不健康的容器、Dozzle 无法检查 的容器,以及从当前提供的镜像回滚过的容器都会被跳过。设置 → 更新 会列出下一次运行将要更新的容器。
选 全部 时,使用 postgres:latest 这类浮动标签的数据库可能会升级到一个无法读取现有数据文件的主版本。选择 全部 时会列出把数据保存在命名卷中的容器。给这些容器加上 dev.dozzle.update: off 标签即可将其排除。
哪些容器 作为 updateContainers 保存在 dozzle.yml 中,因此在界面中修改它需要把 /data 放在卷上。自动更新在服务器模式下运行,也包括 远程代理 上的容器,并且需要开启操作。从 Watchtower 迁移过来?请参阅 从 Watchtower 迁移。
清理旧镜像
每次更新都会在主机上留下被替换的镜像,因此 Dozzle 会在更新后删除旧镜像,类似 Watchtower 的 --cleanup。清理始终进行,适用于所有更新:定时更新、容器的 Update 操作,以及更新面板。无需任何开关。
Dozzle 会保留容器之前运行的镜像,以便还能回退到它,并删除再之前的那个。从 1.4.1 更新到 1.4.2 会删除 1.4.0 并保留 1.4.1,因此每个容器最多保留一个备用镜像。Dozzle 从旧容器的 dev.dozzle.previous-image 标签读取要删除的镜像,所以容器的第一次更新不会删除任何镜像。
只有在更新完成且旧容器已删除之后才会清理。已回滚的更新不会删除任何镜像。Dozzle 只删除没有标签且没有容器使用的镜像:仍带有标签的镜像(例如你自己拉取或构建的镜像)会被保留,并且删除不强制,因此只要还有其他容器(无论运行中还是已停止)在使用它,Docker 就会拒绝删除。删除被拒绝不会导致更新失败。
远程代理 上的容器也以同样方式清理,Dozzle 自身的容器也是如此:新的 Dozzle 稳定运行后,自更新 的辅助容器会删除再之前的那个镜像。Swarm 服务(包括以 Swarm 服务运行的 Dozzle)不会被清理,因为每个节点保存自己的镜像,并且 Swarm 会自行清理任务历史。
回滚
回滚更新是 Dozzle Cloud 的功能。Dozzle Cloud 会关注计划所做的每次更新,当新版本开始出现故障时,会提出回滚。随后 Dozzle 会把容器换回它之前运行的镜像,也就是其 dev.dozzle.previous-image 标签所指的镜像,方式与更新相同:当前容器会一直保留,直到之前的镜像稳定运行;如果没有稳定运行,就把当前容器放回去。设置和卷保持不变。回滚不会拉取任何镜像,因此如果之前的镜像已不在主机上,回滚会失败,容器保持原样。
回滚后的容器会带上 dev.dozzle.rolled-back-from 标签,记录它离开的那个镜像,自动更新计划会跳过它,直到它的标签指向更新的镜像。回滚稳定运行后,被回滚的镜像会像其他旧镜像一样被清理,因此只有在不再有标签指向它时才会被删除。
回滚适用于独立容器,也包括 远程代理 上的容器。Swarm 服务、Kubernetes 和 Dozzle 自身的容器不支持回滚。
日志视图中的更新
当 Dozzle 更新一个容器时(按计划、从 Dozzle 界面或从 Dozzle Cloud),新容器的日志会以一个标记开头,写明它从哪个镜像换到哪个镜像,以及是谁发起的更新。被撤销的更新也会被标记。Dozzle 只在内存中保存最近的更新,因此 Dozzle 重启后标记会消失。
连接了 Dozzle Cloud 时,标记还会显示 Dozzle Cloud 对这次更新的判断,并附有前往 Dozzle Cloud 的链接。回滚也会被标记,而且计划更新和回滚的标记在重启后会重新出现。