lsowen/certbot

docker-certbot 镜像文档

镜像概述和主要用途

docker-certbot是一个基于Alpine Linux的Let's Encrypt客户端Docker镜像，用于获取、更新和管理免费的SSL/TLS证书。作为gzm55/certbot的分支版本，它继承了轻量级特性，适合在容器环境中快速部署，为Web服务等提供安全的HTTPS支持。

核心功能和特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 证书管理：支持通过Let's Encrypt自动获取、续期SSL/TLS证书
• 灵活部署：兼容Docker容器化部署模式，便于集成到CI/CD流程
• 数据持久化：通过卷挂载实现证书和配置数据的持久化存储

使用场景和适用范围

适用于需要SSL/TLS证书的各类Web服务（如Nginx、Apache）、API服务等场景，尤其适合容器化部署的应用，可自动化完成证书的申请与更新流程。

使用方法和配置说明

基本部署命令

以下命令用于获取指定域名的SSL证书（将xxx.com替换为实际域名）：

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 xxx.com "$@"

命令参数说明：

• -it：以交互模式运行容器，支持命令行输入
• --rm：容器运行结束后自动删除，避免残留容器
• --net host：使用主机网络模式，确保Let's Encrypt验证服务器能访问到容器
• -v /etc/letsencrypt:/etc/letsencrypt：挂载证书存储目录，持久化保存证书文件
• -v /var/lib/letsencrypt:/var/lib/letsencrypt：挂载客户端工作目录，存储临时文件和日志
• certonly --standalone --text -d xxx.com：Certbot核心命令，指定以独立模式获取文本格式的证书，目标域名为xxx.com

暴露端口

容器默认暴露以下端口，用于Let's Encrypt的域名验证：

• 80：HTTP-01验证端口
• 443：HTTPS-01验证端口

数据卷

为确保证书和配置数据不丢失，需挂载以下关键卷：

• /etc/letsencrypt：存储证书文件、私钥和配置信息
• /var/lib/letsencrypt：存储客户端工作文件、日志和临时数据