honeok/nginx repository overview

⁠nginx

nginx ("engine x") is an HTTP web server, reverse proxy, content cache, load balancer, TCP/UDP proxy server, and mail proxy server. Originally written by Igor Sysoev⁠ and distributed under the 2-clause BSD License⁠.

⁠Introduction

• Built from source based on the Alpine build configuration from the official NGINX packaging sources.
• All images are built exclusively on Alpine Linux; no other base distributions are provided.
• Keeps the final image small by removing build dependencies and unnecessary files after compilation.
• Keeps the filesystem layout and configuration paths aligned with the official NGINX Alpine image.
• Includes Brotli, Zstandard, and Headers More as built-in modules, along with other commonly used third-party functionality as dynamically loadable modules.

⁠Quick Start

docker run -d --name nginx -p 80:80 honeok/nginx:alpine

⁠Dynamic modules

Bundled dynamic modules are installed in /usr/lib/nginx/modules, with /etc/nginx/modules linked to the same location, following the layout of the official NGINX Alpine image.

To enable a bundled dynamic module, edit the NGINX configuration file:

vim /etc/nginx/nginx.conf

load_module modules/<module>.so;

For configuration details, see the official documentation⁠.

⁠Acknowledgements

Thanks to the NGINX team and the maintainers of the third-party modules included in this image.

This is an independent, unofficial build and is not affiliated with or endorsed by F5, Inc.⁠ or the NGINX project.

NGINX® is a registered trademark of F5, Inc.⁠.