jauderho/lego

jauderho/lego 镜像文档

镜像概述

jauderho/lego 是基于 https://github.com/go-acme/lego 项目构建的Docker镜像。lego 是一个用Go编写的Let's Encrypt客户端和ACME（自动证书管理环境）库，用于与证书颁发机构（CA）交互以自动化SSL/TLS证书的获取、续期和管理。

镜像信息

https://github.com/jauderho/dockerfiles/workflows/lego/badge.svg](https://github.com/jauderho/dockerfiles/actions?query=workflow%3Alego)

镜像特性

• 多平台支持：提供多架构镜像，适配不同硬件平台
• 及时更新：上游（go-acme/lego）版本发布后1小时内构建最新镜像，且每周至少重建一次，确保安全性和兼容性

核心功能

• 作为ACME协议客户端，支持与Let's Encrypt等符合ACME标准的证书颁发机构（CA）交互
• 自动化域名验证流程，支持HTTP-01、DNS-01等多种挑战类型
• 生成、续期和撤销SSL/TLS证书，支持RSA、ECDSA等密钥类型
• 以Go库形式提供ACME功能，可集成到其他Go应用中实现证书管理逻辑

使用场景

• Web服务器（如Nginx、Apache）的SSL/TLS证书自动管理
• API服务、微服务架构中服务间通信的加密证书配置
• 需要定期续期证书的各类网络服务，避免手动操作证书过期风险

使用方法

基本使用示例

以下命令示例通过HTTP-01挑战为example.com域名获取证书，并将证书存储在本地/path/to/lego/data目录：

bash
docker run --rm -v /path/to/lego/data:/data jauderho/lego \
  --email="your@email.com" \
  --domains="example.com" \
  --http \
  run

常用配置参数

lego客户端支持丰富的参数配置，核心参数包括：

• --email：注册ACME账户的***（必填）
• --domains：目标域名，多个域名用逗号分隔（如--domains="example.com,www.example.com"）
• --server：ACME服务器URL，默认使用Let's Encrypt生产服务器（https://acme-v02.api.letsencrypt.org/directory），测试环境可使用 staging 服务器（https://acme-staging-v02.api.letsencrypt.org/directory）
• --http：使用HTTP-01挑战（需确保80端口可访问）
• --dns <provider>：使用DNS-01挑战，需指定DNS提供商（如--dns cloudflare，需配合对应DNS提供商的API密钥环境变量）
• --path：证书存储路径（容器内默认/data，建议通过卷挂载到宿主机持久化存储）

更多参数及详细说明请参考https://github.com/go-acme/lego%E3%80%82

镜像更新策略

• 上游（go-acme/lego）发布新版本后1小时内自动构建并推送多平台镜像
• 每周至少执行一次镜像重建，确保基础镜像和依赖组件的安全性更新