dockersf/letsencrypt-manager

docker-letsencrypt-manager镜像说明

镜像概述

本Docker镜像用于管理域名和Let's Encrypt证书，并支持自动续期。它基于官方Let's Encrypt Docker镜像，采用ACME webroot方法进行域名验证，实现零停机证书续期。

核心功能

• 域名证书管理：支持添加、删除、列出已配置的域名及证书状态
• 自动续期：通过cron任务定期检查并续期即将过期的证书
• 自定义配置：可设置***、RSA密钥大小、cron执行时间等环境变量
• 零停机续期：基于ACME webroot验证，无需停止服务即可完成续期
• 钩子支持：提供续期前后的钩子命令，用于触发后续操作（如重载Web服务器）

使用场景

• 需要为多个域名管理SSL证书的网站服务
• 使用HAProxy/Nginx作为反向代理，需自动续期证书的场景
• 希望简化Let's Encrypt证书申请与续期流程的运维场景

配置说明

环境变量配置

在.env文件中定义以下可选变量：

• LE_EMAIL：Let's Encrypt使用的***（未设置则交互式询问）
• LE_RSA_KEY_SIZE：RSA密钥大小（默认使用官方默认值）
• CRON_TIME：自动续期cron任务时间（标准cron格式，默认每周）
• LE_PRE_HOOK：续期前执行的钩子命令
• LE_POST_HOOK：续期后执行的钩子命令
• AUTO_RENEW_CHECK_SUCCESS_URL：续期成功后通知的URL（如healthchecks.io）

卷挂载

需挂载以下卷：

• /etc/letsencrypt：Let's Encrypt客户端配置目录
• /var/lib/letsencrypt：客户端工作目录
• /var/acme-webroot：ACME webroot验证数据目录

Web服务器准备

确保Web服务器暴露ACME webroot目录，推荐使用：

• HAProxy：https://github.com/bringnow/docker-haproxy-letsencrypt%EF%BC%88%E9%9B%B6%E5%81%9C%E6%9C%BA%E7%BB%AD%E6%9C%9F+%E8%87%AA%E5%8A%A8%E9%87%8D%E8%BD%BD%EF%BC%89
• Nginx：https://github.com/bringnow/docker-nginx-letsencrypt%EF%BC%88%E9%9B%B6%E5%81%9C%E6%9C%BA%E7%BB%AD%E6%9C%9F+%E8%87%AA%E5%8A%A8%E9%87%8D%E8%BD%BD%EF%BC%89

部署示例

安装步骤

1. 克隆仓库：

bash
cd /opt/ && git clone https://github.com/gitsf/docker-letsencrypt-manager.git && cd docker-letsencrypt-manager

2. 添加别名（可选）：

bash
echo alias letsencrypt-manager=\'/opt/docker-letsencrypt-manager/letsencrypt-manager\' >> ~/.bashrc && source ~/.bashrc

3. 验证安装：

bash
letsencrypt-manager help

常用命令

• 列出证书状态：

bash
letsencrypt-manager list

• 添加新域名：

bash
letsencrypt-manager add <主域名> [备选域名1] [备选域名2]...

• 启动自动续期：

bash
./update-cron.sh

• 手动续期：

bash
letsencrypt-manager renew <域名> [备选域名...]

• 删除域名：

bash
letsencrypt-manager remove <域名>

备份建议

使用https://github.com/bringnow/docker-git-sync%E5%90%8C%E6%AD%A5%60/etc/letsencrypt%60%E5%88%B0Git%E4%BB%93%E5%BA%93%EF%BC%8C%E7%A1%AE%E4%BF%9D%E8%AF%81%E4%B9%A6%E5%AE%89%E5%85%A8%E5%A4%87%E4%BB%BD%E3%80%82