atsnngs/certbot

Certbot 镜像文档

镜像概述和主要用途

Certbot（前身为Let's Encrypt客户端）是一个功能全面、可扩展的ACME协议客户端，用于自动化获取Let's Encrypt CA（或其他ACME兼容CA）的SSL证书，并配置Web服务器使用这些证书。该客户端运行在类Unix操作系统上。注意：Certbot目前为BETA软件，可能存在bug和不完善之处，建议在生产环境使用前先在测试环境充分测试。

核心功能和特性

• 多Web服务器支持：
  • Apache 2.x（支持Debian 8+和Ubuntu 12.04+）
  • Standalone（运行简单Web服务器以验证域名控制权）
  • Webroot（通过在Web根目录添加文件验证域名控制权）
  • Nginx 0.8.48+（高度实验性，未包含在certbot-auto中）
• 私钥在本地系统生成
• 可与Let's Encrypt CA或其他ACME兼容服务通信
• 支持获取域名验证（DV）证书
• 支持吊销证书
• 可调整RSA密钥长度（默认2048位，支持4096位等）
• 可选安装HTTP到HTTPS重定向（仅Apache）
• 完全自动化操作
• 配置更改记录且可恢复
• 支持ncurses和文本UI，或完全通过命令行驱动
• 免费开源软件，基于Python开发

使用场景和适用范围

• 需要为Web服务器（如Apache、Nginx）配置SSL/TLS证书的场景
• 希望自动化证书获取、续期和配置的用户
• 运行类Unix操作系统且满足Python 2.6/2.7环境要求的服务器
• 需要管理多个域名证书的场景

系统要求

• 操作系统：类Unix系统
• Python版本：2.6或2.7（未来计划支持Python 3.x）
• 权限：需要root权限以写入/etc/letsencrypt、/var/log/letsencrypt、/var/lib/letsencrypt，绑定80/443端口（使用standalone插件时），以及读取/修改Web服务器配置（使用apache或nginx插件时）
• Apache插件额外要求：基于Debian的操作系统，augeas版本1.0（包括Ubuntu 12.04+和Debian 7+）

详细使用方法和配置说明

安装方法

如果您的Unix操作系统已打包certbot（或letsencrypt），可直接从系统包管理器安装，安装后通过certbot（或letsencrypt）命令运行。对于尚未提供包的系统，可通过certbot-auto脚本临时解决方案：

bash
user@webserver:~$ wget https://dl.eff.org/certbot-auto
user@webserver:~$ chmod a+x ./certbot-auto
user@webserver:~$ ./certbot-auto --help

验证脚本完整性：可通过以下步骤验证certbot-auto脚本完整性：

bash
user@server:~$ wget -N https://dl.eff.org/certbot-auto.asc
user@server:~$ gpg2 --recv-key A2CFB51FA275A7286234E7B24D17C995CD9775F2
user@server:~$ gpg2 --trusted-key 4D17C995CD9775F2 --verify certbot-auto.asc certbot-auto

查看完整命令行帮助：

bash
./certbot-auto --help all

certbot-auto会自动更新到最新客户端版本，且作为certbot的包装器，接受完全相同的命令行参数。

运行客户端

交互式模式

在许多情况下，直接运行certbot-auto或certbot，客户端会引导您交互式完成证书获取和安装过程。

命令行模式

可通过命令行指定具体操作。例如，为example.com、www.example.com和other.example.net获取证书，并使用Apache插件自动安装：

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

首次运行时会创建账户，需提供***并同意Let's Encrypt订阅协议，可通过--email和--agree-tos参数自动化这些步骤：

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

对于尚未完全支持插件的Web服务器，可使用standalone或webroot插件获取证书：

bash
./certbot-auto certonly --standalone --email admin@example.com -d example.com -d www.example.com -d other.example.net

深入理解客户端

要详细了解客户端工作原理，需理解其插件使用方式，详见插件说明。

相关链接

• 文档：[***]
• 软件项目：https://github.com/certbot/certbot
• 开发者说明：[***]
• 主网站：[***]
• IRC频道：Freenode上的#letsencrypt或OFTC上的#certbot
• 社区：[***]
• ACME规范：http://ietf-wg-acme.github.io/acme/
• ACME工作区：https://github.com/ietf-wg-acme/acme
• 邮件列表：client-dev（无Google账户可发送邮件至***订阅）