csmith/letsencrypt-mydnshost

Let's Encrypt MyDNSHost 服务容器

镜像概述

本容器结合MyDNSHost API与https://github.com/lukas2511/dehydrated%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%AE%9E%E7%8E%B0%E4%BB%8ELet's Encrypt自动获取SSL证书的功能，支持多域名、SAN（Subject Alternative Names），并能自动续期证书及响应域名列表变化。

核心功能

• 自动获取Let's Encrypt SSL证书
• 支持多域名及SAN配置
• 证书自动续期
• 实时监控域名列表文件（domains.txt）变化并应用
• 提供测试环境（STAGING）支持

使用场景

• 个人或企业网站需要自动管理SSL证书
• 使用MyDNSHost DNS服务的用户快速部署HTTPS
• 需要批量管理多域名证书的场景

配置说明

接受Let's Encrypt条款

要获取证书需同意Let's Encrypt服务条款，可通过两种方式：

1. 容器内执行命令：/dehydrated --register --accept-terms
2. 设置环境变量ACCEPT_CA_TERMS（任意非空值）自动接受条款（注意：将自动接受未来条款变更）

定义域名

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

• 每行对应一个证书
• 主域名后可跟随SAN域名，以空格分隔 示例：

example.com www.example.com
admin.example.com

授权配置

需提供MyDNSHost API的用户名和密钥作为环境变量：

• MYDNSHOST_AUTH_USER：MyDNSHost账号***
• MYDNSHOST_AUTH_KEY：MyDNSHost API密钥

其他配置

• STAGING：设置非空值启用Let's Encrypt测试服务器（放宽速率限制）
• EMAIL：设置联系***，用于接收Let's Encrypt重要通知

部署示例

bash
# 创建存储目录（或使用Docker卷）
mkdir /tmp/letsencrypt
echo "domain.com [***]" > /tmp/letsencrypt/domains.txt

# 启动容器
docker run -d --restart=always \
  -e "EMAIL=***" \
  -e "STAGING=true" \
  -e "MYDNSHOST_AUTH_USER=***" \
  -e "MYDNSHOST_AUTH_KEY=your-api-key" \
  -v /tmp/letsencrypt:/letsencrypt \
  csmith/letsencrypt-mydnshost:latest