Let's Encrypt 证书自动续期踩坑记:key 文件权限
手里这台华为云 Flexus L 是 2 核、内存标称 1G(系统里实际可见约 800MB)、40G 系统盘,装的是 Debian 12。域名 sg.tatan520.us.ci 的证书是用 acme.sh 以 standalone 模式签的 Let’s Encrypt EC-256 证书,签完配了自动续期,本以为从此可以忘掉证书这件事。结果续期后服务起不来,查了一圈,根子出在 key 文件权限上。本文记录这个坑的完整经过,都是这台机器上实际走过的步骤。
一、签发时就埋下的权限坑
acme.sh 是以 root 身份跑的,签出来的证书和私钥默认也是 root 属主,私钥 key.pem 默认权限很严,只有 root 能读。这本身没问题,私钥就该这么严。
问题出在用证书的服务不是以 root 跑的。这台机器上的 TLS 服务跑在一个专用的非 root 账号下(xray 账号),服务启动时要去读 key.pem,读不到就直接报 permission denied,起不来。排查时看服务日志,一眼就是权限被拒;再 ls -l 看一眼 key 文件的属主和权限,对照服务的运行账号,原因就清楚了:证书是 root 的,服务是 xray 账号的,两边对不上。
这个坑容易踩,是因为签发和运行是两个人(两个账号)在做事:签发时只想着“签下来就行”,没想过谁来读。
二、修复:chgrp 加 640,不要图省事给 777
修复本身就两行:把 key.pem 的属组改成服务账号所在的组,再把权限放宽到组可读:
chgrp xray key.pem
chmod 640 key.pem
640 这个数值得说一句:属主可读写、属组只读、其他人什么都没有。私钥绝不能给 644,更不能给 777——其他人能读私钥,证书就白签了。组可读已经够服务用了,不必再多给。
改完重启服务,permission denied 消失,服务正常起来,浏览器访问域名,证书链也正常。
三、真正的坑在续期:手动修好的权限会被续期抹掉
如果故事到这里结束,这篇就不值得写。真正的坑在后面:Let’s Encrypt 证书有效期短,靠 acme.sh 自动续期续命。续期时会重新签发并替换证书和私钥文件,新签出来的 key.pem 权限又回到默认的 root 专属状态——第一次手动修好的 chgrp 和 chmod,全被续期抹掉了。
也就是说,第一次修权限只是治标。续期那天服务一重载,又是 permission denied,又起不来,而你可能根本没在机器跟前。
正确做法是把权限修复写进续期钩子,让它每次续期后自动执行。acme.sh 支持 --reloadcmd,在签发时就把这条命令配进去:续期成功后先 chgrp、chmod 修好新 key 的权限,再重载服务。配好之后每次续期都是同一套动作,不再依赖人记得去手动修。
教训就一句话:证书续期不是“签完就忘”,权限和重载这两步必须进钩子,只修一次等于没修。
四、同一份证书的第二个消费者:反代容器也要重载
这台机器上还有第二个在用同一份证书的服务:一个 nginx 反代容器,把 8443 端口的流量反代到本地 8680 端口的服务上。续期换了新证书,容器里的 nginx 不会自动重载——它手里还是旧证书,续期后必须重启或重载这个反代容器,对外才是最新的证书。
这一步也容易漏,因为它和 TLS 服务不在同一个地方,续期钩子只管了主服务,没管它。正确的做法是续期后列出所有用这份证书的服务,逐个重载:主服务重载一次,反代容器重载一次,一个都不能少。
五、续期后的自查清单
现在每次续期,我按这张清单自查:
- ls -l 看一眼新 key.pem 的属组和权限,确认是服务账号的组、640;
- 看服务日志,确认重载后没有 permission denied,服务正常在跑;
- 用浏览器或 openssl s_client 连一下域名,看证书有效期是不是已经是新的;
- 反代那边的 8443 端口也连一下,确认它给出的也是新证书。
清单上的每一项都对应前面踩过的一个坑,缺一项,下次续期就可能再栽一次。
结尾
自动续期省的是“记得去续”这件事,省不掉“续完要修权限、要重载服务”这两件事。把这两件事写进钩子、写进清单,证书才能真正做到签完不用管。对小机器来说,这类坑的特点都一样:第一次手动修好不难,难的是让它每次自动续期后都不再翻车。
- 点赞
- 收藏
- 关注作者
评论(0)