itherz/certbot

docker-certbot

镜像概述和主要用途

docker-certbot是一个基于Alpine Linux的Docker镜像，集成了Let's Encrypt的官方客户端Certbot。该镜像旨在提供轻量级、便捷的SSL/TLS证书管理解决方案，用于自动化获取、续期和管理Let's Encrypt颁发的免费SSL证书，适用于各类需要HTTPS配置的服务器环境。

核心功能和特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 完整Certbot功能：支持Certbot的所有标准命令和验证方式（如standalone、webroot等）
• 证书持久化：通过卷挂载实现证书文件和配置的持久化存储
• 网络灵活性：支持主机网络模式，确保证书验证过程中端口可访问

使用场景和适用范围

• 为Web服务器（如Nginx、Apache）快速配置SSL/TLS证书
• 自动化管理证书续期，避免证书过期
• 在Docker环境中部署Certbot，简化依赖管理
• 个人或小型企业网站的HTTPS证书获取和维护

使用方法和配置说明

基本使用命令

以下示例通过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 你的域名.com "$@"

参数说明

• -it：启用交互式终端，用于输入必要信息（如***地址）
• --rm：容器退出后自动删除，避免残留容器
• --net host：使用主机网络模式，使Certbot能直接监听主机的80/443端口进行验证
• -v /etc/letsencrypt:/etc/letsencrypt：挂载证书存储目录，持久化保存证书文件和配置
• -v /var/lib/letsencrypt:/var/lib/letsencrypt：挂载Certbot工作目录，存储临时文件和日志

暴露端口

• 80：用于Let's Encrypt的HTTP-01验证
• 443：用于Let's Encrypt的TLS-ALPN-01验证

卷挂载

• /etc/letsencrypt：核心证书存储目录，包含证书文件、私钥和配置
• /var/lib/letsencrypt：Certbot工作目录，包含临时验证文件和操作日志