Why OpenResty Powers High‑Performance Web Apps: A Lua‑Nginx Guide

Introduction

OpenResty® is a high‑performance web platform built on Nginx and Lua, bundling many well‑crafted Lua libraries, third‑party modules, and most dependencies. It enables developers to build dynamic web applications, services, and gateways that can handle tens of thousands to millions of concurrent connections.

Use‑Case Scenarios

While Nginx offers many advantages, developing Nginx modules traditionally requires C programming and deep knowledge of Nginx source code, which deters many developers. OpenResty solves this by integrating Lua, allowing developers to write business logic in a familiar scripting language and handling module compilation order automatically.

Operating Principle

Nginx uses a master‑worker model; the master process manages workers, and each worker runs an event loop. In OpenResty, each worker hosts a Lua VM, and incoming requests are processed in a Lua coroutine with isolated global variables (_G).

Coroutines are similar to threads: each has its own stack, local variables, and instruction pointer, but shares global state with other coroutines.

The main difference from threads is that coroutines switch cooperatively; only one coroutine runs at a time and it yields only when explicitly asked to suspend.

The following diagram (originally provided) illustrates this architecture:

Advantages

OpenResty merges the Nginx core with many third‑party modules and ships with a built‑in Lua environment, turning Nginx into a full‑featured web server. Leveraging Nginx’s event‑driven, non‑blocking I/O model, it delivers high‑performance web applications.

It also provides ready‑made components for MySQL, Redis, Memcached, etc., simplifying web development on Nginx. Companies such as JD.com, Taobao, and Qunar use the Nginx+Lua architecture for real‑time pricing, flash sales, dynamic services, and product pages.

Lua and LuaJIT

Lua is the scripting language used by OpenResty. Created in 1993 by a research group at the Pontifical Catholic University of Rio de Janeiro, Lua is lightweight, embeddable, and designed as a “glue” language. It is widely used in games (e.g., World of Warcraft) and in Redis for scripting.

Lua can call C libraries via its FFI, which is essential for OpenResty to invoke Nginx and OpenSSL functions. LuaJIT adds a Just‑In‑Time compiler that translates Lua code to native machine code, yielding performance comparable to compiled languages.

Benchmarks show LuaJIT 2 dramatically speeds up numeric computation, loops, function calls, coroutine switches, and string operations. It supports multiple architectures (i386, x86_64, ARM, PowerPC, MIPS) and remains fully compatible with standard Lua 5.1, with optional support for Lua 5.2/5.3 features.

Usage Example

Below is a simple OpenResty example taken from the official documentation.

mkdir ~/work
cd ~/work
mkdir logs/ conf/

Create conf/nginx.conf with the following content:

pid logs/nginx.pid;
events{
  worker_connections 1024;
}

http{
  server {
    listen 8080;
    location / {
      content_by_lua '
        ngx.say("hello, world")
      ';
    }
  }
}

Start the service: openresty -p `pwd` -c conf/nginx.conf If no errors appear, the service is running. Verify with a browser or curl:

$ curl -i localhost:8080
HTTP/1.1 200 OK
Server: openresty/1.19.9.1
Date: Wed, 22 Apr 2023 03:57:56 GMT
Content-Type: text/plain
Transfer-Encoding: chunked
Connection: keep-alive

hello, world

Embedding large Lua scripts directly in nginx.conf reduces readability. Instead, place Lua code in separate files. Create a lua/hello.lua containing ngx.say("hello, world") and adjust the configuration:

pid logs/nginx.pid;
events{
  worker_connections 1024;
}

http{
  server {
    listen 8080;
    location / {
      content_by_lua_file lua/hello.lua;
    }
  }
}

After restarting OpenResty, the same result is produced with cleaner configuration.