codenetjp/certbot

镜像概述

本镜像基于官方certbot/certbot镜像构建，额外集成了AWS CLI工具、DNS查询工具集(bind-tools)和Docker客户端，旨在提供一个一站式环境，用于在Docker环境中管理SSL证书，同时支持与AWS服务的交互及DNS相关操作。

核心功能与特性

• Certbot基础功能：继承官方Certbot镜像的全部功能，支持通过ACME协议获取、续期和管理SSL/TLS证书
• AWS CLI集成：预装AWS命令行工具，可直接与AWS服务（如Route53、S3等）交互，便于实现基于AWS的证书验证和管理流程
• DNS工具集：包含bind-tools（提供dig、nslookup等命令），支持DNS查询与调试
• Docker客户端：内置Docker命令行工具，可与Docker守护进程通信，实现容器生命周期管理

使用场景

• 需要在Docker环境中自动化SSL证书申请、续期流程的场景
• 采用AWS Route53进行DNS验证的证书申请场景
• 需要在容器内部执行DNS查询或调试网络问题的场景
• 需要在容器环境中管理其他Docker容器的场景

使用方法与配置说明

基本使用

通过以下命令启动容器：

bash
docker run -it --rm \
  -v /path/to/certbot/data:/etc/letsencrypt \
  -v /path/to/certbot/logs:/var/log/letsencrypt \
  [镜像名称] [命令]

环境变量配置

根据需要设置以下环境变量（主要用于AWS CLI配置）：

• AWS_ACCESS_KEY_ID：AWS访问密钥ID
• AWS_SECRET_ACCESS_KEY：AWS密钥
• AWS_DEFAULT_REGION：AWS默认区域（如us-east-1）

典型操作示例

1. 运行Certbot命令获取证书（HTTP验证）

bash
docker run -it --rm \
  -p 80:80 \
  -v /path/to/certbot/data:/etc/letsencrypt \
  [镜像名称] certonly --standalone -d example.com

2. 使用AWS CLI管理Route53记录（用于DNS验证）

bash
docker run -it --rm \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -e AWS_DEFAULT_REGION=us-east-1 \
  [镜像名称] aws route53 list-hosted-zones

3. 执行DNS查询（dig命令）

bash
docker run -it --rm [镜像名称] dig example.com

4. 与Docker守护进程交互

bash
docker run -it --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  [镜像名称] docker ps

持久化数据

建议将Certbot数据目录（/etc/letsencrypt）和日志目录（/var/log/letsencrypt）挂载到宿主机，以持久化证书和日志数据：

bash
docker run -it --rm \
  -v $(pwd)/certbot/data:/etc/letsencrypt \
  -v $(pwd)/certbot/logs:/var/log/letsencrypt \
  [镜像名称] certbot renew