jsongo/certbot

Certbot 镜像文档

镜像概述和主要用途

Certbot是电子前哨基金会（EFF）发起的项目，旨在推动整个互联网的加密通信。它是一个易用的客户端工具，能够从Let's Encrypt（由EFF、Mozilla等机构发起的开放证书颁发机构）获取数字证书，并将其部署到Web服务器，实现HTTPS加密。Certbot解决了传统证书获取和维护的繁琐流程，通过自动化操作让用户轻松启用和管理HTTPS，且完全免费。

核心功能和特性

支持多种Web服务器

• Apache 2.x：提供beta级自动配置支持
• Nginx 0.8.48+：提供alpha级自动配置支持
• Webroot：通过在网站根目录添加验证文件证明域名控制权
• Standalone：运行独立简易Web服务器完成域名验证
• 第三方插件：支持其他服务器软件（通过第三方插件扩展）

安全与灵活性

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

自动化与易用性

• 完全自动化的证书获取、部署和续期流程
• 配置变更记录可追溯，支持回滚操作
• 提供ncurses图形界面、文本界面（-t）及纯命令行操作模式
• 支持HTTP到HTTPS重定向配置（仅Apache）

开源与兼容性

• 免费开源软件，基于Python开发
• 运行于类Unix操作系统

使用场景和适用范围

• 个人或企业网站需要启用HTTPS加密
• 管理多个域名的SSL/TLS证书
• 希望自动化证书续期（Let's Encrypt证书有效期为90天）
• 使用Apache、Nginx等主流Web服务器的环境
• 需要免费SSL/TLS证书的场景

详细使用方法和配置说明

安装指南

最简便的安装方式是访问certbot.eff.org，根据Web服务器和操作系统组合获取针对性安装说明。更多信息参见Get Certbot。

运行客户端

交互式模式

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

bash
certbot
# 或
certbot-auto

命令行帮助

查看完整命令行选项：

bash
certbot --help all

示例命令

1. 使用Apache插件获取并安装证书（适用于example.com、[***]

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

首次运行时需创建账户，可通过--email指定***，--agree-tos自动同意服务条款：

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

2. 使用Standalone模式获取证书（适用于无完整插件支持的Web服务器）：

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

3. 使用Webroot模式获取证书（通过网站根目录验证域名）：

bash
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com

Docker部署示例

基本Docker run命令（Webroot模式）

bash
docker run -it --rm \
  -v /etc/letsencrypt:/etc/letsencrypt \
  -v /var/www/html:/var/www/html \
  certbot/certbot certonly \
  --webroot \
  -w /var/www/html \
  --email admin@example.com \
  --agree-tos \
  -d example.com \
  -d www.example.com

Docker Compose示例

yaml
version: '3'
services:
  certbot:
    image: certbot/certbot
    volumes:
      - /etc/letsencrypt:/etc/letsencrypt
      - /var/www/html:/var/www/html
    command: certonly --webroot -w /var/www/html --email admin@example.com --agree-tos -d example.com -d www.example.com

核心配置参数说明

深入理解客户端

Certbot的核心是插件系统，不同插件对应不同的证书获取和部署方式。详细了解插件机制可参考用户指南中的插件说明。

相关链接

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

系统要求

参见系统要求文档。