linuxserver/healthchecks

Healthchecks 是一款cron任务监控工具，作为看门狗监听来自cron任务的ping，并提供Web界面，帮助用户跟踪任务执行状态。

!healthchecks

LinuxServer.io团队提供的此容器具有以下特点：

• 定期及时的应用更新
• 简单的用户映射（PGID、PUID）
• 带有s6 overlay的自定义基础镜像
• 每周基础操作系统更新，跨整个LinuxServer.io生态系统共享公共层，以最小化空间占用、停机时间和带宽
• 定期安全更新

支持的架构

我们利用docker manifest实现多平台支持。只需拉取 lscr.io/linuxserver/healthchecks:latest 即可获取适合您架构的正确镜像，也可通过标签拉取特定架构镜像。

支持的架构：

应用设置

通过 <your-ip>:8000 访问Web界面。更多信息请查看 Healthchecks。

完整的环境变量列表请参见 此处。

使用方法

以下是使用docker-compose或docker cli创建容器的示例。

[!NOTE] 除非标记为“可选”，否则参数为必填项，必须提供值。

docker-compose（推荐，点击查看更多信息）

yaml
---
services:
  healthchecks:
    image: lscr.io/linuxserver/healthchecks:latest
    container_name: healthchecks
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - SITE_ROOT=
      - SITE_NAME=
      - SUPERUSER_EMAIL=
      - SUPERUSER_PASSWORD=
      - ALLOWED_HOSTS= #可选
      - APPRISE_ENABLED=False #可选
      - CSRF_TRUSTED_ORIGINS= #可选
      - DEBUG=True #可选
      - DEFAULT_FROM_EMAIL= #可选
      - EMAIL_HOST= #可选
      - EMAIL_PORT= #可选
      - EMAIL_HOST_USER= #可选
      - EMAIL_HOST_PASSWORD= #可选
      - EMAIL_USE_TLS= #可选
      - INTEGRATIONS_ALLOW_PRIVATE_IPS= #可选
      - PING_EMAIL_DOMAIN= #可选
      - RP_ID= #可选
      - SECRET_KEY= #可选
      - SITE_LOGO_URL= #可选
    volumes:
      - /path/to/healthchecks/config:/config
    ports:
      - 8000:8000
      - 2525:2525 #可选
    restart: unless-stopped

docker cli（点击查看更多信息）

bash
docker run -d \
  --name=healthchecks \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e SITE_ROOT= \
  -e SITE_NAME= \
  -e SUPERUSER_EMAIL= \
  -e SUPERUSER_PASSWORD= \
  -e ALLOWED_HOSTS= `#可选` \
  -e APPRISE_ENABLED=False `#可选` \
  -e CSRF_TRUSTED_ORIGINS= `#可选` \
  -e DEBUG=True `#可选` \
  -e DEFAULT_FROM_EMAIL= `#可选` \
  -e EMAIL_HOST= `#可选` \
  -e EMAIL_PORT= `#可选` \
  -e EMAIL_HOST_USER= `#可选` \
  -e EMAIL_HOST_PASSWORD= `#可选` \
  -e EMAIL_USE_TLS= `#可选` \
  -e INTEGRATIONS_ALLOW_PRIVATE_IPS= `#可选` \
  -e PING_EMAIL_DOMAIN= `#可选` \
  -e RP_ID= `#可选` \
  -e SECRET_KEY= `#可选` \
  -e SITE_LOGO_URL= `#可选` \
  -p 8000:8000 \
  -p 2525:2525 `#可选` \
  -v /path/to/healthchecks/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/healthchecks:latest

参数

容器通过运行时传递的参数进行配置，格式为 <外部>:<内部>。例如，-p 8080:80 表示将容器内的80端口映射到主机的8080端口。

来自文件的环境变量（Docker secrets）

可通过特殊前缀 FILE__ 从文件中设置环境变量，例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

这会将环境变量 MYVAR 的值设置为 /run/secrets/mysecretvariable 文件的内容。

应用程序的Umask设置

所有镜像均支持通过可选参数 -e UMASK=022 覆盖服务的默认umask设置。注意umask是权限掩码，会减少权限而非增加，详情请参考此处。

用户/组标识符

使用卷（-v参数）时，主机与容器可能出现权限问题。通过指定用户PUID和组PGID可避免此问题。确保主机卷目录的所有者与指定的用户一致。

使用 id your_user 命令可查看当前用户的PUID和PGID：

bash
id your_user

示例输出：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

我们提供多种Docker Mods以扩展容器功能。上方徽章链接可查看此镜像及通用mods。

支持信息

• 容器运行时的Shell访问：

  bash
  docker exec -it healthchecks /bin/bash
  

• 实时监控容器日志：

  bash
  docker logs -f healthchecks
  

• 容器版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' healthchecks
  

• 镜像版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/healthchecks:latest
  

更新信息

大多数镜像为静态版本化，需更新镜像并重建容器以更新应用。除特殊说明外，不建议在容器内更新应用。

通过Docker Compose更新

• 更新镜像：

  • 所有镜像：

    bash
    docker-compose pull
    

  • 单个镜像：

    bash
    docker-compose pull healthchecks
    

• 更新容器：

  • 所有容器：

    bash
    docker-compose up -d
    

  • 单个容器：

    bash
    docker-compose up -d healthchecks
    

• 清理旧镜像：

  bash
  docker image prune
  

通过Docker Run更新

• 更新镜像：

  bash
  docker pull lscr.io/linuxserver/healthchecks:latest
  

• 停止运行中的容器：

  bash
  docker stop healthchecks
  

• 删除容器：

  bash
  docker rm healthchecks
  

• 使用上述docker run参数重建容器（若卷映射正确，/config目录及设置将保留）

• 清理旧镜像：

  bash
  docker image prune
  

镜像更新通知 - Diun（Docker镜像更新通知器）

[!TIP] 推荐使用Diun接收更新通知。不建议使用自动更新容器的工具。

本地构建

如需本地修改或自定义镜像：

bash
git clone [***]
cd docker-healthchecks
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/healthchecks:latest .

可使用 lscr.io/linuxserver/qemu-static 在x86_64硬件上构建ARM变体：

bash
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset

注册后，使用 -f Dockerfile.aarch64 指定架构Dockerfile。

版本历史

• 05.07.25: - 重新基于Alpine 3.22构建。
• 20.12.24: - 重新基于Alpine 3.21构建。
• 31.08.24: - 启用uwsgi的IPv6支持。
• 31.05.24: - 重新基于Alpine 3.20构建。
• 24.01.24: - 不再将环境变量写入local_settings.py，环境变量优先于配置文件值，移除REGENERATE_SETTINGS。
• 22.01.24: - 修复CSRF处理。
• 23.12.23: - 重新基于Alpine 3.19构建。
• 31.05.23: - 重新基于Alpine 3.18构建，弃用armhf架构。
• 22.12.22: - 重新基于Alpine 3.17构建，添加pycurl依赖，新增INTEGRATIONS_ALLOW_PRIVATE_IPS参数。
• 18.10.22: - 添加curl-dev修复pip构建问题。
• 11.10.22: - 重新基于Alpine 3.16构建，迁移至s6v3。
• 27.09.22: - 修复邮件报告发送问题。
• 08.01.22: - 修复Django 4.0的CSRF设置（v1.25.0引入）。
• 11.11.21: - 集成Apprise（v1.24.0起）。
• 10.09.21: - 修复超级用户创建问题。
• 07.08.21: - 更新自定义logo处理以支持v1.22.0变更。
• 11.07.21: - 重新基于Alpine 3.14构建。
• 18.05.21: - 添加linuxserver wheel索引。
• 11.01.21: - 添加libffi-dev以支持python ***graphy库构建。
• 19.07.20: - 重新基于Alpine 3.12构建，修复'ALLOWED_HOSTS' bug，默认设为通配符。
• 19.12.19: - 重新基于Alpine 3.11构建。
• 31.10.19: - 添加postgres客户端，修复CSRF配置。
• 23.10.19: - 支持创建超级用户。
• 28.06.19: - 重新基于Alpine 3.10构建。
• 12.04.19: - 重新基于Alpine 3.9构建。
• 23.03.19: - 切换到新基础镜像，迁移至arm32v7标签。
• 14.02.19: - 添加MySQL库支持数据库使用。
• 11.10.18: - 添加流水线逻辑和多架构发布。
• 15.11.17: - Dockerfile中添加git pull确保每个标签容器代码版本一致。
• 17.10.17: - 修复local_settings.py输出。
• 27.09.17: - 初始发布。