使用 acme.sh 申请 SSL 证书并配置 Nginx 自动续期
本文介绍如何使用 acme.sh 工具快速申请免费的 Let’s Encrypt SSL 证书,并配置 Nginx 实现自动续期。
参考原文:https://pangruitao.com/post/4812
本文使用AI自动生成
1. 背景说明
acme.sh 是一个功能强大的 Shell 脚本工具,可以方便地申请免费的 Let’s Encrypt SSL 证书,并且支持自动续期。相比手动申请证书的方式,acme.sh 极大地简化了流程。
免费证书存在以下问题:
- 证书有效期从 1 年缩短至 3 个月,频繁申请非常麻烦
- 每次需要手动申请、下载证书、通过 scp 上传服务器、重启 Nginx
- 整个过程繁琐且容易出错
使用 acme.sh 后,这些问题都可以自动化解决。
2. 安装 acme.sh
2.1 一键安装脚本
使用官方提供的一键安装脚本:
1 | |
安装完成后:
- 脚本会自动安装到
~/.acme.sh/目录 - 自动配置好环境变量
- 创建别名方便使用
验证安装是否成功:
1 | |
如果能看到版本号,说明安装成功。
2.2 注册账号
使用你的邮箱注册 Let’s Encrypt 账号(将 youremail@gmail.com 替换为你的真实邮箱):
1 | |
3. 配置 Nginx 验证
acme.sh 使用 HTTP 验证方式验证域名所有权,需要在 Nginx 中配置验证路径。
3.1 创建验证目录
首先创建验证文件存放目录:
1 | |
3.2 配置 Nginx
编辑 Nginx 配置文件(通常在 /etc/nginx/sites-enabled/ 目录,如果没有可以新建):
1 | |
添加以下配置:
1 | |
参数说明:
server_name:替换为你的实际域名/.well-known/acme-challenge/:Let’s Encrypt 验证专用路径root:指定验证文件的根目录
3.3 重启 Nginx
使配置生效:
1 | |
验证 Nginx 配置是否正确:
1 | |
4. 申请 SSL 证书
4.1 执行申请命令
使用 webroot 模式申请证书(将域名替换为你的):
1 | |
参数说明:
-d:指定要申请证书的域名(支持多个)--webroot:指定网站根目录,用于验证
4.2 验证申请结果
如果看到类似以下内容,说明申请成功:
1 | |
5. 安装证书到 Nginx
5.1 创建证书存放目录
建议将证书放在统一目录管理:
1 | |
5.2 安装证书
使用 acme.sh 的 install-cert 命令安装证书:
1 | |
参数说明:
--key-file:指定私钥文件存放路径--fullchain-file:指定完整证书链文件路径--reloadcmd:证书更新后自动重载 Nginx 的命令
5.3 配置 Nginx 使用 SSL
编辑 Nginx 配置文件,添加 HTTPS 配置:
1 | |
完整配置示例:
1 | |
5.4 重载 Nginx
使 SSL 配置生效:
1 | |
访问 https://yourdomain.com 验证证书是否生效。
6. 自动续期配置
6.1 验证自动续期任务
acme.sh 默认会自动添加 cron 任务,查看定时任务:
1 | |
一般可以看到类似:
1 | |
6.2 手动测试续期
可以手动测试续期流程:
1 | |
观察输出,确认续期成功后自动重载 Nginx。
6.3 续期日志
查看 acme.sh 的续期日志:
1 | |
7. 高级配置(可选)
7.1 使用 DNS 验证模式
如果无法使用 webroot 验证,可以使用 DNS 验证:
1 | |
7.2 配置 SSL 安全参数
在 Nginx 配置中添加 SSL 安全优化:
1 | |
8. 常见问题排查
8.1 证书申请失败
检查 Nginx 配置是否正确:
1 | |
8.2 续期失败
检查 Nginx 是否能正常重载:
1 | |
8.3 证书路径错误
确认证书文件权限:
1 | |
9. 清理和备份
9.1 备份证书
建议定期备份证书目录:
1 | |
9.2 清理旧证书
acme.sh 会自动管理证书,如需手动清理:
1 | |
以上。完结撒花 🎉!