oldzhuang/certbot

Certbot 镜像文档

镜像概述和主要用途

Certbot是电子前哨基金会（EFF）加密互联网计划的核心工具，作为ACME协议客户端，能够从Let's Encrypt（由EFF、Mozilla等发起的开源证书机构）获取免费SSL/TLS证书，并自动部署到Web服务器。它解决了传统证书获取与维护的繁琐流程，通过简单命令即可实现HTTPS的启用和管理，全程自动化且无需支付费用。

核心功能和特性

多Web服务器支持

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

安全与灵活性

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

自动化与易用性

• 全自动化证书获取、部署和续期流程
• 可选配置HTTP到HTTPS重定向（仅Apache）
• 配置更改记录可追溯且支持恢复
• 提供ncurses图形界面、文本界面及纯命令行操作模式
• 基于Python开发的自由开源软件，无使用成本

使用场景和适用范围

适用场景

• 个人或企业网站需要启用HTTPS以提升数据传输安全性
• Web服务器管理员需要简化证书管理流程，实现自动续期
• 需为多个域名（如example.com、[***]
• 希望避免手动处理证书申请、配置和更新的用户

不适用场景

• 使用托管服务且无Web服务器直接访问权限的用户（需咨询托管提供商关于证书上传或Let's Encrypt支持）
• 非Unix类操作系统（Certbot目前仅支持类Unix系统）

使用方法和配置说明

安装指南

推荐通过官方网站获取针对特定Web服务器和操作系统的详细安装说明：Certbot安装指南

基本使用方法

交互式运行

直接执行以下命令启动交互式向导，引导完成证书获取和安装：

bash
certbot
# 或部分系统使用
./certbot-auto

命令行帮助

查看完整命令行选项：

bash
certbot --help all
# 或
./certbot-auto --help all

典型使用示例

1. 使用Apache插件自动配置证书 为多个域名获取证书并通过Apache插件自动配置：

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

首次运行可添加参数自动化账户创建：

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

2. 使用Standalone模式获取证书 适用于无插件支持的Web服务器，通过内置Web服务器验证域名：

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 \
  certbot/certbot certonly --standalone -d example.com

Docker Compose配置示例

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

系统要求

• 操作系统：类Unix系统（Linux、BSD等）
• Python版本：2.6或2.7（未来计划支持Python 3.x）
• 权限要求：通常需要root权限，以写入配置目录（/etc/letsencrypt、/var/log/letsencrypt、/var/lib/letsencrypt）、绑定80/443端口（Standalone模式）及修改Web服务器配置
• Apache插件额外要求：Debian-based系统（Ubuntu 12.04+、Debian 7+）及augeas 1.0+

相关链接

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