APISIX ACME Automatic renewal

这是一个使用 Go 编写的自动 https 证书续期服务，适配 APISIX 网关。

功能

1. 自动使用 Let's Encrypt 申请/续期证书。
2. 使用云厂商 DNS API 自动添加验证 TXT 记录。
3. 申请成功后自动将证书推送到 APISIX Admin API。
4. 每天检查一次证书过期时间，默认小于 80 天自动续期。
5. 支持多 DNS 账号：不同域名可以使用不同云厂商账号的 DNS 凭证。

技术栈

• Go 1.23+
• lego (ACME 客户端)

支持的 DNS 厂商及配置

在 config.yaml 的 dns_providers 块中配置对应的环境变量。

厂商	type	必需环境变量	说明
阿里云 (Aliyun)	alidns	ALICLOUD_ACCESS_KEY ALICLOUD_SECRET_KEY	阿里云的 AccessKey ID 和 Secret
腾讯云 (Tencent Cloud)	tencentcloud	TENCENTCLOUD_SECRET_ID TENCENTCLOUD_SECRET_KEY	腾讯云 API 密钥
DNSPod (国内版)	dnspod	DNSPOD_API_KEY	格式为 ID,Token (例如 12345,abcdef...)
华为云 (Huawei Cloud)	huaweicloud	HUAWEICLOUD_ACCESS_KEY_ID HUAWEICLOUD_SECRET_ACCESS_KEY HUAWEICLOUD_REGION	Region 例如 cn-north-4
Cloudflare	cloudflare	CLOUDFLARE_DNS_API_TOKEN	推荐使用 API Token

更多厂商支持请参考 Lego DNS Providers 文档，本项目代码已预埋扩展接口，修改 internal/dns/factory.go 即可添加新厂商。

配置文件示例 (config.yaml)

email: "your-email@example.com"

# 证书配置列表
# dns_provider 引用下方 dns_providers 中定义的名称
certificates:
  - domains: [ "example.com", "*.example.com" ]
    dns_provider: "aliyun-main"
    renew_before_expiry_days: 80

  - domains: [ "other-domain.cn" ]
    dns_provider: "aliyun-secondary"
    renew_before_expiry_days: 75

  - domains: [ "global-site.com" ]
    dns_provider: "my-cloudflare"
    renew_before_expiry_days: 70

# 多 DNS Provider 配置
# 每个 key 是自定义名称，证书通过 dns_provider 字段引用
dns_providers:
  aliyun-main:
    type: "alidns"
    env:
      ALICLOUD_ACCESS_KEY: "LTAI4..."
      ALICLOUD_SECRET_KEY: "secret1..."

  aliyun-secondary:
    type: "alidns"
    env:
      ALICLOUD_ACCESS_KEY: "LTAI5..."
      ALICLOUD_SECRET_KEY: "secret2..."

  my-cloudflare:
    type: "cloudflare"
    env:
      CLOUDFLARE_DNS_API_TOKEN: "your-token..."

apisix:
  admin_url: "http://apisix:9180"
  admin_key: "your-admin-token"

data_dir: "./data"
cron_schedule: "0 0 * * *"
lets_encrypt_env: "production"

快速开始

1. 准备环境

确保 APISIX 已经运行，并且知道它所在的 Docker 网络名称（默认为 apisix）。

2. 启动服务

使用 Docker Compose 启动：

docker-compose up -d --build

3. 数据持久化

data/ 目录会保存：

• user.json: ACME 账户凭证（重要，请备份）
• *.crt, *.key: 申请到的证书文件

开发运行

go mod tidy
go run main.go -c config.yaml