如果你的服务跑在 VPS 上,网站想上 HTTPS,第一件事通常是申请一张 Let's Encrypt 证书。用 acme.sh 的好处在于证书申请和续期都能脚本化,不用每次到期前手工去面板点一遍。下面这些内容是我实际配置时比较留意的地方,适合已经有一台能正常访问的 VPS、并且想用命令行方式管理证书的人参考。
安装 acme.sh 之前先想清楚两件事
第一,acme.sh 会把证书和配置放在当前用户目录下(通常是 ~/.acme.sh),并且会往 crontab 写入一条续期任务。默认安装方式会修改当前用户的 shell 配置(比如 ~/.bashrc),如果你不想被改,可以加 --no-profile 参数。第二,用 root 还是普通用户跑 acme.sh,会影响后续给 Nginx 或 Apache 写证书文件时的权限。我建议在普通用户下安装,然后用 sudo 配合相关命令操作,这样可以少暴露 root 权限,不过具体要看你的环境是否允许。
安装和初始化 acme.sh
官方安装命令会从 GitHub 拉取脚本,但在网络受限的 VPS 上可能不成功。这时可以先手动下载脚本文件,检查内容后再执行。比如:
curl -fsSL https://get.acme.sh | sh -s -- --no-profile执行之后确认 ~/.acme.sh/acme.sh 存在,并且 crontab 里多了一条记录。检查方式是:
crontab -l | grep acme如果看不到任何输出,说明安装阶段没有正确写入定时任务。通常是因为系统 crontab 配置有问题,或者安装时用户环境变量缺失,可以先确认 _ACME_CRON 是否被设置。注意,acme.sh 的版本不同,cron 写法也有差异,不要只看网上旧教程里的固定命令。
申请证书:根据验证方式选择不同的操作
acme.sh 支持多种验证方式,最常见的是 webroot 模式和 DNS API 模式。webroot 模式要求你的 Web 服务器在指定目录下能响应 HTTP-01 验证请求。假设你的站点根目录是 /var/www/example,申请命令会是:
acme.sh --issue -d example.com -d www.example.com --webroot /var/www/example这里的关键是:acme.sh 会在 /.well-known/acme-challenge/ 下放置临时文件,你的 Web 服务器必须能访问到那个路径。如果 Nginx 配置了 rewrite 或者有安全规则拦截点号开头的目录,验证就会一直失败。我遇到过最典型的情况是站点配置里限制了 requests 的 URI,导致验证文件返回 404。先临时关闭这类规则,确认申请成功后再改回去,是排查这类问题比较快的思路。
DNS API 模式适合没有公网访问或者不想暴露验证端口的场景。你需要先去域名服务商那里拿到 API Token,然后用类似下面的命令:
export CF_Token="你的令牌"
export CF_Account_ID="你的账号ID"
acme.sh --issue --dns dns_cf -d example.com这种模式不会占用 Web 端口,但要求你的 DNS 服务商在 acme.sh 支持的列表里。如果你的服务商不支持,也可以手动为 _acme-challenge 添加一条 TXT 记录,然后再执行 --renew 触发验证。需要结合你的 DNS 服务商调整,不能照抄命令。
安装证书到服务,并确认续期动作
证书申请成功后,acme.sh 默认把证书文件存放在 ~/.acme.sh/example.com/ 目录下。但强烈不建议 Web 服务直接读取这个路径,因为 acme.sh 后续更新证书时可能会重建目录结构。稳妥的做法是用 --install-cert 把证书和密钥复制到服务实际读取的位置。例如给 Nginx 用:
acme.sh --install-cert -d example.com \
--key-file /etc/nginx/ssl/example.com.key \
--fullchain-file /etc/nginx/ssl/example.com.crt \
--reloadcmd "systemctl reload nginx"这里要确认你的 Nginx 进程对 /etc/nginx/ssl 有读权限。有的 VPS 上 SELinux 或 AppArmor 会限制非标准目录的读取,导致证书复制过去后 nginx 启动报错。遇到这种情况,可以先把证书放到系统默认的 /etc/ssl 路径下,或者调整对应策略。另外,--reloadcmd 必须是你系统里真正可用的重载命令,CentOS 6 上是 service nginx reload,CentOS 7 以上是 systemctl reload nginx,要按实际 systemd 环境来写。
续期是否生效,不能只看 cron 是否存在,还要看 acme.sh 的日志。默认日志在 ~/.acme.sh/acme.sh.log。你可以手动运行一次 acme.sh --renew -d example.com --force 来验证整个流程。那个 --force 参数会让 acme.sh 忽略续期时间检查,强制重新申请。如果这条命令能正常完成后证书文件被更新,说明自动续期的链路是通的。注意,强制续期会消耗 Let's Encrypt 的速率限制,测试不要太频繁。
容易被忽略的检查点
有几个地方经常在配置完成之后才发现问题。一是服务器的系统时间。如果 VPS 时间偏差超过几分钟,acme.sh 发出的请求会失败,因为 TLS 验证依赖准确的时钟。先执行 date 看时间,再确认是否启用了 NTP。二是域名解析。你申请证书时用的域名必须能解析到这台 VPS 的公网 IP,否则 HTTP-01 验证跑不通。特别是用了 CDN 或者 Cloudflare 代理的情况下,验证请求可能被 CDN 拦截。三是防火墙和安全组。有的 VPS 默认只开放 80 和 443,如果用了 8080 端口做验证,需要先在面板里放行。
回滚边界也很重要。如果你在已有网站上切换证书,最好先把旧证书备份到别处。acme.sh 的 --install-cert 不会覆盖旧文件,但如果你直接复制到 nginx 配置里,中途出错可能会导致 nginx 加载失败。习惯上我会先执行 nginx -t 检查配置,再执行 reload,这样即使证书路径有问题,也不会让服务中断。
最后说一点:不要指望申请一次之后就完全不用管。Let's Encrypt 证书有效期现在是 90 天,自动续期能否稳定工作,依赖 cron、DNS、Web 服务器权限和路径几个环节的配合。每过一段时间检查一次日志和证书实际到期时间,比吃透所有参数更有用。