nginx-docs
Installation
SKILL.md
NGINX
Version: Latest (1.29.x) | Source: nginx.org/en/docs
Overview
NGINX is a high-performance HTTP web server, reverse proxy, IMAP/POP3 mail proxy, and TCP/UDP load balancer. It uses an event-driven, asynchronous architecture with a master-worker process model, delivering high concurrency with low memory footprint. NGINX powers a significant portion of the web as a front-end proxy, load balancer, and content delivery server.
Quick Reference
| Topic | File | Key Content |
|---|---|---|
| Getting Started | getting-started.md |
What is NGINX, architecture (master-worker, event-driven), installation (Linux, FreeBSD, Windows, building from sources, Win32 Visual C build), beginner's guide (configuration structure, directives, contexts, serving static content, proxy, FastCGI), how NGINX processes a request, server names (exact, wildcard, regex, IDN), controlling NGINX (signals, binary upgrade), command-line parameters, connection processing methods (epoll, kqueue, select, poll), configuration units, debugging (debug log, DTrace), setting up hashes, njs scripting, contributing |
| HTTP Modules | http-modules.md |
Core module (server, listen, location matching, root, alias, try_files, error_page, client handling, file processing, WebSocket proxying), proxy module (proxy_pass, headers, buffering, caching, timeouts, SSL), upstream module (round robin, least_conn, ip_hash, hash, random, server parameters, keepalive, health checks, state, zone), rewrite module (rewrite, return, if, set), FastCGI module, access control, auth basic, auth request, auth JWT, auth require, gzip, headers, limit conn, limit req, logging, map, num map, geo, geoip, real IP, referer, SSI, sub filter, browser, charset, slice, split clients, mirror, secure link, addition, autoindex, DAV, image filter, XSLT, Perl, JavaScript, user ID, HTTP/2, HTTP/3, API, keyval, OIDC, gRPC, SCGI, uWSGI, memcached, gunzip, gzip static, stub status, status, session log, ACME, OpenTelemetry, empty GIF, F4F, FLV, HLS, MP4, random index, internal redirect, tunnel, upstream conf, proxy protocol vendor, management |
| Stream & Mail Modules | stream-mail-modules.md |
Stream core (TCP/UDP proxy, listen, proxy_pass, preread, resolver), stream proxy (all proxy directives, UDP, rate limiting), stream upstream (load balancing methods, health checks), stream SSL, stream SSL preread (SNI without termination), stream access, geo, geoip, map, num map, limit conn, log, return, set, pass, split clients, JS, keyval, upstream HC, zone sync, MQTT preread/filter, proxy protocol vendor, real IP; Mail core (IMAP/POP3/SMTP proxy, protocol auto-detection), mail auth HTTP (authentication delegation, headers, response), mail proxy, mail SSL, mail real IP, mail IMAP/POP3/SMTP modules |
| Advanced Topics | advanced.md |
SSL/TLS (HTTPS setup, all ssl_ directives, certificate chains, SNI, OCSP stapling, client verification, SSL variables), HTTP/2 (enabling, directives, server push), HTTP/3 and QUIC (enabling, directives, building, 0-RTT, troubleshooting), load balancing (all methods, weighted, health checks, session persistence, dynamic reconfiguration), reverse proxy patterns, security (rate limiting, connection limiting, access control, auth, DDoS protection, security headers), performance tuning (workers, sendfile, keepalive, compression, caching, open file cache, thread pools, buffers), logging (access log formats, error log, log rotation), variables reference (core HTTP, upstream), converting rewrite rules from Apache, full configuration example |