文档中心

Appearance

status —— 查询订单进度 ​

查看订单进度、域名验证状态、证书信息。该命令为只读命令，每次运行都会从平台同步状态；同步失败时使用本地快照，并在输出中标注同步时间与失败原因。

用法 ​

bash
certiman status [flags]

参数 ​

选择器：-d / -c / --order-id / --cert-id 四选一，同时提供多个时报错。

flag短名类型说明
--domain-dstring主域名（CN），即证书目录名；支持中文域名
--conf-cstring证书配置文件路径（任意位置的 cert.yaml）
--order-idstringCertCloud 平台订单 ID
--cert-idstringCertCloud 平台证书 ID

示例 ​

bash
# 按主域名查（-d 只接一个，不可重复）
certiman status -d example.com

# 按平台订单号查
certiman status --order-id OHczXZEh

# 按平台证书 ID 查
certiman status --cert-id gF8KdBlw

# JSON 输出
certiman status -d www.example.com -o json

找不到证书时

-d 只匹配主域名（CN），不匹配 SAN 或目录名。若该域名是其他证书的 SAN，错误信息会给出该域名所属的证书；按提示改用该证书的主域名或 --cert-id 后再运行。

输出 ​

0成功（示例）
text
项目        内容
证书        example.com
域名        example.com
状态        已签发
订单        OHczXZEh
订单服务期  2026-08-07 ~ 2027-08-07
证书 ID     gF8KdBlw
证书到期    2027-02-22
剩余        199 天
已下载      2026-08-07
部署        ✓
自动续期    ✓
数据时间    刚刚同步
证书目录    ~/.certiman/cc/certs/example.com
0-o json（示例）
json
{
  "name": "www.example.com",
  "domains": [
    "www.example.com"
  ],
  "status": "issued",
  "order": {
    "id": "mZDma48D",
    "expires_at": null,
    "valid_from": null,
    "status": "domain_verifing",
    "checked_at": "2026-08-07T08:17:58.991004Z"
  },
  "cert": {
    "id": "A8znxTY6",
    "not_before": "2026-08-07T15:00:00Z",
    "not_after": "2027-02-22T14:59:59Z"
  },
  "days_left": 199,
  "expired": false,
  "dir": "~/.certiman/cc/certs/www.example.com",
  "local": {
    "downloaded_at": "2026-08-07T08:17:59.033549Z",
    "converted": [],
    "deploy": {
      "exit_code": 0,
      "at": "2026-08-07T08:17:59.097021Z"
    }
  },
  "dcv": [
    {
      "domain": "www.example.com",
      "method": "dns-persist",
      "host": "_validation-persist.www.example",
      "type": "TXT",
      "value": "trustasia.com; accounturi=https://trustasia.com/acct/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
      "verified": true,
      "checked_at": "2026-08-07T08:17:56.574468Z"
    }
  ],
  "renew": {
    "auto_cert": false,
    "auto_order": false,
    "days_before": 0
  }
}

local 里的三个字段只在异常时出现

字段出现条件含义
private_key值为 absent本机没有配对私钥，不可部署
material_incomplete交付材料缺件缺失的文件名数组
enc_key_pending国密加密私钥尚未下载运行 certiman download -d <主域名> 下载

status 始终以退出码 0 结束。自动化流程需要根据检查结果决定是否继续时，请使用 doctor。

仅有配置（draft）

draft 表示配置已写入、订单尚未提交的中间态。该状态本身不表示异常，下一步运行 certiman issue -d <主域名> 提交订单。

处于等待人工审核的订单

订单等待 CertCloud 平台人工审核（如 OV / EV 证书）时，输出中会附加「办理进度链接」，可在浏览器中打开该链接完成审核相关操作。

订单已被取消（canceled）

订单在服务期内被取消时，CA 将连带吊销该证书。服务器上仍在使用该证书时，客户端将握手失败。运行 certiman reissue -d <主域名> 重新颁发一张新证书以恢复服务；reissue 对 canceled / revoked 状态不需要 -f，也不请求二次确认。

相关命令 ​

  • list —— 列出所有本机证书
  • issue —— 提交新订单