deliverous/certbot

Certbot 镜像文档

概述

Certbot 是电子前哨基金会（EFF）推动互联网全面加密计划的一部分，是一款易用的ACME协议客户端工具。它能从Let's Encrypt（由EFF、Mozilla等发起的开源证书机构）或其他ACME兼容的证书机构获取数字证书，并自动部署到Web服务器，实现HTTPS的配置与管理自动化。Certbot旨在解决传统证书获取与维护的繁琐流程，提供简单命令即可启用和管理HTTPS，且完全免费。

核心功能与特性

支持的Web服务器

• Apache 2.x：通过专用插件自动获取并配置证书
• Nginx 0.8.48+：支持证书获取与配置
• Webroot模式：通过在网站根目录添加验证文件证明域名控制权
• Standalone模式：运行内置简易Web服务器完成域名验证
• 第三方插件：支持其他服务器软件（详情见第三方插件文档）

安全与灵活性

• 私钥在本地系统生成，确保安全性
• 支持Let's Encrypt及其他ACME协议兼容的证书机构
• 支持域名验证（DV）证书的获取与吊销
• 可调整RSA密钥长度（默认2048位，支持4096位等）

自动化与易用性

• 完全自动化的证书获取与续期流程
• 配置变更记录可追溯，支持回滚操作
• 提供交互式文本界面和全命令行驱动两种操作模式
• 支持Apache服务器的HTTP到HTTPS自动重定向配置

开源与兼容性

• 基于Python开发的自由开源软件
• 运行于类Unix操作系统

使用场景与适用范围

Certbot适用于需要为Web服务器配置HTTPS的场景，特别适合：

• 自托管Web服务器（如个人网站、企业内部系统）
• 需要自动化证书管理以减少人工维护的场景
• 希望免费获取可信SSL/TLS证书的用户
• 使用Apache、Nginx等主流Web服务器的环境

注意：Certbot需直接在Web服务器上运行，若使用托管服务且无服务器直接访问权限，可能无法使用，需咨询托管提供商关于证书上传的说明。

使用方法

安装

推荐通过官方网站获取对应Web服务器和操作系统的安装指南：certbot.eff.org

基本使用

交互式运行

多数情况下，直接运行以下命令即可启动交互式向导，引导完成证书获取与安装：

bash
certbot
# 或（部分系统）
certbot-auto

命令行帮助

查看完整命令行选项：

bash
certbot --help all

示例：使用Apache插件获取并安装证书

为多个域名（example.com、[***]

bash
certbot --apache -d example.com -d www.example.com -d other.example.net

首次运行会创建账户，需提供***并同意Let's Encrypt服务条款，可通过--email和--agree-tos参数自动化：

bash
certbot --apache --email admin@example.com --agree-tos -d example.com -d www.example.com

示例：使用Standalone模式获取证书（无插件支持的服务器）

bash
certbot certonly --standalone --email admin@example.com -d example.com -d www.example.com

Docker部署示例

基本Docker运行命令

bash
docker run -it --rm \
  -v /etc/letsencrypt:/etc/letsencrypt \
  -v /var/lib/letsencrypt:/var/lib/letsencrypt \
  -p 80:80 -p 443:443 \
  certbot/certbot certonly --standalone -d example.com

Docker Compose配置示例

yaml
version: '3'
services:
  certbot:
    image: certbot/certbot
    volumes:
      - ./letsencrypt/etc:/etc/letsencrypt
      - ./letsencrypt/lib:/var/lib/letsencrypt
    ports:
      - "80:80"
      - "443:443"
    command: certonly --standalone -d example.com --email admin@example.com --agree-tos

配置参数说明

系统要求

详情请参考官方文档：系统要求

相关链接

• 官方文档：[***]
• 项目源码：https://github.com/certbot/certbot
• 开发者指南：[***]
• 官方网站：[***]
• Let's Encrypt官网：[***]
• 社区支持：[***]
• ACME协议规范：http://ietf-wg-acme.github.io/acme/