OpenResty 是什么？从 Nginx、LuaJIT 到应用场景
内容提要
OpenResty 是基于 Nginx、LuaJIT 和 Lua 库的开源 Web 平台，可在 Nginx 请求各阶段用 Lua 编写业务逻辑，无需重编译或额外服务，适用于 API 网关、WAF、动态路由、秒杀防护、CDN 边缘及 AI 网关等场景。每个 worker 单线程事件驱动，Lua 协程配合 cosocket 非阻塞访问后端。开源版免费，商业产品 Edge、XRay 分别用于多节点管理和问题诊断。
延伸解读
为什么把逻辑放进 Nginx 进程本身
文章反复强调这些场景的共同点：逻辑必须运行在请求路径上。若把鉴权、限流、路由交给外部服务，每个请求会多一次网络往返，团队还要多部署和监控一套服务；靠频繁 reload 更新路由，则会影响响应延迟并重置负载均衡状态。OpenResty 把 Lua 逻辑放进 Nginx 进程，请求无需转发到额外业务服务，路由更新也无需 reload，这是它相对“Nginx 配置 + 外部服务”方案的核心取舍。
协程与 cosocket 决定了它能扛并发
每个 worker 单线程事件驱动，每个请求在自己的 Lua 协程中执行；访问 Redis、MySQL 或上游 HTTP 时，cosocket 会在等待数据期间挂起当前协程，让 worker 去处理其他请求，数据到达后再恢复。对写代码的人来说这看起来像普通同步调用，但底层是非阻塞的。文章也给出边界：cosocket 适用于 rewrite、access、content 阶段和定时器，过滤器和 log 阶段更适合做轻量改写与记录。
开源版与商业产品的分工要分清
开源 OpenResty 免费，生产环境使用无需付费许可证，提供的是运行时能力。但文章明确指出，开源版本身不提供完整的控制台和配置分发系统；节点多到需要集中管理时，才考虑 OpenResty Edge 做多节点配置同步与回滚。问题定位通常仍依赖日志、指标和人工分析，CPU 飙高、内存上涨等可用 XRay 动态追踪。Edge、XRay 和私有库都是独立商业产品，不是运行开源 OpenResty 的前置条件。
看到 openresty 报错页不等于软件故障
文章提醒，网页上出现“403 Forbidden openresty”只说明该服务器运行的是 OpenResty，页底的 openresty/1.31.1.1 是服务器名称和版本号；403、404、502、504 等状态码由网站自身配置或后端服务决定，并不表示 OpenResty 软件本身出了故障。排查时，Lua 运行时错误会写入 Nginx 的 error.log，这是首先要看的地方；resty 命令行工具适合在服务器之外复现问题。
Q&A
OpenResty 和 Nginx 到底是什么关系？
OpenResty 不是独立于 Nginx 的新服务器，而是在 Nginx 基础上扩展出来的平台。它把增强版 Nginx 核心、LuaJIT 和一组 Lua 库打包成发行版，可执行文件仍然是 nginx，原有 Nginx 配置可以继续使用。版本号前三段就是捆绑的 Nginx 核心版本，第四段是 OpenResty 自己的修订号。
OpenResty 主要能用在哪些场景？
常用于服务位于流量入口、需要对每个请求进行判断和处理的场景，包括：API 网关与开放平台（鉴权、限流、路由、协议转换）、Web 应用防火墙（WAF）、动态路由与灰度发布、大促秒杀流量保护、CDN 边缘节点、AI/大模型网关，以及对并发性能要求较高的 Web 服务。
OpenResty 是怎么做到高并发的？
每个 worker 进程只用一个线程，通过事件驱动同时承载成千上万个连接。Lua 代码挂在 Nginx 请求处理阶段上执行，每个请求在自己的 Lua 协程中运行；访问后端时用 cosocket 非阻塞接口，等待数据期间挂起当前协程，让 worker 去处理其他请求，数据到达后再恢复。每个 worker 拥有独立的 LuaJIT 虚拟机，热点代码会被即时编译成机器码。
用 OpenResty 必须会写 Lua 吗？上手难不难？
上手时不需要。Nginx 的配置方式没有变，可以只在需要自定义逻辑的 location 里加几行 Lua，块外面仍是标准 Nginx 指令。OpenResty 使用的 LuaJIT 主要兼容 Lua 5.1，Lua 语法简洁，入门成本相对较低。
OpenResty 是免费的吗？商业产品是必需的吗？
OpenResty 是免费的开源软件，生产环境使用无需付费许可证，打包组件大多采用 BSD、MIT 等宽松许可证。OpenResty Inc. 还提供 OpenResty Edge（多节点集中管理）、OpenResty XRay（生产问题诊断）和 OpenResty 私有库等独立商业产品，它们都不是运行开源 OpenResty 的前置条件。
网页上出现“403 Forbidden openresty”是 OpenResty 出故障了吗？
不是。这说明该网站服务器运行的是 OpenResty，错误页底部的 openresty 或 openresty/1.31.1.1 是服务器名称和版本号。403、404、502、504 等状态码由该网站自己的配置或后端服务决定，并不表示 OpenResty 软件本身出了故障。访客应联系网站；管理员应先查看 Nginx 的 error.log 定位原因。
有哪些知名软件是基于 OpenResty 构建的？
开源 API 网关 Kong 和 Apache APISIX 都在各自官方文档中说明运行在 OpenResty（Nginx + LuaJIT）之上；OpenResty Inc. 的 OpenResty Edge 同样构建在 OpenResty 之上。因此即使公司从未直接安装 OpenResty，其请求流量也可能经过 OpenResty。
