11notes/certbot

🏔️ Alpine - Certbot

!size !version !pulls

镜像概述和主要用途

本镜像基于Alpine Linux构建，可通过不同模块从Let’s Encrypt获取SSL证书。它会启动Nginx Web服务器以处理HTTP挑战，生成多种类型的证书（如*.pfx、*.pk8）及包含所有文件的tar包，并在证书更新时（成功或失败）调用可选的Webhook。此外，它会将所有非Certbot的HTTP请求永久重定向至HTTPS。

核心功能和特性

• 多模块支持：通过不同模块（如rfc2136）从Let’s Encrypt获取证书
• 证书管理：自动创建、更新证书，清理过期证书
• 多证书格式：生成*.pfx、*.pk8等多种证书格式及tar包
• Webhook/脚本支持：证书更新时可调用Webhook或自定义脚本
• HTTP重定向：非Certbot的HTTP请求自动重定向至HTTPS
• 轻量级：基于Alpine Linux，体积小、资源占用低

支持的第三方系统

• Horizon View Unified Access Gateway
• Traefik Dynamic Configuration

使用场景和适用范围

适用于无法通过Traefik等反向代理自动更新证书的系统，如数据库认证、MQTT、SMTP、RDP等需要有效SSL证书的场景。通过Webhook可将更新后的证书同步至这些非代理系统。

详细使用方法和配置说明

卷挂载

配置示例

config.yaml配置（/certbot/etc/config.yaml）

yaml
certificates:
  # 名称必须唯一，用于文件名，最多支持100个FQDN或通配符

  - name: "com.domain"
    email: "info@domain.com"
    fqdn:
      - "*.domain.com"
      - "*.www.domain.com"

  # 定义使用的模块
  - name: "com.domain.dns"
    email: "info@domain.com"
    module:
      rfc2136:
        server: 10.255.255.53
        port: 53
        name: "certbot."
        secret: "**"
        algorithm: "HMAC-SHA512"
        propagation_seconds: 30
    fqdn:
      - "*.domain.com"

  - name: "com.domain.dns.credentials"
    email: "info@domain.com"
    module:
      rfc2136:
        credentials: "/certbot/etc/com.domain.ini"
    fqdn:
      - "*.domain.com"

  # 使用RSA而非ECDSA
  - name: "com.domain.rsa"
    email: "info@domain.com"
    key: rsa
    fqdn:
      - "*.domain.com"

  # 调用Webhook
  - name: "com.domain.webhook"
    email: "info@domain.com"
    webhook: https://domain.com/certbot
    fqdn:
      - "*.domain.com"

  # 调用脚本
  - name: "com.domain.script"
    email: "info@domain.com"
    script: /certbot/scripts/vmware.horizon.uag.sh
    key: rsa
    fqdn:
      - "*.domain.com"

Traefik HTTP重定向配置

将HTTP:80请求重定向至Certbot容器：

(HostRegexp(`{host:.+}`) && PathPrefix(`/.well-known/acme-challenge`))

默认设置

环境变量

可用模块

证书更新

配置完成后，可通过以下命令定期更新证书：

bash
docker exec certbot renew

相关信息

源码

• https://github.com/11notes/docker-certbot/tree/2.11.0

基础镜像

• https://hub.docker.com/r/11notes/nginx

构建组件

• certbot
• nginx
• alpine

提示

• 使用Traefik、Nginx等反向代理终止TLS，使用有效证书
• 使用Let’s Encrypt证书保护SSL端点

ElevenNotes^™️

本镜像的使用风险由您自行承担。更新镜像至新版本前请务必备份。请查看变更日志了解可能的破坏性更新。您可以在https://github.com/11notes%E4%B8%8A%E6%89%BE%E5%88%B0%E6%88%91%E7%9A%84%E6%89%80%E6%9C%89%E4%BB%93%E5%BA%93%E3%80%82