janeczku/rancher-letsencrypt

Let's Encrypt证书管理器（适用于Rancher）

!https://raw.githubusercontent.com/janeczku/rancher-letsencrypt/master/hero.png

镜像概述

这是一款适用于Rancher平台的服务，可从Let's Encrypt证书颁发机构获取免费SSL/TLS证书，将其添加到Rancher的证书存储中，并自动完成证书续期及向负载均衡器传播更新的操作。

核心功能

1. 自动从Let's Encrypt获取SSL/TLS证书
2. 支持证书自动续期（Let's Encrypt证书有效期为90天）
3. 支持DNS挑战（兼容Aurora DNS、AWS Route53、CloudFlare等主流DNS提供商）
4. 支持HTTP挑战（需配置反向代理转发验证请求）
5. 将证书存储到Rancher证书库或共享存储卷
6. 自动向Rancher负载均衡器同步更新后的证书

使用场景

• Rancher环境中需要为服务配置HTTPS访问的场景
• 需要自动管理SSL证书续期，避免手动操作遗漏的场景
• 多服务共享同一证书的集群环境

配置说明

前置要求

• Rancher Server版本 ≥ v1.5.0
• DNS挑战：需拥有支持的DNS提供商账号（如AWS Route53、CloudFlare等）
• HTTP挑战：需配置反向代理，将domain.com/.well-known/acme-challenge路径转发至rancher-letsencrypt服务的80端口

部署步骤

1. 在Rancher UI中，通过Admin → Settings启用社区目录
2. 在目录中找到Let's Encrypt模板，按照界面提示配置参数（如证书域名、挑战方式、提供商凭证等）
3. 启动服务，自动完成证书获取与配置

共享存储配置

可指定卷名称，将证书、私钥及账户数据存储到Docker命名卷中。若需跨服务共享证书，可使用持久化存储驱动（如rancher-nfs）。

提供商特定配置

AWS Route53

需为账号配置最小权限IAM策略，替换<HOSTED_ZONE_ID>为目标域名的托管区ID：

json
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["route53:GetChange", "route53:ListHostedZonesByName"],
            "Resource": ["*"]
        },
        {
            "Effect": "Allow",
            "Action": ["route53:ChangeResourceRecordSets"],
            "Resource": ["arn:aws:route53:::hostedzone/<HOSTED_ZONE_ID>"]
        }
    ]
}

OVH

1. 访问[***]
2. 配置权限：GET/POST/DELETE /domain/zone/*
3. 使用生成的key、application secret和consumer key部署服务

HTTP挑战

选择HTTP挑战方式后，需配置Rancher负载均衡器或反向代理（如Nginx），将/.well-known/acme-challenge路径转发至rancher-letsencrypt服务的80端口，并确保传递原始host header。