fulcrum/certbot

docker-certbot 镜像文档

镜像概述

docker-certbot是一个基于Alpine Linux的Certbot镜像，Certbot是Let's Encrypt的官方客户端工具，用于自动化获取、安装和续期免费的SSL/TLS证书。该镜像以Alpine为基础，确保了轻量级特性，镜像体积小、资源占用低，适合在Docker环境中快速部署和使用。

核心功能和特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，启动速度快，资源消耗低
• Certbot集成：完整集成Certbot客户端，支持Let's Encrypt证书的全生命周期管理
• 证书管理：支持证书的获取、续期、吊销等操作
• 多验证方式：支持HTTP-01、DNS-01等多种域名验证方式
• 跨平台兼容：可与各类Web服务器（如Nginx、Apache）配合使用

使用场景和适用范围

• 需要为网站或Web服务配置SSL/TLS证书的场景
• 希望自动化管理证书续期，避免证书过期的个人或企业用户
• 运行在Docker环境中的Web应用（如Nginx、Apache、Node.js服务等）
• 需在有限资源环境中部署证书管理工具的场景

使用方法和配置说明

基本使用（获取证书）

通过docker run命令运行容器，指定证书获取参数。以下示例通过HTTP-01验证方式获取证书：

bash
docker run --rm \
  -v /path/to/host/certbot/conf:/etc/letsencrypt \
  -v /path/to/host/certbot/www:/var/www/certbot \
  certbot/certbot \
  certonly --webroot \
  -w /var/www/certbot \
  -d example.com \
  -d www.example.com

证书续期

Certbot默认会自动续期即将过期的证书，也可通过以下命令手动触发续期：

bash
docker run --rm \
  -v /path/to/host/certbot/conf:/etc/letsencrypt \
  -v /path/to/host/certbot/www:/var/www/certbot \
  certbot/certbot \
  renew

卷挂载说明

为了持久化存储证书和配置，需挂载以下目录：

• /etc/letsencrypt：存储证书文件、私钥和配置信息
• /var/www/certbot：用于HTTP-01验证的临时webroot目录（需与Web服务器配置对应）

常用命令参数

• certonly：仅获取证书，不自动安装到Web服务器
• --webroot：使用webroot验证方式（需确保Web服务器将/.well-known/acme-challenge/路径指向/var/www/certbot）
• -w：指定webroot目录路径
• -d：指定要获取证书的域名（可多次使用指定多个域名）
• renew：检查并续期所有即将过期的证书
• --dry-run：测试模式，不实际执行证书操作

Docker Compose 示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  certbot:
    image: certbot/certbot
    volumes:
      - ./certbot/conf:/etc/letsencrypt
      - ./certbot/www:/var/www/certbot
    command: certonly --webroot -w /var/www/certbot -d example.com -d www.example.com

运行：

bash
docker-compose up