ironfly/certbot

Ubuntu 14.04 Let's Encrypt (Certbot) 基础镜像

镜像概述

本镜像基于Ubuntu 14.04操作系统构建，集成了Let's Encrypt的Certbot客户端工具，旨在提供一个开箱即用的SSL/TLS证书管理环境。通过预配置的Certbot，用户可快速实现域名证书的申请、部署和自动续期，适用于需要HTTPS支持的各类应用场景。

注意：Ubuntu 14.04已停止官方支持，本镜像仅推荐用于依赖该特定系统版本的legacy环境。

核心功能与特性

• 基础环境：基于Ubuntu 14.04 LTS系统，包含基础系统工具链
• Certbot集成：预装Let's Encrypt官方客户端Certbot，支持ACME协议
• 证书管理：支持域名证书的申请、安装、更新与吊销
• 自动化支持：内置续期脚本框架，可配置定时任务实现证书自动续期
• 兼容性：兼容主流Web服务器（Nginx、Apache等）的证书部署需求

使用场景

• 需要快速部署SSL证书的Web服务（如Nginx、Apache）
• 开发/测试环境中的HTTPS配置验证
• 依赖Ubuntu 14.04环境的legacy应用HTTPS改造
• 批量域名证书管理与自动化续期需求

使用方法

基本运行命令

bash
docker run -d \
  --name certbot-ubuntu14 \
  -v /path/to/certificates:/etc/letsencrypt \
  -e DOMAINS="example.com,www.example.com" \
  -e EMAIL="admin@example.com" \
  your-image-name

环境变量配置

证书存储路径

容器内证书默认存储路径：/etc/letsencrypt
建议通过卷挂载持久化存储该目录，避免容器重启后证书丢失：

bash
-v /host/path/to/certificates:/etc/letsencrypt

常用Certbot命令

进入容器后可直接执行Certbot命令：

bash
# 获取新证书（Webroot模式）
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --email admin@example.com

# 手动续期证书
certbot renew

# 查看已安装证书
certbot certificates

# 吊销证书
certbot revoke --cert-path /etc/letsencrypt/live/example.com/cert.pem

自动续期配置

默认已配置每日自动续期检查（通过cron任务），当证书剩余有效期不足30天时自动续期。可通过AUTO_RENEW环境变量控制开关，通过RENEW_HOUR和RENEW_MINUTE调整执行时间。

注意事项

1. 运行容器时需确保主机网络端口（80/443）可被外部访问（Let's Encrypt验证需要）
2. 生产环境建议使用Webroot或DNS验证模式，避免使用standalone模式占用端口
3. 证书文件权限需根据Web服务器需求调整，通常设置为0644
4. 定期备份/etc/letsencrypt目录，防止证书丢失