gzm55/certbot

docker-certbot 镜像文档

镜像概述

docker-certbot是一个基于Alpine Linux的Let's Encrypt客户端Docker镜像，旨在简化SSL/TLS证书的获取、续期和管理流程，适用于Docker环境下的HTTPS配置需求。

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 完整证书管理：支持Let's Encrypt证书的获取、续期和管理操作
• 数据持久化：通过卷挂载确保证书和配置数据持久化存储
• 网络兼容性：支持主机网络模式，便于端口监听和ACME协议验证

使用场景

适用于需要为网站、API服务或其他网络服务配置HTTPS的场景，特别适合Docker环境下的证书自动化管理，如Web服务器（Nginx、Apache）的SSL证书配置。

使用方法

基本使用命令

以下命令通过standalone模式获取证书（需确保主机80/443端口未被占用）：

bash
docker run -it \
           --rm \
           --net host \
           -v /etc/letsencrypt:/etc/letsencrypt \
           -v /var/lib/letsencrypt:/var/lib/letsencrypt \
           gzm55/certbot certonly --standalone --text -d example.com "$@"

参数说明

• -it：启用交互式终端模式
• --rm：容器退出后自动删除
• --net host：使用主机网络模式，直接使用主机的网络栈
• -v /etc/letsencrypt:/etc/letsencrypt：挂载证书存储目录，保存生成的证书和配置
• -v /var/lib/letsencrypt:/var/lib/letsencrypt：挂载Let's Encrypt工作目录，存储客户端状态和临时文件

暴露端口

• 80：用于HTTP-01挑战验证（Let's Encrypt ACME协议必要端口）
• 443：用于TLS-ALPN-01挑战验证（部分验证场景需要）

卷挂载说明

• /etc/letsencrypt：核心证书存储目录，包含私钥、证书链和配置文件
• /var/lib/letsencrypt：客户端工作目录，存储账户信息、挑战文件和状态数据