1. 为什么你需要自动化 HTTPS 部署?
如果你自己折腾过网站,肯定对下面这个场景不陌生:好不容易把网站搭起来,域名也解析好了,结果浏览器上那个“不安全”的小锁头一直亮着,看着就让人心里不踏实。然后你开始研究 SSL 证书,发现商业证书一年要好几百甚至上千,免费的要么流程复杂,要么三个月就过期,手动续期简直是运维的噩梦。更别提当你有多个域名、甚至多个子域名需要管理时,手动配置和更新证书的工作量会呈指数级增长。
这就是为什么我们需要一套自动化、高效率的解决方案。想象一下,你的网站能自动获取并更新免费的、受浏览器信任的 SSL 证书,同时承载流量的 Web 服务器性能强劲、配置灵活,还能轻松管理成百上千个域名的转发规则。这听起来像是大公司的专属架构?其实不然,利用 Let‘s Encrypt 和 OpenResty 这两大神器,个人开发者或中小团队也能轻松搭建出这样一套企业级的自动化 HTTPS 部署与域名管理流水线。
我自己的好几个项目,从个人博客到内部工具平台,都跑在这套组合上。最直观的感受就是“省心”。证书快过期了?系统自己会在半夜默默更新好,我完全不用惦记。新加一个测试用的子域名?写几行配置,重启一下服务,几分钟就搞定,HTTPS 自动生效。这套方案的核心价值,就是把我们从繁琐、重复的运维操作中解放出来,让我们能更专注于业务开发本身。接下来,我就把自己踩过坑、验证过的最佳实践,掰开揉碎了分享给你。
2. 搭建前的准备:认识你的工具
工欲善其事,必先利其器。在动手之前,我们得先搞清楚手里的“家伙事儿”到底能干什么。
2.1 Let‘s Encrypt:你的免费、自动化证书颁发机构
Let‘s Encrypt 绝对可以说是互联网的“活雷锋”。它是一个非营利的证书颁发机构(CA),宗旨就是让整个 Web 都启用 HTTPS。它提供的 SSL/TLS 证书完全免费,并且被所有主流浏览器和操作系统信任。这意味着你用它的证书,用户访问你的网站时,浏览器会显示漂亮的安全锁标志,和付费证书的效果一模一样。
但 Let‘s Encrypt 最厉害的地方在于自动化。它设计了一套名为 ACME(自动证书管理环境)的协议。简单理解,就是你的服务器可以通过这套协议和 Let‘s Encrypt 的服务器“对话”,自动完成域名所有权验证、证书申请、签发和续期的全过程,无需人工干预。证书有效期是 90 天,这听起来很短,但正是为了鼓励和强制大家使用自动化续期,从而保证安全性的持续有效。我们后面要用的 Certbot,就是官方推荐的、实现了 ACME 协议的客户端工具,用起来非常顺手。
2.2 OpenResty:不只是 Nginx,更是高性能应用平台
很多人以为 OpenResty 就是个高性能的 Nginx。这么说对,但不全对。OpenResty 的创始人章亦春老师给它下的定义是“一个基于 Nginx 与 Lua 的高性能 Web 平台”。它内置了 LuaJIT 引擎,让你可以直接在 Nginx 的配置文件中嵌入 Lua 脚本,或者编写复杂的 Lua 应用。
这带来了无与伦比的灵活性。比如,我们可以在流量入口处(OpenResty)用 Lua 脚本动态判断请求该转发到哪个后端服务,或者直接生成 API 响应,甚至连接数据库做认证。对于我们的场景来说,OpenResty 相比原生 Nginx 有几个关键优势:1) 动态加载 SSL 证书:通过 Lua 模块,可以实现不重启服务就热更新证书,这对自动化续期后的证书生效至关重要。2) 更精细的流量控制:用 Lua 可以轻松编写复杂的域名匹配、路由规则。3) 性能极致:它继承了 Nginx 的高并发处理能力,同时通过 LuaJIT 保证了扩展逻辑的执行效率。
简单说,Let‘s Encrypt 负责自动化地提供“安全凭证”(SSL 证书),而 OpenResty 负责高效、智能地使用这些凭证来管理流量。两者结合,就构成了我们自动化部署体系的基石。
3. 一步步搭建自动化 HTTPS 基础设施
理论说再多不如动手做一遍。我们假设你有一台安装了 Ubuntu 20.04/22.04 的云服务器,并且已经将你的主域名(例如 yourdomain.com)解析到了这台服务器的公网 IP 地址。
3.1 安装与配置 Certbot:让证书获取变简单
首先,更新系统包列表并安装 Certbot。这里我们使用系统包管理器安装,最简单稳定。
sudo apt update
sudo apt install certbot -y
安装完成后,我们就可以申请证书了。Let‘s Encrypt 验证你对域名拥有权的方式主要有两种:HTTP-01 和 DNS-01 挑战。
- HTTP-01:Certbot 会在你的服务器上临时启动一个 web 服务(使用 80 端口),Let‘s Encrypt 的服务器会尝试访问一个特定的 URL 来验证。这要求你的服务器 80 端口可被公网访问。对于大多数有公网 IP 的服务器,这是最方便的方式。
- DNS-01:Certbot 会要求你在域名的 DNS 解析记录里添加一条特定的 TXT 记录。这种方式特别适合那些服务器端口不开放(比如某些企业内网穿透),或者你要申请通配符证书(
*.yourdomain.com)的情况。
我们先演示最常用的 HTTP-01 方式(Standalone 模式)申请单个域名和通配符证书:
# 申请包含主域名和通配符子域名的证书
sudo certbot certonly --standalone --agree-tos --no-eff-email --email admin@yourdomain.com -d yourdomain.com -d *.yourdomain.com
运行这个命令时,Certbot 会:
- 检查 80 和 443 端口是否被占用(因为它要临时监听)。
- 为你列出的每个域名(
yourdomain.com和*.yourdomain.com)向 Let‘s Encrypt 申请证书。 - 自动完成验证过程。
- 如果成功,证书和密钥文件会保存在
/etc/letsencrypt/live/yourdomain.com/目录下。
重要目录说明:
/etc/letsencrypt/live/yourdomain.com/:这里存放的是最新证书的符号链接。fullchain.pem:证书链文件(你的证书+中间CA证书),配置 OpenResty 的ssl_certificate时就用它。privkey.pem:你的私钥文件,对应ssl_certificate_key。cert.pem:仅包含你的证书。chain.pem:仅包含中间CA证书。
/etc/letsencrypt/archive/yourdomain.com/:这里存放所有历史版本的证书文件,方便回滚。/etc/letsencrypt/renewal/yourdomain.com.conf:这个域的续期配置文件,记录了申请时的参数。
3.2 安装与初探 OpenResty
接下来安装 OpenResty。官方提供了详细的安装指南,我们以 Debian/Ubuntu 为例:
# 导入官方 GPG 密钥
wget -O - https://openresty.org/package/pubkey.gpg | sudo apt-key add -
# 添加官方仓库
echo "deb http://openresty.org/package/debian $(lsb_release -sc) openresty" | sudo tee /etc/apt/sources.list.d/openresty.list
# 更新并安装
sudo apt update
sudo apt install openresty -y
安装完成后,OpenResty 的主要组件(其实就是增强版的 Nginx)就已经就位了。它的二进制文件通常是 openresty,配置文件目录在 /usr/local/openresty/nginx/conf/,默认的网页根目录在 /usr/local/openresty/nginx/html/。
你可以通过以下命令启动、停止、重启服务,或者测试配置文件语法:
sudo systemctl start openresty # 启动
sudo systemctl stop openresty # 停止
sudo systemctl restart openresty # 重启
sudo systemctl reload openresty # 平滑重载配置(不中断连接)
sudo openresty -t # 测试配置文件语法
先启动服务,然后用浏览器访问你的服务器 IP,如果看到 OpenResty 的欢迎页面,说明安装成功。
4. 核心配置:让 OpenResty 用上证书并管理域名
现在到了最关键的一步:配置 OpenResty,让它使用我们刚申请的 SSL 证书,并按照我们的意愿来转发不同域名的流量。
4.1 基础 SSL 与多域名转发配置
我们不建议直接修改默认的 nginx.conf 主文件,而是采用模块化的方式。在 /usr/local/openresty/nginx/conf/ 下创建一个 vhost(虚拟主机)目录,然后把每个域名或每类服务的配置放在单独的文件里。
首先,编辑主配置文件 /usr/local/openresty/nginx/conf/nginx.conf,在 http 块内添加一行,包含我们即将创建的虚拟主机配置:
http {
# ... 其他原有配置 ...
# 包含虚拟主机配置文件
include /usr/local/openresty/nginx/conf/vhost/*.conf;
}
然后,创建 vhost 目录和我们的第一个配置文件,比如 yourdomain.com.conf:
# /usr/local/openresty/nginx/conf/vhost/yourdomain.com.conf
# 主域名服务:转发到本地的 8080 端口应用(例如一个Node.js应用)
server {
# 监听 80 端口,将所有 HTTP 请求重定向到 HTTPS
listen 80;
server_name yourdomain.com www.yourdomain.com;
return 301 https://$server_name$request_uri;
}
server {
# 监听 443 端口,启用 SSL
listen 443 ssl http2;
server_name yourdomain.com www.yourdomain.com;
# 指定 SSL 证书和密钥路径(指向 Let's Encrypt 的证书)
ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
# 推荐的安全强化 SSL 配置(可选但建议)
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
# 根路径请求处理
location / {
# 代理到本地 8080 端口运行的后端服务
proxy_pass http://127.0.0.1:8080;
# 传递重要的客户端头信息给后端,这对很多应用框架至关重要
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade"; # 支持 WebSocket
# 一些超时和缓冲区的优化设置
proxy_connect_timeout 60s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;
proxy_buffering off;
}
# 可选:静态文件服务,如果后端服务不直接处理静态文件的话
location /static/ {
alias /path/to/your/static/files/;
expires 30d;
add_header Cache-Control "public, immutable";
}
}
再创建一个子域名的配置,比如 test.yourdomain.com.conf:
# /usr/local/openresty/nginx/conf/vhost/test.yourdomain.com.conf
server {
listen 80;
server_name test.yourdomain.com;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl http2;
server_name test.yourdomain.com;
# 注意:这里使用的是同一个通配符证书!
ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8090; # 转发到另一个后端端口
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
配置完成后,运行 sudo openresty -t 测试语法,无误后执行 sudo systemctl reload openresty 平滑重载配置。现在,访问 https://yourdomain.com 和 https://test.yourdomain.com,应该都能看到安全锁,并且流量被正确转发到不同的后端端口。
4.2 进阶:使用 Lua 实现更动态的域名管理
如果你的域名非常多,或者需要根据某些规则动态路由,手动写一堆 server 块就太累了。这时 OpenResty 的 Lua 能力就派上用场了。我们可以写一个 Lua 脚本,根据请求的域名动态设置上游(后端)服务。
首先,确保 OpenResty 安装了 lua-resty-core 等库(通常默认已安装)。然后,我们可以创建一个 Lua 文件来定义路由映射:
-- /usr/local/openresty/nginx/conf/lua/domain_router.lua
local _M = {}
-- 定义一个域名到后端地址的映射表
-- 可以很容易地从数据库、Redis 或配置文件读取
_M.routes = {
["yourdomain.com"] = "http://127.0.0.1:8080",
["www.yourdomain.com"] = "http://127.0.0.1:8080",
["test.yourdomain.com"] = "http://127.0.0.1:8090",
["api.yourdomain.com"] = "http://127.0.0.1:3000",
["blog.yourdomain.com"] = "http://127.0.0.1:2368", -- 假设是 Ghost 博客
}
function _M.get_upstream(host)
-- 去除端口号
host = host:match("([^:]+)")
return _M.routes[host]
end
return _M
接着,修改我们的 OpenResty 配置,使用一个通用的 server 块,通过 Lua 脚本动态决定 proxy_pass:
# /usr/local/openresty/nginx/conf/vhost/dynamic.conf
server {
listen 80;
server_name _; # 匹配所有域名
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name _; # 使用默认或通配符服务器名,靠 Lua 来区分
# 使用通配符证书
ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
# 在 access_by_lua 阶段执行路由逻辑
access_by_lua_block {
local router = require "domain_router"
local upstream = router.get_upstream(ngx.var.host)
if not upstream then
ngx.log(ngx.ERR, "No upstream found for host: ", ngx.var.host)
ngx.exit(ngx.HTTP_NOT_FOUND) -- 或者转发到一个默认页面
return
end
-- 将上游地址存储在 nginx 变量中,供后续使用
ngx.var.backend = upstream
}
location / {
# 使用 Lua 脚本设置的上游地址
proxy_pass $backend;
proxy_set_header Host $host;
# ... 其他 proxy_set_header ...
}
}
这种方式的优势非常明显:增加新域名时,只需要更新 Lua 脚本中的 routes 表,然后重载 OpenResty 配置即可,无需为每个域名创建单独的 server 配置块。这对于管理大量域名或进行 A/B 测试、蓝绿部署等场景非常有用。
5. 实现真正的自动化:证书自动续期与热更新
Let‘s Encrypt 证书 90 天有效期的设计,就是为了推动自动化。我们不仅要自动续期,还要让续期后的新证书在 OpenResty 中无缝生效,不中断任何在线服务。
5.1 配置 Certbot 自动续期
Certbot 本身内置了强大的续期功能。首先,我们可以进行一次模拟续期测试,确保流程畅通:
sudo certbot renew --dry-run
如果看到 “Congratulations, all renewals succeeded” 之类的提示,说明续期预演成功。接下来,我们需要设置一个定时任务(Cron Job)来定期执行真正的续期操作。编辑 root 用户的 crontab:
sudo crontab -e
在文件末尾添加一行。下面的例子设定在每天凌晨 3 点检查并续期证书,并且只续期那些在 30 天内过期的证书(--quiet 参数让它在成功时不输出任何信息,避免产生不必要的系统邮件):
0 3 * * * /usr/bin/certbot renew --quiet --post-hook "systemctl reload openresty"
这里的关键是 --post-hook 参数。它指定在证书成功续期后要执行的命令。我们这里设置的是重载 OpenResty 服务。systemctl reload openresty 是平滑重载,Nginx/OpenResty 会启动新的 worker 进程加载新配置(包括新的证书文件),然后优雅地关闭旧的 worker 进程,实现零停机更新。
5.2 进阶:使用 lua-resty-auto-ssl 实现完全零停机
--post-hook 重载虽然短暂,但理论上在重载的瞬间,worker 进程切换可能对超长连接有细微影响。对于追求极致可用性的场景,我们可以使用一个名为 lua-resty-auto-ssl 的 OpenResty 第三方库。这个库更加强大,它:
- 内置了一个 ACME 客户端,可以直接与 Let‘s Encrypt 通信,无需外部 Certbot。
- 在内存中动态管理 SSL 证书,当收到一个域名的 SSL 请求时,如果内存中没有,它会自动发起申请并缓存。
- 完全的热加载,证书的申请、获取、更新都在 Lua 层面完成,完全不需要重启或重载 Nginx。
它的配置相对复杂一些,需要安装额外的依赖(如 OpenResty 的 lua-resty-http 库),并编写更复杂的 Lua 初始化脚本和 Nginx 配置。其核心原理是使用一个“SSL 证书握手处理器”,在 TLS 握手阶段拦截请求,查询或申请证书。对于大多数中小型项目,使用 Certbot + post-hook 的方案已经足够稳定和高效。如果你管理的域名数量巨大(成千上万),或者对“零停机”有极端要求,那么深入研究 lua-resty-auto-ssl 会是一个值得的投资。
6. 避坑指南与性能调优
在实际部署中,我遇到过不少问题,这里总结几个最常见的“坑”和解决方案。
坑1:证书申请失败,提示端口 80 被占用。
这是因为 Certbot 的 --standalone 模式需要临时占用 80 端口。确保在运行 certbot certonly 命令时,OpenResty/Nginx 或其他 Web 服务已经暂时停止。一个稳妥的做法是写一个小脚本:先停止 OpenResty,再申请证书,最后启动 OpenResty。对于续期,Certbot 默认会用 --webroot 模式(如果之前用过),它不需要停止 Web 服务,而是通过在网站根目录下放置验证文件来完成,更友好。
坑2:通配符证书申请失败。
通配符证书(*.domain.com)必须使用 DNS-01 挑战方式。这意味着你需要配置你的域名服务商(如 Cloudflare、阿里云DNS)的 API 密钥,让 Certbot 能够自动添加和删除 TXT 记录。这需要安装 Certbot 对应的 DNS 插件,例如 Cloudflare 的 certbot-dns-cloudflare。流程是:获取API密钥 -> 安装插件 -> 使用 --dns-cloudflare 等参数运行 Certbot。虽然步骤稍多,但一劳永逸,之后续期就全自动了。
坑3:OpenResty 配置错误导致 SSL 握手失败。 检查以下几点:
ssl_certificate和ssl_certificate_key路径是否正确,文件权限是否可读(通常要求 root 或 nginx 用户可读)。- 证书和密钥是否配对。可以用命令
openssl x509 -noout -modulus -in fullchain.pem | openssl md5和openssl rsa -noout -modulus -in privkey.pem | openssl md5检查两者的 MD5 是否一致。 - 防火墙是否开放了 443 端口。
性能调优建议:
- 启用 HTTP/2:在
listen 443 ssl后面加上http2,可以显著提升多资源加载页面的性能。 - 优化 SSL 会话缓存:我们配置中的
ssl_session_cache和ssl_session_timeout可以减少 TLS 握手开销,对频繁连接的客户端(如移动App)有益。 - 调整 Worker 进程:
worker_processes auto;通常是个好选择,让 OpenResty 根据 CPU 核心数自动设置。 - 连接池与超时:如果反向代理的后端服务较多,可以配置
upstream块并设置keepalive连接池,减少频繁建立后端连接的开销。同时合理设置proxy_connect_timeout、proxy_read_timeout等,避免慢后端拖死前端。
7. 扩展思路:这套方案还能做什么?
掌握了 Let‘s Encrypt 和 OpenResty 的核心用法后,你可以把思路打开,这套组合拳的潜力远不止于简单的域名转发。
场景一:构建安全的 API 网关。 你可以用 OpenResty 作为所有内部服务的统一入口。在 Lua 脚本中实现身份认证(JWT 校验)、限流(令牌桶算法)、请求日志记录、参数校验等通用逻辑。这样,每个后端微服务只需要关注业务,安全和控制层由网关统一处理,证书还是全自动管理。
场景二:静态站点托管与 CDN 回源。
用 OpenResty 直接托管你的静态网站(如 Vue/React 构建的 SPA),配置 gzip 压缩、设置长的缓存头。对于动态内容,再反向代理到后端 API。同时,你可以轻松配置它与云存储(如 AWS S3、阿里云 OSS)结合,作为 CDN 的回源服务器,实现动静分离。
场景三:多环境配置管理。
利用 Lua 脚本,你可以根据请求头(如 X-Env: staging)或特定域名(如 staging.yourdomain.com),将流量导向不同的后端集群(开发、测试、预发布环境)。所有环境共享同一套自动化证书管理流程,运维复杂度并不会增加。
从我自己的经验来看,一旦这套自动化流程跑顺了,你会发现自己对服务器运维的恐惧感大大降低。新项目上线,要做的无非就是解析域名、写一段路由配置、重载服务,剩下的“安全”和“续期”问题,系统都默默帮你搞定了。这种把重复性工作交给工具,把创造力留给自己的感觉,才是技术带来的真正愉悦。



被折叠的 条评论
为什么被折叠?



