atomgraph/certbot

Certbot Docker镜像文档

镜像概述和主要用途

Certbot是一个简单易用的自动客户端，用于为Web服务器获取和部署SSL/TLS证书。该Docker镜像封装了Certbot工具，使其可以通过容器化方式便捷使用。Certbot由EFF等机构开发，最初作为Let's Encrypt的官方客户端（曾称为"Let's Encrypt Python客户端"），同时支持所有兼容ACME协议的证书颁发机构（CA）。

核心功能和特性

• 自动证书管理：自动完成证书的申请、获取和部署流程
• 多插件支持：提供Apache、Webroot、Standalone等多种插件，适配不同Web服务器环境
• ACME协议兼容：支持Let's Encrypt及所有遵循ACME协议的证书颁发机构
• 容器化部署：通过Docker容器运行，简化环境配置和依赖管理

使用场景和适用范围

• 需要为Web服务器配置SSL/TLS证书的场景
• 希望自动化证书申请、更新流程的用户
• 使用Apache、Nginx等Web服务器的环境
• 需要通过ACME协议获取免费SSL证书的个人或企业用户

使用方法和配置说明

使用Apache插件启动Certbot实例

最简单的启动方式如下：

shell
docker container run -it \
       --rm \
       --net host \
       -v /etc/letsencrypt:/etc/letsencrypt \
       -v /var/lib/letsencrypt:/var/lib/letsencrypt \
       -v /var/www:/var/www \
       palobo/certbot -t install --apache -d DOMAIN

参数说明：

• DOMAIN：要申请证书的域名，多个域名可使用多个-d参数

使用Webroot插件启动Certbot实例

shell
docker container run -it \
       --rm \
       -v /etc/letsencrypt:/etc/letsencrypt \
       -v /var/www:/var/www \
       palobo/certbot -t certonly --webroot -w WEBROOT_PATH -d DOMAIN

参数说明：

• WEBROOT_PATH：网站根目录路径（如public_html），可多次指定以对应不同域名
• DOMAIN：要申请证书的域名，多个域名可使用多个-d参数

使用Standalone插件启动Certbot实例

shell
docker container run -it \
       --rm \
       -p 443:443 \
       -v /etc/letsencrypt:/etc/letsencrypt \
       -v $(pwd)/log:/var/log/letsencrypt \
       palobo/certbot certonly --standalone \
       -t -m me@myemail.com -d my.domain.com

访问容器

如需进入容器进行故障排查或其他操作，可通过以下命令绕过入口点：

shell
docker container run -it \
                 --entrypoint /bin/sh \
                 palobo/certbot

暴露端口

• 80：HTTP端口，用于证书验证
• 443：HTTPS端口，用于证书验证

导出卷

• /etc/letsencrypt：存储证书和配置文件的目录，建议持久化挂载以保留证书数据