fauria/letsencrypt

fauria/letsencrypt

镜像概述

fauria/letsencrypt是一个帮助创建Let's Encrypt SSL证书的Docker镜像。它使用电子前哨基金会（Electronic Frontier Foundation）开发的Certbot客户端来请求、存储证书及相关文件，简化SSL证书的生成流程。

核心功能与特性

• 基于Certbot客户端：集成EFF的Certbot工具，标准化证书申请流程
• 卷挂载支持：通过卷暴露网站根目录和证书存储路径，便于数据持久化
• 自动化证书管理：简化证书生成步骤，减少手动配置工作
• 标准证书格式：生成符合Let's Encrypt规范的证书文件（包含证书、中间证书、完整证书链和私钥）

安装方法

从Docker Hub拉取镜像：

bash
docker pull fauria/letsencrypt

暴露的卷

卷说明

• /web：需挂载网站的可公开访问根目录，用于Let's Encrypt域名验证
• /etc/letsencrypt/archive：存储生成的证书及相关文件的目录

证书文件目录结构

生成的证书文件按域名（FQDN）组织，典型结构如下：

example.com (FQDN)
|-- certX.pem (example.com的证书)
|-- chainX.pem (Let's Encrypt中间证书)
|-- fullchainX.pem (证书与中间证书的组合)
`-- privkeyX.pem (example.com的私钥)

使用场景与示例

创建特定域名的SSL证书

场景说明

为example.com生成证书，网站根目录位于本地/my/website/directory，证书需存储到本地/my/certificates/directory。

执行命令

bash
docker run -v /my/website/directory:/web -v /my/certificates/directory:/etc/letsencrypt/archive fauria/letsencrypt example.com --email example@example.com

参数说明

• -v /my/website/directory:/web：挂载本地网站根目录到容器/web卷，用于域名所有权验证
• -v /my/certificates/directory:/etc/letsencrypt/archive：挂载本地目录到证书存储卷，实现证书持久化
• example.com：指定需生成证书的目标域名（FQDN）
• --email example@example.com：用于接收证书更新通知及重要安全信息的联系***

注意事项

生成的证书有效期为3个月，建议通过cron等定时任务工具定期执行上述命令，实现证书自动更新。