Nginx 1.19+ with Lua support based on Alpine Linux, Amazon Linux, Fedora and Ubuntu.
This project is only maintained by one person, Fabio Cicerchia.
It started as a simple docker image, now it updates automatically periodically and provides support for multiple disto ๐
Maintaining a project is a very time consuming activity, especially when done alone ๐ช
I really want to make this project better and become super cool ๐
If you'd like to support this open-source project I'll appreciate any kind of contribution.
- Maintained by: Fabio Cicerchia
- Where to get help: the Docker Community Forums, the Docker Community Slack, or Stack Overflow
1
,1.21
,1.21.4
,alpine
,1-alpine
,1.21-alpine
,1.21.4-alpine
,1-alpine3.15.0
,1-alpine3.15.0
,1.21-alpine3.15.0
,1.21.4-alpine3.15.0
,latest
amazonlinux
,1-amazonlinux
,1.21-amazonlinux
,1.21.4-amazonlinux
,1-amazonlinux2.0.20211201.0
,1-amazonlinux2.0.20211201.0
,1.21-amazonlinux2.0.20211201.0
,1.21.4-amazonlinux2.0.20211201.0
debian
,1-debian
,1.21-debian
,1-debian11.1
,1-debian11.1
,1.21.4-debian
,1.21-debian11.1
,1.21.4-debian11.1
fedora
,1-fedora
,1-fedora35
,1-fedora35
,1.21-fedora
,1.21-fedora35
,1.21.4-fedora
,1.21.4-fedora35
ubuntu
,1-ubuntu
,1.21-ubuntu
,1-ubuntu20.04
,1-ubuntu20.04
,1.21.4-ubuntu
,1.21-ubuntu20.04
,1.21.4-ubuntu20.04
Note: The full list of supported/unsupported tags can be found on docs/TAGS.md
.
- Where to file issues: https://github.com/fabiocicerchia/nginx-lua/issues
- Supported architectures: amd64
- Published image artifact details: repo-info repo's docs/metadata/ directory (history) (image metadata, transfer size, etc)
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.
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.
nginx-lua | OpenResty | |
---|---|---|
nginx latest version | 1.21.0 |
1.19.x (last tested: 1.19.9 )ยน |
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.
- 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
and443
), easy to extend. - Support for multiple linux distros: Alpine, Amazon, Debian, Fedora, Ubuntu.
- Extra Lua Modules.
- Performance Benchmarks.
- LuaRocks Support.
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.
$ 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):
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:
$ docker run --name some-nginx -d some-content-nginx
[...OMITTED...]
$ docker run --name some-nginx -d -p 8080:80 some-content-nginx
[...OMITTED...]
Then you can hit http://localhost:8080
or http://host-ip:8080
in your browser.
$ docker run --name my-custom-nginx-container -v /host/path/nginx.conf:/etc/nginx/nginx.conf:ro -d fabiocicerchia/nginx-lua
[...OMITTED...]
For information on the syntax of the nginx configuration files, see the official documentation (specifically the Beginner's Guide). If you wish to adapt the default configuration, use something like the following to copy it from a running nginx container:
$ docker run --name tmp-nginx-container -d fabiocicerchia/nginx-lua
[...OMITTED...]
$ docker cp tmp-nginx-container:/etc/nginx/nginx.conf /host/path/nginx.conf
[...OMITTED...]
$ docker rm -f tmp-nginx-container
[...OMITTED...]
This can also be accomplished more cleanly using a simple Dockerfile
(in /host/path/
):
FROM fabiocicerchia/nginx-lua
COPY nginx.conf /etc/nginx/nginx.conf
If you add a custom CMD
in the Dockerfile, be sure to include -g daemon off;
in the CMD
in order for nginx to stay in the foreground, so that Docker can track the process properly (otherwise your container will stop immediately after starting)!
Then build the image with docker build -t custom-nginx .
and run it as follows:
$ docker run --name my-custom-nginx-container -d custom-nginx
[...OMITTED...]
Out-of-the-box, nginx doesn't support environment variables inside most configuration blocks. But this image has a function, which will extract environment variables before nginx starts. Here is an example using docker-compose.yml:
web:
image: fabiocicerchia/nginx-lua
volumes:
- ./templates:/etc/nginx/templates
ports:
- "8080:80"
environment:
- NGINX_HOST=foobar.com
- NGINX_PORT=80
By default, this function reads template files in /etc/nginx/templates/*.template
and outputs the result of executing envsubst
to /etc/nginx/conf.d
.
So if you place templates/default.conf.template
file, which contains variable references like this:
listen ${NGINX_PORT};
outputs to /etc/nginx/conf.d/default.conf
like this:
listen 80;
This behavior can be changed via the following environment variables:
NGINX_ENVSUBST_TEMPLATE_DIR
- A directory which contains template files (default:
/etc/nginx/templates
) - When this directory doesn't exist, this function will do nothing about template processing.
- A directory which contains template files (default:
NGINX_ENVSUBST_TEMPLATE_SUFFIX
- A suffix of template files (default:
.template
) - This function only processes the files whose name ends with this suffix.
- A suffix of template files (default:
NGINX_ENVSUBST_OUTPUT_DIR
- A directory where the result of executing envsubst is output (default:
/etc/nginx/conf.d
) - The output filename is the template filename with the suffix removed.
- ex.)
/etc/nginx/templates/default.conf.template
will be output with the filename/etc/nginx/conf.d/default.conf
.
- ex.)
- This directory must be writable by the user running a container.
- A directory where the result of executing envsubst is output (default:
To run nginx in read-only mode, you will need to mount a Docker volume to every location where nginx writes information. The default nginx configuration requires write access to /var/cache
and /var/run
. This can be easily accomplished by running nginx as follows:
$ docker run -d -p 80:80 --read-only -v $(pwd)/nginx-cache:/var/cache/nginx -v $(pwd)/nginx-pid:/var/run fabiocicerchia/nginx-lua
[...OMITTED...]
If you have a more advanced configuration that requires nginx to write to other locations, simply add more volume mounts to those locations.
Images since version 1.19.3 come with nginx-debug
binary that produces verbose output when using higher log levels. It can be used with simple CMD substitution:
$ docker run --name my-nginx -v /host/path/nginx.conf:/etc/nginx/nginx.conf:ro -d fabiocicerchia/nginx-lua nginx-debug -g 'daemon off;'
[...OMITTED...]
Similar configuration in docker-compose.yml may look like this:
web:
image: fabiocicerchia/nginx-lua
volumes:
- ./nginx.conf:/etc/nginx/nginx.conf:ro
command: [nginx-debug, '-g', 'daemon off;']
Since version 1.19.0, a verbose entrypoint was added. It provides information on what's happening during container startup. You can silence this output by setting environment variable NGINX_ENTRYPOINT_QUIET_LOGS
:
$ docker run -d -e NGINX_ENTRYPOINT_QUIET_LOGS=1 fabiocicerchia/nginx-lua
[...OMITTED...]
Since 1.17.0, both alpine- and debian-based images variants use the same user and group ids to drop the privileges for worker processes:
$ id
uid=101(nginx) gid=101(nginx) groups=101(nginx)
It is possible to run the image as a less privileged arbitrary UID/GID. This, however, requires modification of nginx configuration to use directories writeable by that specific UID/GID pair:
$ docker run -d -v $PWD/nginx.conf:/etc/nginx/nginx.conf fabiocicerchia/nginx-lua
[...OMITTED...]
where nginx.conf in the current directory should have the following directives re-defined:
pid /tmp/nginx.pid;
And in the http context:
http {
client_body_temp_path /tmp/client_temp;
proxy_temp_path /tmp/proxy_temp_path;
fastcgi_temp_path /tmp/fastcgi_temp;
uwsgi_temp_path /tmp/uwsgi_temp;
scgi_temp_path /tmp/scgi_temp;
...
}
-
Supported OS
- Alpine Linux (~50MB)
- Amazon Linux (~225MB)
- Debian (~200MB)
- Fedora (~375MB)
- Ubuntu (~215MB)
-
Additional Modules
- ngx_http_addition_module
- ngx_http_auth_request_module
- ngx_http_dav_module
- ngx_http_flv_module
- ngx_http_geoip_module
- ngx_http_gunzip_module
- ngx_http_gzip_static_module
- ngx_http_mp4_module
- ngx_http_random_index_module
- ngx_http_realip_module
- ngx_http_secure_link_module
- ngx_http_slice_module
- ngx_http_ssl_module
- ngx_http_stub_status_module
- ngx_http_sub_module
- ngx_http_v2_module
- ngx_mail_ssl_module
- ngx_stream_realip_module
- ngx_stream_ssl_module
- ngx_stream_ssl_preread_module
- headers-more-nginx-module
- lua-resty-cookie
- lua-resty-dns
- lua-resty-memcached
- lua-resty-mysql
- lua-resty-redis
- lua-resty-shell
- lua-resty-upstream-healthcheck
- lua-resty-websocket
- nginx-lua-prometheus
- stream-lua-nginx-module
configure arguments: --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --http-client-body-temp-path=/var/cache/nginx/client_temp --http-proxy-temp-path=/var/cache/nginx/proxy_temp --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp --http-scgi-temp-path=/var/cache/nginx/scgi_temp --with-perl_modules_path=/usr/lib/perl5/vendor_perl --user=nginx --group=nginx --with-compat --with-file-aio --with-threads --with-http_addition_module --with-http_auth_request_module --with-http_dav_module --with-http_flv_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_mp4_module --with-http_random_index_module --with-http_realip_module --with-http_secure_link_module --with-http_slice_module --with-http_ssl_module --with-http_stub_status_module --with-http_sub_module --with-http_v2_module --with-mail --with-mail_ssl_module --with-stream --with-stream_realip_module --with-stream_ssl_module --with-stream_ssl_preread_module --add-module=/lua-nginx-module-0.10.17 --add-module=/ngx_devel_kit-0.3.1 --add-module=/lua-upstream-nginx-module-0.07 --add-module=/headers-more-nginx-module-d6d7ebab3c0c5b32ab421ba186783d3e5d2c6a17 --add-module=/stream-lua-nginx-module-0.0.8 --with-cc-opt='-g -O2 -fstack-protector-strong -Wformat -Werror=format-security -Wp,-D_FORTIFY_SOURCE=2 -fPIC' --with-ld-opt='-Wl,-rpath,/usr/local/lib -Wl,-z,relro -Wl,-z,now -Wl,--as-needed -pie'
The following are the available build-time options. They can be set using the --build-arg
CLI argument.
Key | Default | Description |
---|---|---|
DOCKER_IMAGE |
fabiocicerchia/nginx-lua |
The image name. |
DOCKER_IMAGE_OS |
alpine |
The Docker base image to build FROM . |
DOCKER_IMAGE_TAG |
3.14.0 |
The Docker image tag to build FROM . |
BUILD_DATE |
This label contains the Date/Time the image was built. | |
VCS_REF |
Identifier for the version of the source code from which this image was built. | |
EXTENDED_IMAGE |
1 |
Flag to identify if extended image (which contains extra modules). See Minimal Image. |
VER_NGX_DEVEL_KIT |
0.3.1 |
The version of Nginx Development Kit to use. |
VER_LUAJIT |
2.1-20210510 |
The version of LuaJIT to use. |
LUAJIT_LIB |
/usr/local/lib |
Tell nginx's build system where to find LuaJIT 2.0 |
LUAJIT_INC |
/usr/local/include/luajit-2.1 |
Tell nginx's build system where to find LuaJIT 2.0 |
LD_LIBRARY_PATH |
/usr/local/lib/:$LD_LIBRARY_PATH |
Search path environment variable for the linux shared library. |
VER_LUA |
5.4 |
The version of Lua to use. |
VER_LUAROCKS |
3.7.0 |
The version of LuaRocks to use. |
VER_LUA_NGINX_MODULE |
0.10.20 |
The version of ngx_http_lua_module to use. |
VER_LUA_RESTY_CORE |
0.1.22 |
The version of lua-resty-core to use. |
LUA_LIB_DIR |
/usr/local/share/lua/5.1 |
Path to Lua library directory. |
VER_LUA_RESTY_LRUCACHE |
0.11 |
The version of lua-resty-lrucache to use. |
VER_OPENRESTY_HEADERS |
d6d7ebab3c0c5b32ab421ba186783d3e5d2c6a17 |
The version of headers-more-nginx-module to use. |
VER_CLOUDFLARE_COOKIE |
303e32e512defced053a6484bc0745cf9dc0d39e |
The version of lua-resty-cookie to use. |
VER_OPENRESTY_DNS |
0.22 |
The version of lua-resty-dns to use. |
VER_OPENRESTY_MEMCACHED |
0.16 |
The version of lua-resty-memcached to use. |
VER_OPENRESTY_MYSQL |
0.24 |
The version of lua-resty-mysql to use. |
VER_OPENRESTY_REDIS |
0.29 |
The version of lua-resty-redis to use. |
VER_OPENRESTY_SHELL |
0.03 |
The version of lua-resty-shell to use. |
VER_OPENRESTY_HEALTHCHECK |
0.06 |
The version of lua-resty-upstream-healthcheck to use. |
VER_OPENRESTY_WEBSOCKET |
0.08 |
The version of lua-resty-websocket to use. |
VER_LUA_UPSTREAM |
0.07 |
The version of lua-upstream-nginx-module to use. |
VER_PROMETHEUS |
0.20210206 |
The version of nginx-lua-prometheus to use. |
VER_OPENRESTY_STREAMLUA |
0.0.10 |
The version of stream-lua-nginx-module to use. |
VER_NGINX |
1.21.0 |
The version of nginx to use. |
NGX_CFLAGS |
-g -O2 -fstack-protector-strong -Wformat -Werror=format-security -Wp,-D_FORTIFY_SOURCE=2 -fPIC |
Sets additional parameters that will be added to the CFLAGS variable. |
NGX_LDOPT |
-Wl,-rpath,/usr/local/lib -Wl,-z,relro -Wl,-z,now -Wl,--as-needed -pie |
Sets additional parameters that will be used during linking. |
NGINX_BUILD_CONFIG |
--prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --http-client-body-temp-path=/var/cache/nginx/client_temp --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp --http-proxy-temp-path=/var/cache/nginx/proxy_temp --http-scgi-temp-path=/var/cache/nginx/scgi_temp --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp --user=nginx --group=nginx --add-module=/lua-nginx-module-${VER_LUA_NGINX_MODULE} --add-module=/ngx_devel_kit-${VER_NGX_DEVEL_KIT} --with-compat --with-file-aio --with-http_addition_module --with-http_auth_request_module --with-http_dav_module --with-http_dav_module --with-http_flv_module --with-http_geoip_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_mp4_module --with-http_random_index_module --with-http_realip_module --with-http_secure_link_module --with-http_slice_module --with-http_ssl_module --with-http_stub_status_module --with-http_sub_module --with-http_v2_module --with-mail --with-mail_ssl_module --with-stream --with-stream_realip_module --with-stream_ssl_module --with-stream_ssl_preread_module --with-threads |
Options to pass to nginx's ./configure script. |
BUILD_DEPS |
Differs based on the distro | List of needed packages to build properly the software. |
NGINX_BUILD_DEPS |
Differs based on the distro | List of needed packages to build properly nginx. |
PKG_DEPS |
Differs based on the distro | List of needed packages to run properly the software. |
These built-from-source flavors include the following modules by default, but one can easily increase or decrease that with the custom build options above:
- file-aio
- threads
- http_addition_module
- http_auth_request_module
- http_dav_module
- http_flv_module
- http_gunzip_module
- http_gzip_static_module
- http_mp4_module
- http_random_index_module
- http_realip_module
- http_secure_link_module
- http_slice_module
- http_ssl_module
- http_stub_status_module
- http_sub_module
- http_v2_module
- mail_ssl_module
- stream
- stream_realip_module
- stream_ssl_module
- stream_ssl_preread_module
- The
SIGQUIT
signal will be sent to nginx to stop this container, to give it an opportunity to stop gracefully (i.e, finish processing active connections). The Docker default isSIGTERM
, which immediately terminates active connections. Note that if your configuration listens on UNIX domain sockets, this means that you'll need to manually remove the socket file upon shutdown, due to nginx bug #753.
$ docker run -it --rm -p 80:80 \
--health-cmd='curl --fail http://example.com || exit 1' \
--health-interval=30s \
--health-timeout=3s \
fabiocicerchia/nginx-lua:latest
The default Nginx + Lua + extra lua modules image. Uses Alpine for base image.
Provides Nginx + Lua + extra lua modules. Uses Alpine, Amazon Linux, Debian, Fedora, Ubuntu for base image.
Provides Nginx + Lua + extra lua modules. Uses pinned version for Alpine, Amazon Linux, Debian, Fedora, Ubuntu for base image.
Provides Nginx + Lua image. Uses Alpine for base image.
WARNING: Not available as tag, need manual build, see Minimal Image
Provides Nginx + Lua. Uses Alpine, Amazon Linux, Debian, Fedora, Ubuntu for base image.
WARNING: Not available as tag, need manual build, see Minimal Image
Provides Nginx + Lua. Uses pinned version for Alpine, Amazon Linux, Debian, Fedora, Ubuntu for base image.
WARNING: Not available as tag, need manual build, see Minimal Image
The extended image (default one) contains a set of extra packages for enhanced functionality. If you need a smaller version, like the official distros (containing only nginx and openresty's lua module), you could build specifying the build argument set to 0:
$ docker build \
--build-arg EXTENDED=0 \
-f $DOCKERFILE .
If you need to extend the functionality of the existing image, you could build your own version using the following command. For the list of values do refer to the relative section.
$ docker build
--build-arg NGINX_BUILD_CONFIG=... \ # nginx build flags
--build-arg BUILD_DEPS=... \ # packages needed for building phase
--build-arg NGINX_BUILD_DEPS=... \ # packages needed for building phase by nginx
--build-arg PKG_DEPS=... \ # packages available in final image
-f $DOCKERFILE .
The image builds are labeled with various information. Here's an example of printing the labels using jq:
$ docker pull fabiocicerchia/nginx-lua:1-alpine
$ docker inspect fabiocicerchia/nginx-lua:1-alpine | jq '.[].Config.Labels'
{
"maintainer": "Fabio Cicerchia <[email protected]>",
"org.label-schema.build-date": "1970-01-01T00:00:00Z",
"org.label-schema.description": "Nginx 1.21.0 with Lua support based on alpine 3.14.0.",
"org.label-schema.docker.cmd": "docker run -p 80:80 -d fabiocicerchia/nginx-lua:1.21.0-alpine3.14.0",
"org.label-schema.name": "fabiocicerchia/nginx-lua",
"org.label-schema.schema-version": "1.0",
"org.label-schema.url": "https://github.com/fabiocicerchia/nginx-lua",
"org.label-schema.vcs-ref": "0585e8c",
"org.label-schema.vcs-url": "https://github.com/fabiocicerchia/nginx-lua",
"org.label-schema.version": "1.21.0-alpine3.14.0",
"versions.extended": "1",
"versions.headers-more-nginx-module": "d6d7ebab3c0c5b32ab421ba186783d3e5d2c6a17",
"versions.lua": "5.4",
"versions.lua-nginx-module": "0.10.20",
"versions.lua-resty-cookie": "303e32e512defced053a6484bc0745cf9dc0d39e",
"versions.lua-resty-core": "0.1.22",
"versions.lua-resty-dns": "0.22",
"versions.lua-resty-lrucache": "0.11",
"versions.lua-resty-memcached": "0.16",
"versions.lua-resty-mysql": "0.24",
"versions.lua-resty-redis": "0.29",
"versions.lua-resty-shell": "0.03",
"versions.lua-resty-upstream-healthcheck": "0.06",
"versions.lua-resty-websocket": "0.08",
"versions.lua-upstream": "0.07",
"versions.luajit2": "2.1-20210510",
"versions.luarocks": "3.7.0",
"versions.nginx": "1.21.0",
"versions.nginx-lua-prometheus": "0.20210206",
"versions.ngx_devel_kit": "0.3.1",
"versions.os": "3.14.0",
"versions.stream-lua-nginx-module": "0.0.10"
}
Label Name | Description |
---|---|
maintainer |
Maintainer of the image |
org.label-schema.build-date |
This label contains the Date/Time the image was built. The value SHOULD be formatted according to RFC 3339. buildarg BUILD_DATE |
org.label-schema.description |
Text description of the image. May contain up to 300 characters. |
org.label-schema.docker.cmd |
How to run a container based on the image under the Docker runtime. |
org.label-schema.name |
buildarg DOCKER_IMAGE |
org.label-schema.schema-version |
This label SHOULD be present to indicate the version of Label Schema in use. |
org.label-schema.url |
URL of website with more information about the product or service provided by the container. |
org.label-schema.vcs-ref |
buildarg VCS_REF |
org.label-schema.vcs-url |
URL for the source code under version control from which this container image was built. |
org.label-schema.version |
Release identifier for the contents of the image. |
versions.extended |
Flag to identify if extended image (which contains extra modules). |
versions.headers-more-nginx-module |
The version of headers-more-nginx-module used. |
versions.lua |
The version of Lua to use. |
versions.luarocks |
The version of LuaRocks to use. |
versions.lua-nginx-module |
The version of ngx_http_lua_module used. |
versions.lua-resty-cookie |
The version of lua-resty-cookie used. |
versions.lua-resty-core |
The version of lua-resty-core used. |
versions.lua-resty-dns |
The version of lua-resty-dns used. |
versions.lua-resty-lrucache |
The version of lua-resty-lrucache used. |
versions.lua-resty-memcached |
The version of lua-resty-memcached used. |
versions.lua-resty-mysql |
The version of lua-resty-mysql used. |
versions.lua-resty-redis |
The version of lua-resty-redis used. |
versions.lua-resty-shell |
The version of lua-resty-shell used. |
versions.lua-resty-upstream-healthcheck |
The version of lua-resty-upstream-healthcheck used. |
versions.lua-resty-websocket |
The version of lua-resty-websocket used. |
versions.lua-upstream |
The version of lua-upstream-nginx-module used. |
versions.luajit2 |
The version of LuaJIT used. |
versions.nginx |
The version of nginx used. |
versions.nginx-lua-prometheus |
The version of nginx-lua-prometheus used. |
versions.ngx_devel_kit |
The version of Nginx Development Kit used. |
versions.os |
The Docker base image. |
versions.stream-lua-nginx-module |
The version of stream-lua-nginx-module used. |
More details about the benchark can be found in docs/benchmarks/different_images.
More details about the benchark can be found in docs/benchmarks/distros.
Extract of openresty/lua-nginx-module under BSD license.
server {
server_name localhost;
location /lua_content {
default_type 'text/plain';
content_by_lua_block {
ngx.say('Hello world!')
}
}
}
version: '3.7'
services:
nginx-lua:
image: fabiocicerchia/nginx-lua:latest
restart: always
ports:
- "80:80"
- "443:443"
volumes:
- /path/to/docroot:/var/www/html
- ./nginx.conf:/etc/nginx/nginx.conf:ro
healthcheck:
test: ['CMD', 'curl --fail http://localhost/ || exit 1']
interval: 30s
timeout: 3s
retries: 3
More examples are available in the directory docs/examples
As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).
As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.
MIT License
Copyright (c) 2020 Fabio Cicerchia [email protected]
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.