Appearance
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。请勿放宽权限,以免其他用户读取私钥。
