Skip to content

Latest commit

 

History

History
69 lines (52 loc) · 2.44 KB

README.zh.md

File metadata and controls

69 lines (52 loc) · 2.44 KB
Raw

letsencrypt-aliyun-cdn

自动为您在阿里云 CDN 上的域名申请 letsencrypt 的免费证书，并自动帮您完成配置

特点

  • 只支持 letsencrypt 证书申请
  • 自动申请、如果已经申请了，自动再过期前 10 天进行续约
  • 支持 dnspod、Route 53、vultr、digitalocean 等 DNS 服务商，列表详见：DNS Providers

使用方法

$ docker pull registry.ap-southeast-1.aliyuncs.com/kemono/cert-manager
$ docker run -e ACCESS_KEY_ID='阿里云的 ACCESS KEY' \
  -e ACCESS_SECRET='阿里云的 ACCESS SECRET' \
  -e DOMAINS='example.com,cdn1.example.com,cdn2.example.com' \
  -e EMAIL='[email protected]' \
  -e DNS_TYPE='dnspod' \
  -e DNSPOD_API_KEY='xxx' \
  registry.ap-southeast-1.aliyuncs.com/kemono/cert-manager

对应 AccessKey 和 AccessSecret 需要有以下权限：

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cdn:DescribeCdnCertificateDetail",
        "cdn:SetDomainServerCertificate",
        "cdn:DescribeDomainCertificateInfo"
      ],
      "Resource": "*"
    }
  ],
  "Version": "1"
}

环境变量说明

  • ACCESS_KEY_ID：阿里云的 ACCESS KEY，建议使用最小权限
  • ACCESS_SECRET：阿里云的 ACCESS SECRET，建议使用最小权限
  • DOMAINS：需要申请证书的域名列表，这些域名也必须是正在使用阿里云 CDN 服务的，多个域名列表以英文逗号分隔，这些域名必须使用同一个 DNS 服务商
  • DNS_TYPE：上述域名所使用的 DNS 服务商
  • 根据 DNS 服务商的不同，需要配置额外的环境变量：
    • dnspod：
      • DNSPOD_API_KEY：格式为 id + 英文逗号 + token，比如 1235,abcdefghigj
    • digitalocean:
      • DO_AUTH_TOKEN：DO 申请的 API TOKEN
  • CERT_PATH：证书存储路径，默认为 /project_root/certificates
  • FORCE_UPDATE：是否强制重新申请证书，默认为 false

FAQ

使用 dnspod 的时候无法生成证书

在错误日志里可以看到类似这种错误：Post "https://dnsapi.cn/Domain.List": context deadline exceeded (Client.Timeout exceeded while awaiting headers)

一般是因为请求 dnspod API 超时导致的，可以尝试设置环境变量 DNSPOD_HTTP_TIMEOUT 为一个较大的值（比如 15、20 等）来规避这个问题。

链接