nbraun1/certbot Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Certbot Docker镜像文档

镜像概述

本镜像为Certbot的Docker化部署版本，Certbot是Let's Encrypt提供的官方客户端工具，用于自动化SSL/TLS证书的获取、签发与续期流程，帮助用户快速为Web服务配置HTTPS，简化证书管理流程。

核心功能与特性

• 自动化证书管理：自动完成Let's Encrypt证书的申请、签发与续期，无需手动操作
• 多验证方式支持：支持HTTP-01（通过Web服务器验证）和DNS-01（通过DNS记录验证）等多种域名验证方式
• 跨平台兼容：基于Docker容器化部署，可在任何支持Docker的环境中运行
• 轻量级设计：镜像体积优化，运行资源占用低

使用场景与适用范围

• 个人或企业网站需要配置HTTPS的场景
• 需频繁管理多个域名证书的Web服务
• 希望简化证书续期流程，避免证书过期风险的场景
• 与Nginx、Apache等Web服务器配合使用的部署环境

使用方法与配置说明

基本使用（Docker Run）

获取证书的基础命令示例（HTTP-01验证）：

bash
docker run -it --rm \
  -v "/etc/letsencrypt:/etc/letsencrypt" \
  -v "/var/www/html:/var/www/html" \
  nbraun1/certbot certonly \
  --webroot \
  --webroot-path=/var/www/html \
  --email *** \
  --agree-tos \
  --no-eff-email \
  -d example.com \
  -d [***]

参数说明

• -v "/etc/letsencrypt:/etc/letsencrypt": 挂载证书存储目录，持久化保存证书文件
• -v "/var/www/html:/var/www/html": 挂载Web根目录，用于HTTP-01验证
• certonly: 仅获取证书，不自动配置Web服务器
• --webroot: 使用Webroot验证方式
• --webroot-path: 指定Web根目录路径
• --email: 用于接收证书更新通知的***
• --agree-tos: 同意Let's Encrypt服务条款
• --no-eff-email: 不向EFF（电子前哨基金会）发送邮件
• -d: 指定需要签发证书的域名（可多次指定多个域名）

证书续期

Certbot默认会自动续期即将过期的证书，可通过以下命令手动触发续期检查：

bash
docker run -it --rm \
  -v "/etc/letsencrypt:/etc/letsencrypt" \
  -v "/var/www/html:/var/www/html" \
  nbraun1/certbot renew

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  certbot:
    image: nbraun1/certbot
    volumes:
      - ./letsencrypt:/etc/letsencrypt
      - ./www:/var/www/html
    command: certonly --webroot --webroot-path=/var/www/html --email *** --agree-tos --no-eff-email -d example.com -d [***]

运行：docker-compose up

详细文档

完整使用说明和高级配置可参考项目GitHub仓库：[***]