zeigren/healthchecks

Healthchecks的Docker部署栈

!https://img.shields.io/docker/image-size/zeigren/healthchecks/latest !https://img.shields.io/docker/pulls/zeigren/healthchecks

链接

https://hub.docker.com/r/zeigren/healthchecks

https://ghcr.io/zeigren/healthchecks_docker

https://github.com/Zeigren/healthchecks_docker

标签

• latest
• v1.21.0
• v1.20.0

技术栈

• Python:Alpine - 运行Healthchecks服务
• Caddy 或 NGINX - Web服务器

使用方式

通过https://docs.docker.com/compose/%E6%88%96https://docs.docker.com/engine/swarm/%E9%83%A8%E7%BD%B2%E3%80%82%E5%AE%B9%E5%99%A8%E5%8F%AF%E4%BB%8EDocker Hub和GitHub Container Registry获取。

提供使用Caddy、NGINX作为Web服务器的示例，以及使用Caddy、NGINX或Traefik实现HTTPS的示例（Traefik示例包含反向代理功能）。NGINX相关示例位于nginx文件夹中。

推荐建议

推荐使用Caddy作为Web服务器，可直接处理HTTPS（通过ACME自动获取Let's Encrypt/ZeroSSL证书，或生成自签名证书用于本地环境），或与Traefik配合使用。

建议优先使用Docker Swarm而非Docker Compose，因为Swarm支持https://docs.docker.com/engine/swarm/secrets/%E5%92%8Chttps://docs.docker.com/engine/swarm/configs/%E3%80%82

若Caddy不适用或追求性能，可参考NGINX示例。NGINX具有高度可配置性，适合高用户量场景。

配置说明

配置通过在.yml文件中设置环境变量实现。更多Healthchecks配置变量可在docker-entrypoint.sh中找到，Caddy配置变量在bookstack_caddyfile中。

设置DOMAIN变量可控制Caddy使用HTTP、自签名HTTPS证书或Let's Encrypt/ZeroSSL证书，详情参考Caddyhttps://caddyserver.com/docs/automatic-https。

首次运行需创建超级用户：进入容器执行python manage.py createsuperuser。

Docker Swarm部署

推荐与Traefik反向代理配合使用（示例traefik.yml可选）。需创建对应的Docker Secrets和Configs。Healthchecks的环境变量可通过Docker Secrets设置（相关.yml文件中有示例）。

部署命令：

bash
docker stack deploy --compose-file docker-swarm.yml healthchecks

Docker Compose部署

部署命令：

bash
docker-compose -f docker-compose.yml up -d

通过127.0.0.1:9080访问服务。

性能调优

Web服务器设置HTTP头以实现浏览器缓存优化（缓存同时检查文件更新）。若内容更新频率低，可调整缓存策略减少请求量。

Gunicorn工作进程数可通过GUNICORN_WORKERS环境变量设置。

运行原理

Dockerfile采用多阶段构建、构建钩子和标签实现Docker Hub自动构建。多阶段构建先创建包含Python依赖的构建容器，再将虚拟环境复制到生产容器，确保轻量化。

容器启动时先执行docker-entrypoint.sh脚本，再运行gunicorn。docker-entrypoint.sh根据.yml文件中的环境变量生成配置文件并执行命令。env_secrets_expand.sh处理Docker Secrets的使用。