nginx-lua：Nginx 1.19+，具有基于Alpine Linux，Amazon Linux，CentOS，Debia...

# Nginx & Lua   --- [](LICENSE) [](https://github.com/fabiocicerchia/nginx-lua/pulls)         [](https://nginx-lua.readthedocs.io/en/latest/?badge=latest) [](https://app.fossa.com/projects/git%2Bgithub.com%2Ffabiocicerchia%2Fnginx-lua?ref=badge_shield) Nginx 1.19+ with Lua support based on Alpine Linux, Amazon Linux, CentOS, Debian, Fedora and Ubuntu. ## Quick reference - **Maintained by**: [Fabio Cicerchia](https://github.com/fabiocicerchia) - **Where to get help**: [the Docker Community Forums](https://forums.docker.com/), [the Docker Community Slack](https://dockr.ly/slack), or [Stack Overflow](https://stackoverflow.com/search?tab=newest&q=docker) ## Supported tags and respective `Dockerfile` links <!-- START_SUPPORTED_TAGS --> - [`1`,`1.19`,`1.19.7`,`alpine`,`1-alpine`,`1.19-alpine`,`1.19.7-alpine`,`1-alpine3.13.2`,`1-alpine3.13.2`,`1.19-alpine3.13.2`,`1.19.7-alpine3.13.2`,`latest`](https://github.com/fabiocicerchia/nginx-lua/blob/main/nginx/1.19.7/alpine/3.13.2/Dockerfile) - [`amazonlinux`,`1-amazonlinux`,`1.19-amazonlinux`,`1.19.7-amazonlinux`,`1-amazonlinux2.0.20210126.0`,`1-amazonlinux2.0.20210126.0`,`1.19-amazonlinux2.0.20210126.0`,`1.19.7-amazonlinux2.0.20210126.0`](https://github.com/fabiocicerchia/nginx-lua/blob/main/nginx/1.19.7/amazonlinux/2.0.20210126.0/Dockerfile) - [`debian`,`1-debian`,`1.19-debian`,`1-debian10.8`,`1-debian10.8`,`1.19.7-debian`,`1.19-debian10.8`,`1.19.7-debian10.8`](https://github.com/fabiocicerchia/nginx-lua/blob/main/nginx/1.19.7/debian/10.8/Dockerfile) - [`fedora`,`1-fedora`,`1-fedora33`,`1-fedora33`,`1.19-fedora`,`1.19-fedora33`,`1.19.7-fedora`,`1.19.7-fedora33`](https://github.com/fabiocicerchia/nginx-lua/blob/main/nginx/1.19.7/fedora/33/Dockerfile) - [`ubuntu`,`1-ubuntu`,`1.19-ubuntu`,`1-ubuntu20.04`,`1-ubuntu20.04`,`1.19.7-ubuntu`,`1.19-ubuntu20.04`,`1.19.7-ubuntu20.04`](https://github.com/fabiocicerchia/nginx-lua/blob/main/nginx/1.19.7/ubuntu/20.04/Dockerfile) <!-- END_SUPPORTED_TAGS --> **Note:** The full list of supported/unsupported tags can be found on [`docs/TAGS.md`](https://github.com/fabiocicerchia/nginx-lua/blob/main/docs/TAGS.md). ## Quick reference (cont.) - **Where to file issues:** [https://github.com/fabiocicerchia/nginx-lua/issues](https://github.com/fabiocicerchia/nginx-lua/issues) - **Supported architectures:** amd64 - **Published image artifact details:** [repo-info repo's docs/metadata/ directory](https://github.com/fabiocicerchia/nginx-lua/tree/main/docs/examples) ([history](https://github.com/fabiocicerchia/nginx-lua/commits/main/docs/metadata)) (image metadata, transfer size, etc) ## What is nginx? Nginx (pronounced "engine-x") is an open source reverse proxy server for HTTP, HTTPS, SMTP, POP3, and IMAP protocols, as well as a load balancer, HTTP cache, and a web server (origin server). The nginx project started with a strong focus on high concurrency, high performance and low memory usage. It is licensed under the 2-clause BSD-like license and it runs on Linux, BSD variants, Mac OS X, Solaris, AIX, HP-UX, as well as on other *nix flavors. It also has a proof of concept port for Microsoft Windows. > [wikipedia.org/wiki/Nginx](https://en.wikipedia.org/wiki/Nginx) ## What is Lua? Lua is a lightweight, high-level, multi-paradigm programming language designed primarily for embedded use in applications. Lua is cross-platform, since the interpreter of compiled bytecode is written in ANSI C, and Lua has a relatively simple C API to embed it into applications. > [wikipedia.org/wiki/Lua](https://en.wikipedia.org/wiki/Lua_(programming_language)) ## Why this repo and not OpenResty? | | nginx-lua | OpenResty | |--|--|--| | nginx latest version | `1.19.6` | `1.19.x` (last tested: `1.19.3`)* | | Alpine supported | ✅ | ✅ | | Amazon supported | ✅ | ✅ | | CentOS supported | ✅ | ✅ | | Debian supported | ✅ | ✅ | | Fedora supported | ✅ | ❌ | | Ubuntu supported | ✅ | ✅ | | Windows supported | ❌ | ✅ | * Note: Between OpenResty compatibility for `1.17.4` (28 Sep 2019) and `1.19.3` (3 Nov 2020) have passed ~10 months, and nginx 1.19.3 has been released on 29 Sep 2020. ## Features - Support for Lua. - Minimal size only, minimal layers. - Same build configure of official nginx image. - Security checks: Docker Bench Security, Snyk. - Docker Healthchecks. - Exposes default ports (`80` and `443`), easy to extend. - Support for multiple linux distros: Alpine, Amazon, CentOS, Debian, Fedora, Ubuntu. - Extra Lua Modules. - Performance Benchmarks. - LuaRocks Support. ## Typical Uses > Just to name a few: > > - Mashup'ing and processing outputs of various Nginx upstream outputs (proxy, drizzle, postgres, redis, memcached, and etc) in Lua, > - doing arbitrarily complex access control and security checks in Lua before requests actually reach the upstream backends, > - manipulating response headers in an arbitrary way (by Lua) > - fetching backend information from external storage backends (like redis, memcached, mysql, postgresql) and use that information to choose which upstream backend to access on-the-fly, > - coding up arbitrarily complex web applications in a content handler using synchronous but still non-blocking access to the database backends and other storage, > - doing very complex URL dispatch in Lua at rewrite phase, > - using Lua to implement advanced caching mechanism for Nginx's subrequests and arbitrary locations. > > The possibilities are unlimited as the module allows bringing together various > elements within Nginx as well as exposing the power of the Lua language to the > user. The module provides the full flexibility of scripting while offering > performance levels comparable with native C language programs both in terms of > CPU time as well as memory footprint thanks to LuaJIT 2.x. > > Other scripting language implementations typically struggle to match this > performance level. > > - <https://github.com/openresty/lua-nginx-module#typical-uses> ## How to use this image ### Hosting some simple static content ```console $ docker run --name some-nginx -v /some/content:/usr/share/nginx/html:ro -d fabiocicerchia/nginx-lua [...OMITTED...] ``` Alternatively, a simple `Dockerfile` can be used to generate a new image that includes the necessary content (which is a much cleaner solution than the bind mount above): ```dockerfile FROM fabiocicerchia/nginx-lua COPY static-html-directory /usr/share/nginx/html ``` Place this file in the same directory as your directory of content ("static-html-directory"), run `docker build -t some-content-nginx .`, then start your container: ```console $ docker run --name some-nginx -d some-content-nginx [...OMITTED...] ``` ### Exposing external port ```console $ docker run --name so