acme.sh 命令参数
acme.sh 命令参数,由 --help 英文帮助信息翻译而来(GPT),也许可能会有人需要查阅。
# acme.sh --help
https://github.com/acmesh-official/acme.sh
v3.0.8
用法:acme.sh <命令> ... [参数 ...]
命令:
-h, --help 显示此帮助信息。
-v, --version 显示版本信息。
--install 将 acme.sh 安装到你的系统。
--uninstall 卸载 acme.sh,并卸载 cron 任务。
--upgrade 从 https://github.com/acmesh-official/acme.sh 升级 acme.sh 到最新代码。
--issue 签发证书。
--deploy 部署证书到你的服务器。
-i, --install-cert 安装签发的证书到 Apache/nginx 或其他服务器。
-r, --renew 更新证书。
--renew-all 更新所有证书。
--revoke 吊销证书。
--remove 从 acme.sh 管理的证书列表中移除证书。
--list 列出所有证书。
--info 显示 acme.sh 配置,或使用 [-d domain] 参数显示某个域名的配置。
--to-pkcs12 导出证书和密钥到 pfx 文件。
--to-pkcs8 转换为 pkcs8 格式。
--sign-csr 从现有的 csr 签发证书。
--show-csr 显示 csr 的内容。
-ccr, --create-csr 创建 CSR,专业使用。
--create-domain-key 创建域名私钥,专业使用。
--update-account 更新账户信息。
--register-account 注册账户密钥。
--deactivate-account 注销账户。
--create-account-key 创建账户私钥,专业使用。
--install-cronjob 安装 cron 任务以更新证书,你不需要手动调用此命令。'install' 命令会自动安装 cron 任务。
--uninstall-cronjob 卸载 cron 任务。'uninstall' 命令会自动执行此操作。
--cron 运行 cron 任务以更新所有证书。
--set-notify 设置 cron 通知钩子、级别或模式。
--deactivate 注销域名验证,专业使用。
--set-default-ca 与 '--server' 一起使用,设置默认的 CA。
参见:https://github.com/acmesh-official/acme.sh/wiki/Server
--set-default-chain 设置 CA 的默认首选链。
参见:https://github.com/acmesh-official/acme.sh/wiki/Preferred-Chain
参数:
-d, --domain <domain.tld> 指定域名,用于签发、更新或吊销等操作。
--challenge-alias <domain.tld> DNS 别名模式的挑战域名别名。
参见:https://github.com/acmesh-official/acme.sh/wiki/DNS-alias-mode
--domain-alias <domain.tld> DNS 别名模式的域名别名。
参见:https://github.com/acmesh-official/acme.sh/wiki/DNS-alias-mode
--preferred-chain <chain> 如果 CA 提供多个证书链,优先选择与此主题通用名称匹配的链。
如果没有匹配,将使用默认提供的链。(默认:空)
参见:https://github.com/acmesh-official/acme.sh/wiki/Preferred-Chain
--valid-to <date-time> 请求证书的 NotAfter 字段。
参见:https://github.com/acmesh-official/acme.sh/wiki/Validity
--valid-from <date-time> 请求证书的 NotBefore 字段。
参见:https://github.com/acmesh-official/acme.sh/wiki/Validity
-f, --force 强制安装、强制证书更新或覆盖 sudo 限制。
--staging, --test 使用测试服务器进行测试。
--debug [0|1|2|3] 输出调试信息。如果省略参数,默认为 2。
--output-insecure 输出所有敏感信息。
默认情况下,为了安全,所有凭证/敏感信息在输出/调试/日志中被隐藏。
-w, --webroot <directory> 指定用于 web 根模式的 web 根文件夹。
--standalone 使用独立模式。
--alpn 使用独立 alpn 模式。
--stateless 使用无状态模式。
参见:https://github.com/acmesh-official/acme.sh/wiki/Stateless-Mode
--apache 使用 Apache 模式。
--dns [dns_hook] 使用手动 DNS 模式或 DNS API。省略参数时默认为手动模式。
参见:https://github.com/acmesh-official/acme.sh/wiki/dnsapi
--dnssleep <seconds> 在 dns api 模式下,等待所有 txt 记录传播的时间(秒)。
默认情况下不需要使用此选项,acme.sh 会自动通过 DOH 轮询 DNS 状态。
-k, --keylength <bits> 指定域名密钥长度:2048、3072、4096、8192 或 ec-256、ec-384、ec-521。
-ak, --accountkeylength <bits> 指定账户密钥长度:2048、3072、4096
--log [file] 指定日志文件。省略参数时默认为 "/root/.acme.sh/acme.sh.log"。
--log-level <1|2> 指定日志级别,默认为 2。
--syslog <0|3|6|7> Syslog 级别,0:禁用 syslog,3:错误,6:信息,7:调试。
--eab-kid <eab_key_id> 用于外部账户绑定的密钥标识符。
--eab-hmac-key <eab_hmac_key> 用于外部账户绑定的 HMAC 密钥。
这些参数用于在签发/更新证书后将证书安装到 nginx/Apache 或其他服务器:
--cert-file <file> 签发/更新后复制证书文件的路径。
--key-file <file> 签发/更新后复制密钥文件的路径。
--ca-file <file> 签发/更新后复制中间证书文件的路径。
--fullchain-file <file> 签发/更新后复制完整链证书文件的路径。
--reloadcmd <command> 签发/更新后重新加载服务器的命令。
--server <server_uri> ACME 目录资源 URI。(默认:https://acme.zerossl.com/v2/DV90)
参见:https://github.com/acmesh-official/acme.sh/wiki/Server
--accountconf <file> 指定自定义账户配置文件。
--home <directory> 指定 acme.sh 的主目录。
--cert-home <directory> 指定保存所有证书的目录,仅对 '--install' 命令有效。
--config-home <directory> 指定保存所有配置的目录。
--useragent <string> 指定用户代理字符串。它也会被保存以供将来使用。
-m, --email <email> 指定账户电子邮件,仅对 '--install' 和 '--update-account' 命令有效。
--accountkey <file> 指定账户密钥路径,仅对 '--install' 命令有效。
--days <ndays> 指定使用 '--issue' 命令时更新证书的天数。默认值为 60 天。
--httpport <port> 指定独立监听端口。仅在服务器位于反向代理或负载均衡器后面时有效。
--tlsport <port> 指定独立 tls 监听端口。仅在服务器位于反向代理或负载均衡器后面时有效。
--local-address <ip> 指定独立/tls 服务器监听地址,以防你有多个 ip 地址。
--listraw 仅用于 '--list' 命令,以原始格式列出证书。
-se, --stop-renew-on-error 仅对 '--renew-all' 命令有效。如果一个证书更新出错,则停止。
--insecure 不检查服务器证书,在某些设备中,api 服务器的证书可能不被信任。
--ca-bundle <file> 指定用于验证 api 服务器证书的 CA 证书捆绑包路径。
--ca-path <directory> 指定包含 PEM 格式 CA 证书的目录,由 wget 或 curl 使用。
--no-cron 仅对 '--install' 命令有效,这意味着:不安装默认的 cron 任务。
在这种情况下,证书将不会自动更新。
--no-profile 仅对 '--install' 命令有效,这意味着:不要将别名安装到用户配置文件。
--no-color 不输出彩色文本。
--force-color 强制输出彩色文本。适用于与 aha 工具一起使用的非交互式 HTML 电子邮件。
--ecc 指定使用 ECC 证书。仅对 '--install-cert'、'--renew'、'--remove'、'--revoke'、
'--deploy'、'--to-pkcs8'、'--to-pkcs12' 和 '--create-csr' 有效。
--csr <file> 指定输入的 csr。
--pre-hook <command> 在获取任何证书之前运行的命令。
--post-hook <command> 在尝试获取/更新证书后运行的命令。不论获取/更新是否成功都会运行。
--renew-hook <command> 每次成功更新证书后运行的命令。
--deploy-hook <hookname> 部署证书的钩子文件。
--extended-key-usage <string> 手动定义 CSR 扩展密钥用法值。默认值为 serverAuth,clientAuth。
--ocsp, --ocsp-must-staple 生成 OCSP-Must-Staple 扩展。
--always-force-new-domain-key 更新时生成新的域名密钥。否则,默认情况下不会更改域名密钥。
--auto-upgrade [0|1] 对 '--upgrade' 命令有效,指示将来是否自动升级。如果省略参数,默认为 1。
--listen-v4 强制独立/tls 服务器监听 ipv4。
--listen-v6 强制独立/tls 服务器监听 ipv6。
--openssl-bin <file> 指定自定义 openssl 二进制文件位置。
--use-wget 强制使用 wget,如果你同时安装了 curl 和 wget。
--yes-I-know-dns-manual-mode-enough-go-ahead-please 强制使用 dns 手动模式。
参见:https://github.com/acmesh-official/acme.sh/wiki/dns-manual-mode
-b, --branch <branch> 仅对 '--upgrade' 命令有效,指定要升级到的分支名称。
--notify-level <0|1|2|3> 设置通知级别: 默认值为 2。
0:禁用,不发送通知。
1:仅在发生错误时发送通知。
2:在证书成功更新或发生错误时发送通知。
3:在证书被跳过、更新或出错时发送通知。
--notify-mode <0|1> 设置通知模式。默认值为 0。
0:批量模式。将所有域的通知发送在一条消息(邮件)中。
1:证书模式。为每个证书发送一条消息。
--notify-hook <hookname> 设置通知钩子。
--notify-source <server name> 在通知消息中设置服务器名称。
--revoke-reason <0-10> 吊销原因,可以与 '--revoke' 命令一起使用。
参见:https://github.com/acmesh-official/acme.sh/wiki/revokecert
--password <password> 为导出的 pfx 文件添加密码。与 --to-pkcs12 一起使用。