certmate-cli

概览

GitHubGitHub

certmate-cli 是 CertMate 平台的命令行工具，通过 `pip install certmate-cli` 安装。它将 CertMate 的 REST API 封装为终端命令，让用户可以在命令行中管理整个 TLS 证书生命周期。 CertMate 是一个自托管的证书生命周期管理平台，支持签发和续期 TLS 证书、发现未由平台签发的证书、维护统一的证书清单（记录证书部署位置、签发者、过期时间、加密算法等信息），并将续期后的证书部署到目标位置。平台支持 29 个 DNS 提供商，可运行私有 CA 处理内部域名，并保留防篡改的操作审计日志。 certmate-cli 本身是基于 certmate-sdk（一个使用 httpx 的 Python 客户端）的薄封装层，与 Web UI 和 MCP server 调用相同的 REST API。使用前需设置 `CERTMATE_URL` 环境变量指向 CertMate 实例地址，并通过 `CERTMATE_TOKEN` 提供认证凭据（全新实例处于 setup-mode 时可省略 token）。 主要能力包括： - **健康检查**：通过 `certmate health` 确认服务状态。 - **证书签发**：例如 `certmate cert create app.example.com --dns cloudflare --wait`，指定 DNS 提供商签发证书并阻塞等待生效。 - **证书列表与信息查看**：使用 `certmate cert ls` 列出证书，`certmate cert info` 查看特定证书详情。 - **审计验证**：通过 `certmate audit verify` 校验操作审计链。 该工具适合需要在终端或自动化脚本中管理 SSL/TLS 证书的运维人员和开发者。对于需要多租户、mTLS 或 NIS2 合规的企业级场景，官方提供了基于 BSL 1.1 协议的 CertMate-ng 版本。

Q&A

如何安装 certmate-cli？由 AI 生成

通过 pip 安装：`pip install certmate-cli`。它发布在 PyPI 上。

使用前需要配置哪些环境变量？由 AI 生成

需要设置 `CERTMATE_URL` 指向你的 CertMate 实例地址，以及 `CERTMATE_TOKEN` 提供认证。如果是刚初始化的全新实例（setup-mode），可以省略 token。

certmate-cli 和 certmate-sdk 是什么关系？由 AI 生成

certmate-cli 是 certmate-sdk 的薄封装层。certmate-sdk 是一个基于 httpx 的 Python 客户端，两者都调用 CertMate 的 REST API，且均发布在 PyPI 上。

CertMate 支持多少个 DNS 提供商？由 AI 生成

原文提到支持 29 个 DNS 提供商，包括 Cloudflare、AWS、Azure、GCP、Akamai Edge DNS、Hetzner、Porkbun、GoDaddy 等。

证书什么时候会自动续期？由 AI 生成

证书会在到期前 30 天自动续期，续期后可通过 deploy hooks 触发服务重载以实现零停机。

CertMate 可以部署多个副本吗？由 AI 生成

不可以。CertMate 作为单实例运行，续期调度器在 web 进程内执行。运行第二个副本会导致重复的 ACME 订单并触发 CA 的重复证书速率限制。其 Helm chart 会拒绝渲染超过一个副本的配置。