本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
Healthchecks 是一款cron任务监控工具,作为看门狗监听来自cron任务的ping,并提供Web界面,帮助用户跟踪任务执行状态。
!healthchecks
LinuxServer.io团队提供的此容器具有以下特点:
我们利用docker manifest实现多平台支持。只需拉取 lscr.io/linuxserver/healthchecks:latest 即可获取适合您架构的正确镜像,也可通过标签拉取特定架构镜像。
支持的架构:
| 架构 | 可用 | 标签 |
|---|---|---|
| x86-64 | ✅ | amd64-<version tag> |
| arm64 | ✅ | arm64v8-<version tag> |
通过 <your-ip>:8000 访问Web界面。更多信息请查看 Healthchecks。
完整的环境变量列表请参见 此处。
以下是使用docker-compose或docker cli创建容器的示例。
[!NOTE] 除非标记为“可选”,否则参数为必填项,必须提供值。
--- 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 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端口。
| 参数 | 功能 |
|---|---|
-p 8000:8000 | Healthchecks Web界面端口 |
-p 2525 | 入站SMTP ping端口(可选) |
-e PUID=1000 | 用户ID(详见下方说明) |
-e PGID=1000 | 组ID(详见下方说明) |
-e TZ=Etc/UTC | 时区设置,参考时区列表 |
-e SITE_ROOT= | 网站顶级URL,若端口非80/443需包含端口(如:[***] |
-e SITE_NAME= | 网站名称(如:"示例公司健康检查") |
-e SUPERUSER_EMAIL= | 超级用户邮箱 |
-e SUPERUSER_PASSWORD= | 超级用户密码 |
-e ALLOWED_HOSTS= | 允许的主机名列表(逗号分隔),默认使用SITE_ROOT的域名部分(可选) |
-e APPRISE_ENABLED=False | 设置为True启用Apprise集成([***] |
-e CSRF_TRUSTED_ORIGINS= | 不安全请求(如POST)的可信源列表,默认与SITE_ROOT相同(可选) |
-e DEBUG=True | 设置为False禁用调试模式,调试模式会降低CSRF保护并增加日志详细度,生产环境建议禁用(可选) |
-e DEFAULT_FROM_EMAIL= | 告警邮件的发件人邮箱(可选) |
-e EMAIL_HOST= | SMTP服务器地址(可选) |
-e EMAIL_PORT= | SMTP端口(可选) |
-e EMAIL_HOST_USER= | SMTP用户名(可选) |
-e EMAIL_HOST_PASSWORD= | SMTP密码(可选) |
-e EMAIL_USE_TLS= | 是否使用TLS进行SMTP连接(True或False)(可选) |
-e INTEGRATIONS_ALLOW_PRIVATE_IPS= | 是否允许集成连接私有IP,默认False(可选) |
-e PING_EMAIL_DOMAIN= | 生成ping邮箱地址的域名,默认localhost(可选) |
-e RP_ID= | 使用WebAuthn进行双因素认证时,设置为Healthchecks域名(需HTTPS)(可选) |
-e SECRET_KEY= | 加密签名用的密钥,未提供时会生成随机值并保存到/config/local_settings.py(可选) |
-e SITE_LOGO_URL= | 自定义网站logo的完整URL(可选) |
-v /config | 持久化配置文件目录 |
可通过特殊前缀 FILE__ 从文件中设置环境变量,例如:
-e FILE__MYVAR=/run/secrets/mysecretvariable
这会将环境变量 MYVAR 的值设置为 /run/secrets/mysecretvariable 文件的内容。
所有镜像均支持通过可选参数 -e UMASK=022 覆盖服务的默认umask设置。注意umask是权限掩码,会减少权限而非增加,详情请参考此处。
使用卷(-v参数)时,主机与容器可能出现权限问题。通过指定用户PUID和组PGID可避免此问题。确保主机卷目录的所有者与指定的用户一致。
使用 id your_user 命令可查看当前用户的PUID和PGID:
id your_user
示例输出:
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
我们提供多种Docker Mods以扩展容器功能。上方徽章链接可查看此镜像及通用mods。
容器运行时的Shell访问:
docker exec -it healthchecks /bin/bash
实时监控容器日志:
docker logs -f healthchecks
容器版本号:
docker inspect -f '{{ index .Config.Labels "build_version" }}' healthchecks
镜像版本号:
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/healthchecks:latest
大多数镜像为静态版本化,需更新镜像并重建容器以更新应用。除特殊说明外,不建议在容器内更新应用。
更新镜像:
所有镜像:
docker-compose pull
单个镜像:
docker-compose pull healthchecks
更新容器:
所有容器:
docker-compose up -d
单个容器:
docker-compose up -d healthchecks
清理旧镜像:
docker image prune
更新镜像:
docker pull lscr.io/linuxserver/healthchecks:latest
停止运行中的容器:
docker stop healthchecks
删除容器:
docker rm healthchecks
使用上述docker run参数重建容器(若卷映射正确,/config目录及设置将保留)
清理旧镜像:
docker image prune
[!TIP] 推荐使用Diun接收更新通知。不建议使用自动更新容器的工具。
如需本地修改或自定义镜像:
git clone [***] cd docker-healthchecks docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/healthchecks:latest .
可使用 lscr.io/linuxserver/qemu-static 在x86_64硬件上构建ARM变体:
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
注册后,使用 -f Dockerfile.aarch64 指定架构Dockerfile。
REGENERATE_SETTINGS。git pull确保每个标签容器代码版本一致。local_settings.py输出。
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429