文档中心

Appearance

acme deploy —— 部署证书 ​

为本地 ACME 证书执行部署脚本（deploy hook）：重试失败的部署、后期补充脚本，或调整部署目标后重新部署。该命令不下载证书，也不请求 CA。

--deploy-hook 仅对本次运行生效，不修改证书配置；未提供时执行证书配置中的 deploy 脚本。

重复部署保护：证书已有成功部署记录时，再次执行 acme deploy 不带 -f 将以退出码 2 拒绝执行，并提示「证书部署已成功。如需重复部署,使用 -f」。该保护对 --deploy-hook 单次覆盖同样生效：成功部署后换用其他脚本也需 -f。首次部署与上次部署失败后的重试不受该保护限制。

用法 ​

bash
certiman acme deploy [flags]

参数 ​

flag短名类型默认说明
--domain-d[]string选择器：按主域名指定证书
--conf-cstring选择器：证书配置文件路径
--deploy-hookstring本次运行使用的部署 hook 脚本路径，不写入证书配置
--reloadcmdstring--deploy-hook 的同义参数，执行 shell 命令

示例 ​

bash
# 执行证书配置中的部署脚本（首次部署或上次部署失败后重试）
certiman acme deploy -d example.com

# 单次覆盖部署脚本（不修改证书配置）
certiman acme deploy -d example.com --deploy-hook /home/<用户名>/.certiman/hooks/nginx.sh

# 已有成功部署记录时，重复部署或单次覆盖均需 -f
certiman acme deploy -d example.com -f
certiman acme deploy -d example.com --deploy-hook /home/<用户名>/.certiman/hooks/nginx.sh -f

输出 ​

0成功（示例）
text
✔ 部署完成 · example.com

未配置部署脚本时报错，并提示在 cert.yaml 中配置 deploy 或使用 --deploy-hook 指定脚本。部署脚本的编写方式见 部署示例。

2已有成功部署记录，未提供 -f（示例）
text
错误: 证书部署已成功。
  - 如需重复部署,使用 `-f`。

相关命令 ​