caprover/certbot-sleeping

Certbot Docker镜像（修改版）

镜像概述

本镜像基于官方certbot/certbot镜像构建，针对原镜像运行后立即退出的问题进行了优化。通过调整ENTRYPOINT和CMD配置，使容器能够持续运行，解决了原镜像难以作为Docker服务使用的问题，适用于需要在Docker环境中长期运行Certbot进行SSL证书管理的场景。

核心功能与特性

1. 继承官方Certbot功能

完整保留官方certbot/certbot镜像的所有核心功能，包括证书申请、续期、吊销等SSL证书管理能力。

2. 持续运行支持

通过修改CMD为sleep 9999d，确保容器启动后不会立即退出，可作为Docker服务长期运行。

3. 灵活命令执行

ENTRYPOINT设置为['/bin/sh','-c']，支持通过覆盖CMD参数执行任意Certbot命令或自定义操作。

使用场景

• 需要在Docker环境中长期运行Certbot进行证书自动续期的场景
• 作为Docker服务部署，需保持容器持续运行以响应证书管理操作的场景
• 需要在容器内执行多次Certbot命令而无需反复启动容器的场景

使用方法

基本运行命令

启动一个持续运行的Certbot容器：

bash
docker run -d --name certbot-service your-image-name

执行Certbot命令

通过覆盖CMD参数执行具体的Certbot操作，例如申请证书：

bash
docker run --rm your-image-name "certbot certonly --webroot -w /var/www/html -d example.com"

进入容器执行命令

若需在运行中的容器内执行多次操作，可通过exec进入容器：

bash
docker exec -it certbot-service /bin/sh
# 在容器内执行Certbot命令
certbot renew

数据持久化

为保证证书和配置持久化，建议挂载本地目录：

bash
docker run -d --name certbot-service \
  -v /path/to/local/certbot/conf:/etc/letsencrypt \
  -v /path/to/local/certbot/www:/var/www/certbot \
  your-image-name

配置说明

环境变量

继承自官方certbot/certbot镜像的所有环境变量，具体可参考https://hub.docker.com/r/certbot/certbot/%E3%80%82

自定义启动命令

可通过修改CMD参数自定义容器启动后的行为，例如：

bash
# 启动后执行自定义脚本
docker run your-image-name "/path/to/your/script.sh"

注意事项

• 本镜像仅修改了启动配置，核心Certbot功能与官方镜像完全一致
• 长期运行时建议配置自动续期任务（如通过crontab或Docker Compose的健康检查）
• 生产环境中需确保挂载的证书目录有适当的权限控制