设置向导

Docker Only

全新安装的 Dozzle 会先打开一个简短的设置向导。它会带你完成大多数人在安装后马上要改的几件事：开启登录、允许容器操作和终端访问、添加其他主机，以及连接 Dozzle Cloud。它保存的所有内容也都可以通过命令行参数或环境变量设置，所以向导是可选的。向导做的所有事情在设置中也都有：安全（登录、操作和终端）、主机、更新和 Dozzle Cloud。向导只是按顺序带你走一遍这些页面。

向导只会出现在以服务器模式运行的全新安装中。Swarm 和 Kubernetes 部署永远不会显示它。它们的设置页会以只读方式显示登录、操作、终端和主机。你可以随时在 设置 → 关于 中重新运行向导。

对于经常创建又销毁的临时环境，设置 DOZZLE_DISABLE_SETUP_WIZARD=true 即可让向导不再自动打开。你仍然可以在 设置 → 关于 中运行它。

步骤

1. 登录

登录是第一步，这样在任何人都能访问的实例上，其他设置都无法被修改。

向导首先检查 /data 是否挂载在卷上。设置和用户都保存在这里，没有卷的话，下次重新创建容器时它们就会丢失。如果 /data 没有持久化，向导会说明如何挂载，并等待你点击 重新检查。

yaml

services:
  dozzle:
    image: amir20/dozzle:latest
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - dozzle_data:/data
    ports:
      - 8080:8080
volumes:
  dozzle_data:

/data 持久化之后，从三个选项中选择一个：

Dozzle 账户 创建一个用户，包含用户名、可选的邮箱和密码。Dozzle 会写入 /data/users.yml 并设置 authProvider: simple。之后要添加更多用户或角色，请参阅简单认证。
我的代理 适用于 Authelia、Authentik、Cloudflare Access 等。Dozzle 信任 Remote-User 请求头，所以只发布代理的端口，永远不要发布 Dozzle 自己的端口。这会设置 authProvider: forward-proxy。请参阅前置代理。
OIDC 显示 OpenID Connect 指南的链接和需要添加的环境变量。OIDC 需要客户端密钥，所以这里不会写入任何内容，由你自行配置。

如果 Dozzle 只能在你自己的网络中访问，不设置登录，继续 会跳过此步骤。

保存账户或代理后，Dozzle 会立即重启，确保在修改其他任何设置之前登录已经生效。你会进入登录页面，登录后向导会从下一步继续。在尚未配置登录时，设置 → 安全 提供同样的选择；配置之后会显示当前的认证方式。

2. 操作与终端

两个开关控制 Dozzle 可以对你的容器做什么：

启动、停止和重启 开启容器操作（enableActions）。
终端开启在容器内附加并执行命令（enableShell）。默认关闭。容器的终端访问往往相当于主机的访问权限，所以只在需要时开启。

如果某个设置已经由命令行参数或环境变量固定，它的开关会是只读的，并给出说明。和登录一样，这些开关需要 /data 挂载在卷上，在此之前会保持只读。同样的开关也在 设置 → 安全 中，在那里每次修改都会立即保存。

3. 主机

Dozzle 可以通过代理显示其他机器上的容器。这一步会给出要在另一台机器上运行的 compose 文件，然后询问代理的地址（例如 10.0.0.5:7007）和一个可选的名称。添加主机 会在保存任何内容之前先连接代理，所以地址填错或证书不匹配会立刻显示出来。连接成功后，主机无需重启就会出现在侧边栏中。

通过 DOZZLE_REMOTE_AGENT 设置的代理显示为锁定，只能在 compose 文件中删除。在这里添加的代理可以在同一个列表中移除。暂不会跳过这一步，之后也可以在 设置 → 主机 中，或通过主机列表底部的 添加主机 打开同一个面板。

4. Dozzle Cloud

Dozzle Cloud 会在出现故障的第一时间发送告警，每天早上发送一份待修复问题的摘要，并保留重启后依然存在的历史记录。连接 Dozzle Cloud 会关联此实例，暂不则继续下一步。如果实例已经关联，或者你没有权限关联，此步骤会被跳过。

5. 自动更新

Dozzle 可以让自己和你的容器保持最新。选择关闭、每天或每周（每周在周日运行），再选择一天中的时间。时间使用服务器的本地时间，默认是 03:00。到了这个时间，Dozzle 会检查是否有更新的镜像，只更新有变化的部分，自身最后更新。

哪些容器 决定计划还会更新什么：仅 Dozzle、有标签的容器（默认，即带有 dev.dozzle.update=auto 标签的容器）或全部。请参阅自动更新容器。

这些设置立即生效，不需要重启。它们也在 设置 → 更新 中，旁边是 立即更新 和计划将要更新的容器列表，在那里做出的更改会立即保存。

更新属于操作功能，所以在操作关闭时，这一步仍会留在列表中，但显示为灰色并标注 需要操作功能。在第 2 步开启操作后，它会立即变为可用。如果此实例因为其他原因无法更新自身（例如运行的是固定版本标签），这一步会说明原因。计划仍然可以设置，其他容器会按它更新。

6. 重启

最后一步列出已保存但尚未生效的更改。重启 Dozzle 会重启容器，等待它恢复后重新加载页面。如果没有待处理的更改，这一步只会提示你已完成。

如果 Dozzle 无法自行重启（例如找不到自己的容器），向导会改为显示可以添加到 compose 文件中的环境变量。有更改等待生效时，设置的每个页面都会显示同样的内容：一条统计更改数量的横幅，附带 重启 Dozzle 或这些配置行。

设置保存在哪里

向导会把你的选择保存到 /data/dozzle.yml。Dozzle 只在启动时读取一次这个文件，所以更改需要重启才能生效。Dozzle 会从向导中自行重启，你不需要手动操作。自动更新相关的键是例外：Dozzle 每分钟都会重新读取它们，所以无需重启即可生效。remoteAgents 是另一个例外：主机在添加的那一刻就会连接。

yaml

authProvider: simple
enableActions: true
enableShell: false
autoUpdate: weekly
autoUpdateTime: "03:00"
updateContainers: labelled
remoteAgents:
  - 10.0.0.5:7007|nas
privateAgents:
  - 10.0.0.5:7007|nas

键	取值	等同于
`authProvider`	`none`, `simple`, `forward-proxy`	`DOZZLE_AUTH_PROVIDER`
`enableActions`	`true`, `false`	`DOZZLE_ENABLE_ACTIONS`
`enableShell`	`true`, `false`	`DOZZLE_ENABLE_SHELL`
`autoUpdate`	`off`, `daily`, `weekly`	`DOZZLE_AUTO_UPDATE`
`autoUpdateTime`	`HH:MM`，服务器本地时间	`DOZZLE_AUTO_UPDATE_TIME`
`updateContainers`	`off`（仅 Dozzle）、`labelled`、`all`。计划更新哪些容器。未设置时为 `labelled`	`DOZZLE_UPDATE_CONTAINERS`
`remoteAgents`	代理地址列表	`DOZZLE_REMOTE_AGENT`
`privateAgents`	`remoteAgents` 中使用私有证书的代理	无

命令行参数和环境变量始终优先于该文件。如果设置了 DOZZLE_ENABLE_ACTIONS，dozzle.yml 中的值会被忽略，向导会将该开关显示为锁定。若想重新通过向导管理某个设置，请从 compose 文件中删除对应的变量。remoteAgents 的规则不同：文件中的代理会与 DOZZLE_REMOTE_AGENT 中的代理合并，而不是被它们取代。

自更新的工作原理

Dozzle 可以通过自身容器上的 Update 操作更新自己，也可以按自动更新计划进行。两者做的事情相同：

Dozzle 拉取它正在运行的镜像标签。如果该标签仍然指向正在运行的镜像，就到此为止，并报告已是最新版本。
Dozzle 用新镜像启动一个短暂存在的辅助容器，它可以访问同一个 Docker socket。几秒钟后 Dozzle 会退出。
辅助容器重命名旧容器，并以原来的名称创建一个替代容器，使用相同的配置、网络和卷。之后才停止旧容器并启动替代容器。匿名卷也会保留，所以即使没有命名卷，/data 中的数据也不会丢失。
辅助容器等待替代容器保持运行（如果设置了健康检查，还要保持健康）。如果成功，旧容器会被删除，但它的卷保持不动，并且会像其他任何更新一样清理再之前的那个镜像。如果失败，替代容器会被删除，旧容器会改回原来的名称并重新启动。

用 --rm 启动的容器也以同样的方式更新。旧容器停止时会自行删除，但此时替代容器已经持有它的卷，所以卷会保留下来。如果更新需要回滚，辅助容器会根据保存的配置重新创建旧容器。

辅助容器的日志是更新过程的唯一记录。它完成后会自行删除，所以要跟踪一次更新，请在它运行期间查看 dozzle-self-update-* 容器。

有些部署方式无法通过这种方式更新：

必须开启操作。 自更新需要 DOZZLE_ENABLE_ACTIONS，开启登录时，Update 操作还需要 actions 角色。
服务器模式，包括以 Swarm 服务运行。 当 Dozzle 作为 Swarm 服务的任务运行时，不会使用辅助容器：Dozzle 会请求 Swarm manager 把服务滚动更新到新镜像，并沿用 Swarm 自己的更新和回滚设置。这要求 Dozzle 运行在 manager 节点上。有多个副本时，只有第一个副本会执行计划任务。Kubernetes 和 Dozzle 代理不会自行更新。
固定版本标签永远不会更新。 拉取 amir20/dozzle:v8.12.0 总是得到同一个镜像，所以自动更新不可用，手动更新会报告已是最新版本。请使用 latest，或者自己修改标签。

安全

登录是第一步。 保存账户或代理后的重启会先开启登录，之后才能修改其他设置。
只有已登录的用户才能修改操作、终端和自动更新设置、添加或移除主机，或重启 Dozzle。 该用户需要拥有全部角色。设置页遵循同样的规则，并说明某个值为什么是只读的。
没有登录时，只有全新安装才有 15 分钟的时间窗口。 当 authProvider 为 none 时，这些设置只能在全新安装（/data 为空）首次启动后的 15 分钟内修改。已经有之前运行留下数据的安装永远不会获得这个窗口，因此重启主机或更新镜像都无法打开它。窗口之外，请使用环境变量或开启登录。
路由仍然在启动时决定。 向导只会写入 dozzle.yml。操作和终端的接口在 Dozzle 启动时注册，与使用环境变量时完全相同，所以在 Dozzle 重启之前不会启用任何功能。

设置向导 ​

步骤 ​

1. 登录 ​

2. 操作与终端 ​

3. 主机 ​

4. Dozzle Cloud ​

5. 自动更新 ​

6. 重启 ​

设置保存在哪里 ​

自更新的工作原理 ​

安全 ​