热门搜索:
mathnao/certs
mathnao
用于Kubernetes的Let's Encrypt证书管理器，通过acme.sh脚本以DNS验证方式生成和续期证书，使用Kubernetes Job实现自动化管理。
下载次数: 0状态：社区镜像维护者：mathnao仓库类型：镜像最近更新：8 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
用于Kubernetes的Let's Encrypt证书管理器
该Chart使用https://github.com/Neilpang/acme.sh脚本以DNS验证方式生成Let's Encrypt证书；它通过Kubernetes Job来获取和续期证书。
Ingress注解
| 名称 | 示例 | 描述 |
|---|---|---|
| acme.kubernetes.io/enable | "true" | 当值设为"true"时，在此Ingress上启用Certs。默认值为空。 |
| acme.kubernetes.io/dns | "dns_gd" | 设置acme.sh的--dns参数：（查看[https://github.com/Neilpang/acme.sh/wiki/dnsapi%5D%E4%BA%86%E8%A7%A3%E6%89%80%E6%9C%89%E6%94%AF%E6%8C%81%E7%9A%84--dns值）。默认值为空。 |
| acme.kubernetes.io/staging | "true" | 当值设为"true"时，启用acme测试环境证书验证。默认值为空。 |
| acme.kubernetes.io/add-args | "--keylength ec-256" | 为生成证书的acme.sh命令添加更多参数。默认值为空。 |
| acme.kubernetes.io/cmd-to-use | "acme.sh -h" | 替换用于生成证书的acme.sh命令。默认值为空。 |
Chart配置
| 参数 | 默认值 | 描述 |
|---|---|---|
| image.registry | mathnao | 设置要使用的Docker镜像仓库。 |
| image.repository | certs | 设置要使用的Docker镜像仓库路径。 |
| image.tag | tag | 设置要使用的Docker镜像标签。 |
| schedule | 0 0,12 * * * | 设置运行DNS验证以续期证书的Job调度时间。 |
| backoffLimit | 1 | 指定Job失败前的重试次数。 |
| activeDeadlineSeconds | 600 | 设置终止Job的活动截止时间。 |
| ttlSecondsAfterFinished | 120 | 设置清理Job的TTL（生存时间）。 |
| successfulJobsHistoryLimit | 3 | 指定应保留的已完成Job数量。 |
| manageAllNamespaces | false | 是否让certs管理所有命名空间以生成证书。 |
| debug | false | 当值设为"true"时，显示更多日志。 |
| failedJobsHistoryLimit | 1 | 指定应保留的失败Job数量。 |
| env | [] | 列出运行acme.sh DNS验证以续期证书所需的所有环境变量。 |
| demo.enabled | false | 启用用于测试目的的演示后端。 |
| demo.image | mathnao/light-test-server | 设置演示后端使用的Docker镜像。 |
| demo.service.type | ClusterIP | 设置演示后端的服务类型。 |
| demo.service.port | 8080 | 设置演示后端的服务端口。 |
| demo.secretName | demo-ingress-cert | 设置用于存储生成证书的密钥名称。 |
| demo.hosts | - "example.com" | 设置要生成Let's Encrypt证书的主机列表。 |
部署示例
-
确保Ingress Controller已部署并就绪
-
注册Ingress，例如：
yamlapiVersion: extensions/v1beta1 kind: Ingress metadata: name: test-ingress annotations: acme.kubernetes.io/enable: "true" acme.kubernetes.io/dns: "dns_gd" nginx.ingress.kubernetes.io/rewrite-target: / spec: tls: - hosts: - sslexample.foo.com secretName: testsecret-tls rules: - host: sslexample.foo.com http: paths: - path: / backend: serviceName: service1 servicePort: 80
- 安装
CertsChart：
bash# 添加Certs Helm仓库 helm repo add certs https://math-nao.github.io/certs/charts # 更新本地Helm Chart仓库缓存 helm repo update # 在与Ingress相同的命名空间中安装Certs Helm Chart helm install \ --name certs \ --namespace app \ --values values.yaml \ certs/certs
values.yaml文件内容示例：
yaml# 每天调度两次Kubernetes Job，仅当证书即将过期时才续期 schedule: "0 2,14 * * *" # 添加acme.sh DNS验证所需的所有必要环境变量 # 参见https://github.com/Neilpang/acme.sh/wiki/dnsapi env: - name: GD_Key value: XXXX - name: GD_Secret value: XXXX
- 访问
https://sslexample.foo.com网页，应看到有效的Let's Encrypt证书
致谢
acme.sh: https://github.com/Neilpang/acme.sh
许可证
本代码根据Apache License, Version 2.0进行分发，详见LICENSE。
***
您的***有助于维护Certs：
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"