lokios/certbot

docker-certbot镜像文档

镜像概述

docker-certbot是一个集成了Python 2.7.15和Certbot 0.31.0的Docker镜像，旨在提供便捷的SSL/TLS证书自动化管理能力。该镜像通过多线程Python环境提升证书处理效率，适用于需要自动化获取、续期和管理SSL证书的场景。

核心功能与特性

• 环境配置：内置Python 2.7.15（路径：/usr/bin/python），支持多线程处理
• Certbot工具：集成Certbot 0.31.0（路径：/opt/certbot/venv/bin/certbot），支持ACME协议
• 自动化能力：可通过命令行参数配置证书获取、续期等操作
• 轻量级设计：基于Python环境构建，镜像体积精简，部署便捷

使用场景与适用范围

• Web服务器（如Nginx、Apache）的SSL证书配置与自动续期
• 需要批量管理多个域名SSL证书的场景
• 对证书处理效率有要求的多域名证书管理任务
• 自动化运维流程中集成SSL证书管理环节

使用方法与配置说明

基本使用命令

通过docker run命令运行镜像，基本格式如下：

bash
docker run -it --rm \
  -v /path/to/certbot/conf:/etc/letsencrypt \
  -v /path/to/certbot/www:/var/www/certbot \
  docker-certbot certbot certonly --webroot \
  --webroot-path=/var/www/certbot \
  --email your@email.com \
  --agree-tos \
  --no-eff-email \
  -d example.com \
  -d www.example.com

参数说明

• 卷挂载：

  • /etc/letsencrypt：存储证书和配置文件，建议持久化挂载
  • /var/www/certbot：用于Let's Encrypt的webroot验证，需与Web服务器对应目录共享

• Certbot常用命令：

  • certonly：仅获取证书（不自动配置Web服务器）
  • renew：续期所有即将过期的证书
  • --webroot：使用webroot验证方式
  • --email：指定联系人***
  • -d：指定域名（可多个）

证书续期示例

设置定时任务自动续期证书：

bash
# 每月1日执行续期检查
0 0 1 * * docker run --rm \
  -v /path/to/certbot/conf:/etc/letsencrypt \
  -v /path/to/certbot/www:/var/www/certbot \
  docker-certbot certbot renew --quiet

注意事项

• 确保挂载的目录具有正确的读写权限
• 若使用Web服务器，需确保/var/www/certbot目录可被Web服务器访问以完成验证
• Python 2.7已停止官方支持，建议仅在特定依赖场景下使用此版本镜像