Skip to content

ACME 命令 ​

CertiMan CLI 内置标准 ACME 客户端,通过 ACME 协议(RFC 8555)与 CA 交互,完成证书的申请、续期、吊销、查询与本地交付。任意兼容 ACME 协议的 CA 均可使用,账户注册支持 EAB(External Account Binding)。

ACME 命令组与 CertCloud 命令组相互独立:

对比项ACME 命令组(certiman acme)CertCloud 命令组(certiman issue 等)
认证方式ACME 账户私钥,注册时可提供 EAB 凭证OAuth 设备授权流(certiman login)
域名验证dns-01 / http-01 质询CertCloud DCV(dns / file / email 等)
数据目录~/.certiman/acme/~/.certiman/cc/
证书配置~/.certiman/acme/certs/<CN>/cert.yaml~/.certiman/cc/certs/<CN>/cert.yaml

ACME 命令组不需要运行 certiman login。注册账户需要 CA 的 ACME Directory URL;CA 要求 EAB 时,还需提供服务方签发的 eab-kid 与 eab-hmac-key。

所有命令都可以叠加 全局 flag。

命令一览 ​

命令作用
acme account register注册 ACME 账户(支持 EAB 与交互向导)
acme account list列出本机 ACME 账户
acme account deactivate停用 ACME 账户,保留本地材料
acme issue申请证书,含交互向导与命令模式
acme renew续期证书,支持 ARI 续期窗口与批量
acme revoke吊销托管或外部证书,支持账户私钥或证书私钥签名
acme list列出本机 ACME 证书
acme status查看单张证书的配置、状态与交付信息
acme convert本地转换证书文件格式
acme deploy执行部署 hook
cert.yaml 证书配置文件单张证书的固化配置:账户、验证方式、输出格式与续期设置

数据目录 ​

ACME 命令组的配置、账户与证书文件集中存放在 ~/.certiman/acme/,可通过环境变量 CERTIMAN_HOME 覆盖根路径。

text
~/.certiman/acme/
├── accounts/                       # ACME 账户目录
│   └── <账户目录名>/                # <CA 主标签>-<序号>,如 acme-1
│       ├── account.json            # 账户配置
│       └── account.key             # 账户私钥(权限 0600)
└── certs/                          # 证书目录
    └── <CN>/                       # 每张证书一个子目录,CN 为主域名
        ├── cert.yaml               # 证书级配置
        ├── state.json              # 签发与续期状态
        ├── cert.pem                # 服务器证书
        ├── privkey.pem             # 现役私钥(权限 0600)
        ├── chain.pem               # 中间证书链
        ├── fullchain.pem           # 服务器证书 + 中间证书链
        └── converted/              # convert 产出的其它格式

敏感文件权限

账户私钥与证书私钥的权限为 0600。请勿放宽权限,以免其他用户读取私钥。

相关文档 ​

  • ACME 快速上手 —— 从注册账户到自动续期的完整流程
  • 配置 —— 数据目录、全局 flag、环境变量、退出码
  • 定时任务命令 —— 定时扫描同时覆盖 ACME 证书
  • Hook 命令 —— 验证与部署 hook 的编写和试运行