csmith/letsencrypt-lexicon

Let's Encrypt Lexicon 服务

镜像概述

本容器整合Lexicon库与dehydrated工具，自动从Let's Encrypt获取SSL证书，并支持证书的自动续期。适用于需要SSL加密的网站或服务，可简化证书申请与管理流程。

核心功能

• 自动获取和续期Let's Encrypt SSL证书
• 支持多域名、SAN（Subject Alternative Names）及通配符证书
• 集成Lexicon库，兼容CloudFlare、DigitalOcean等多种DNS提供商的自动验证
• 监控domains.txt文件变化，实时应用新域名配置

使用场景

• 个人或企业网站需要SSL证书加密
• 批量管理多个域名的SSL证书
• 自动化部署环境中需自动获取证书的场景

配置说明

接受Let's Encrypt条款

需同意Let's Encrypt服务条款：

• 设置环境变量ACCEPT_CA_TERMS（非空值）自动接受
• 或在容器内执行/dehydrated --register --accept-terms手动注册

定义域名

容器挂载/letsencrypt卷，需在/letsencrypt/domains.txt中配置域名：

• 每行一个证书，主域名后可跟随SAN域名（如example.com www.example.com）
• 通配符证书需使用别名（如*.example.com > star_example_com）

DNS提供商配置

通过环境变量配置Lexicon支持的DNS提供商（以CloudFlare为例）：

• PROVIDER=cloudflare
• LEXICON_CLOUDFLARE_USERNAME=你的邮箱
• LEXICON_CLOUDFLARE_TOKEN=你的API密钥

其他配置

• STAGING: 设置非空值使用测试服务器（调试用）
• EMAIL: 联系***，接收Let's Encrypt服务通知

部署示例

bash
# 创建存储目录
mkdir /tmp/letsencrypt
echo "domain.com [***]" > /tmp/letsencrypt/domains.txt

# 启动容器
docker run -d --restart=always \
  -e "EMAIL=***" \
  -e "STAGING=true" \
  -e "PROVIDER=cloudflare" \
  -e "LEXICON_CLOUDFLARE_USERNAME=***" \
  -e "LEXICON_CLOUDFLARE_TOKEN=your-api-key" \
  -v /tmp/letsencrypt:/letsencrypt \
  csmith/letsencrypt-lexicon:latest