# 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
nginx-lua：Nginx 1.19+，具有基于Alpine Linux，Amazon Linux，CentOS，Debian，Fedora和Ubuntu的LUA支持 （382个子文件） 
Dockerfile.alpine 12KB Dockerfile.amazonlinux 12KB Dockerfile.centos 12KB nginx-lua.conf 9KB nginx.extra.conf 3KB nginx-non-lua.conf 2KB Dockerfile.debian 12KB Dockerfile 19KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 18KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 17KB Dockerfile 12KB Dockerfile 12KB Dockerfile 12KB Dockerfile 12KB Dockerfile 12KB Dockerfile 12KB Dockerfile 12KB Dockerfile 12KB Dockerfile 12KB Dockerfile 12KB Dockerfile 12KB Dockerfile 12KB Dockerfile 12KB Dockerfile 12KB Dockerfile 12KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 11KB Dockerfile 8KB Dockerfile 8KB Dockerfile 8KB Dockerfile 8KB Dockerfile 8KB共 382 条
- 1
- 2
- 3
- 4
评论0