ACME的使用经验
内容提要
ACME是一个自动管理证书的程序,有多种实现,本文介绍了acme.sh的使用。安装、申请、安装证书、续签证书等步骤都有详细说明。在Windows环境下使用ACME需要安装cygwin环境,并按照Linux的步骤进行操作。
延伸解读
安装后的目录与别名设置
安装acme.sh后,将.acme.sh文件夹复制到用户根目录(如~/.acme.sh/)并创建别名(alias acme.sh=~/.acme.sh/acme.sh)并非强制步骤,但作者建议这样做,以贴合官方文档教程并方便日常使用。若不设置别名,则需使用完整路径调用脚本。
证书申请与HTTP验证的前提
使用--webroot方式申请证书时,必须确保HTTP服务已启用并监听80端口,同时正确指定域名和站点根目录。若添加--standalone参数,acme.sh会临时启动一个监听80端口的webserver,但这依赖于socat,需提前安装。申请成功后,证书文件默认生成在~/.acme.sh/域名_ecc/目录下。
安装证书与自动续签的关联
安装证书步骤并非必需,可以手动复制证书文件,但只有执行了安装证书命令(通过--cert-file、--key-file、--fullchain-file指定路径,并用--reloadcmd设置服务器重启命令),才能启用自动续签功能。安装后--reloadcmd不能直接修改,需重新安装证书或手动编辑配置文件(文档不推荐)。
Windows环境下的注意事项
在Windows下使用acme.sh需先安装Cygwin或Git for Windows,然后按照Linux步骤操作,但所有路径必须写成Linux格式(如/c/nginx/crt/...)。自动续签可通过Windows计划任务实现,但任务运行时会出现黑框弹出,作者尝试多种方法未能隐藏,认为在服务器上每晚运行一次影响不大。
Q&A
acme.sh 是什么?它遵循什么标准?
acme.sh 是 ACME(自动证书管理环境)的一个实现,用于自动管理证书。ACME 遵循 RFC 8555 标准。
如何安装 acme.sh?
可以通过直接下载安装(如 curl https://get.acme.sh | sh -s email=my@example.com)或从源码安装(git clone 后运行 ./acme.sh --install -m my@example.com)。安装后建议将 .acme.sh 文件夹复制到用户根目录,并创建别名。
申请证书时需要注意什么?
运行申请命令时,HTTP 服务需要已启用并监听 80 端口。使用 --webroot 指定站点根目录,或加 --standalone 参数让 acme.sh 临时运行 webserver(需先安装 socat)。
安装证书的命令有什么作用?为什么必须执行?
安装证书命令将证书复制到指定目录,并设置服务器重启命令(--reloadcmd),用于自动续签。如果不执行安装证书,就无法自动续签。
如何设置证书自动续签?
先运行安装证书命令,然后使用续签命令(如 ~/.acme.sh/acme.sh --cron --home "/root/.acme.sh"),通常添加到定时任务中,例如 cron 表达式:0 2 * * * /bin/bash /root/.acme.sh/acme.sh --cron --home "/root/.acme.sh" > /dev/null。
在 Windows 下如何使用 acme.sh?
需要安装 Cygwin 或 Git for Windows,然后在 Cygwin 环境中按照 Linux 步骤操作。注意路径要写成 Linux 格式(如 /c/nginx/crt/...)。自动续签可使用 Windows 计划任务,但运行时会有黑框弹出。