Page Discussion History



Third party modules

These modules are not officially supported and may not be compatible across versions of Nginx. Nevertheless many of them may prove useful to many people. Enjoy at your own risk.

Compiling third party modules

Modules are typically added by compiling them along with the Nginx source.

From the Nginx source directory, type:

./configure --add-module=/path/to/module1/source \

You can use as many --add-module arguments as needed.

Be aware that some modules may require additional libraries to be installed on your system.

Writing your own module

Evan Miller has written the definitive guide to Nginx module development. But some parts of it are a little out of date. You've been warned.

A github search turned up the Nginx Development Kit. It seems to be more up to date.

See also the tools at the bottom of this page.

Known modules

Name Description Author Link
Accept Language Parses the Accept-Language header and gives the most suitable locale from a list of supported locales. Guillaume Maury Download
Access Key Denies access unless the request URL contains an access key. Mykola Grechukh Download
Access Plus Allows limiting access to certain http request methods and client addresses. xfeep Download
AFCGI Asynchronous/multiplexing FastCGI for nginx (incl. ref server implementation) rsms Download
Akamai G2O Restricts access to content to Akamai edge servers using G2O headers refractalize Download
Array Var Add support for array variables to nginx config files agentzh Download
Audio Track for HLS Generate audio track for HTTP Live Streaming (HLS) streams on the fly. flavioribeiro Download
Auth Digest HTTP Digest Authentication. Christian Swinehart Download
Auth PAM HTTP Basic Authentication using PAM. Sergio Talens-Oliag Download
Auth Request Allows authorization based on subrequest result. Maxim Dounin Download
Auto Lib Reuse pre-compiled/installed versions of OpenSSL, PCRE and Zlib without re-compiling them each time Nginx is compiled Marcus Clyne Download
AWS auth Generate security headers for GET requests to Amazon S3. Arvind Jayaprakash Download
Backtrace A nginx module to dump backtrace case a worker process exits abnormally. Tengine Download
Cache Purge Module adding ability to purge content from FastCGI, proxy, and uWSGI caches. FRiCKLE Download
Chunkin HTTP 1.1 chunked-encoding request body support for Nginx. agentzh Download
Clojure A module for embedding Clojure or Java or Groovy programs, typically those Ring based handlers. xfeep Download
Concat This module can concatenate files in a given context: CSS and JS files usually Tengine Download
Circle GIF Generates simple circle images with the colors and size specified in the URL. Evan Miller Download
CT++ Embeds CT++ (or CTPP2) VM, the execution part of a high-performance template engine system. Valentin V. Bartenev Download
Development Kit An extension to the core functionality of Nginx which can be used as a basis for other modules Marcus Clyne Download
Drizzle Make nginx talk directly to mysql and drizzle by libdrizzle. chaoslawful, agentzh, Piotr Sikora Download
Dynamic etags Nginx module for etags on dynamic content kali Download
Echo Brings "echo", "sleep", "time", "exec", and more shell-style goodies to Nginx config file. agentzh Download
Enhanced Memcached Repackaging of the standard memcached module to add features : custom http headers, hash keys, store entries in memcached with post http request, flush, key namespace, send 304 when no modification Bertrand Paquet Download
Encrypted Session encrypt and decrypt nginx variable values, can be used for light-weight session-based authentication agentzh Download
Eval A module for evaluating memcached or proxy response into variable. vkholodkov Download
Eval (agentzh's fork) Enhanced ngx_eval that can capture arbitrary subrequest's responses into nginx variables (can even with output filters enabled) agentzh Download
Expressz First of the Expressz lineup modules, Off-loading image and file/stream compression to (a) GPU(s). Jason Giedymin at AcronymLabs
Extended status module Extended status module for nginx 최영석(Choi Youngseok), 李金虎(Li Jinhu) Download
EY Balancer Adds a request queue to Nginx that allows the limiting of concurrent requests passed to the upstream. Ry Dahl Download
Fancy Indexes Like the built-in autoindex module, but fancier. Adrian Perez de Castro Download
Form Input This module reads HTTP POST request body and parse the arguments into nginx variables. Calio, agentzh Download
Foot filter This module implements a body filter that adds a given string to the page footer. Tengine Download
Footer If Filter A nginx module to add given content to the end of the response according to the condition specified. Flygoast Download
GeoIP Country code lookups via the MaxMind GeoIP API. SPIL GAMES File:Nginx-geoip-0.2.tar.gz
GeoIP2 City and country code lookups via the MaxMind GeoIP2 API. Lee Valentine Download
GridFS Nginx module for serving files from MongoDB's GridFS. mdirolf Download
Groovy A module for embedding Clojure or Java or Groovy programs, typically those Ring based handlers. xfeep Download
Headers More Set and clear input and output headers...more than "add"! agentzh Download
HTTP Healthcheck Health check HTTP servers inside an upstream so you don't forward requests to bad hosts Jack Lindamood
HTTP Accounting Realtime netflow and status code monitor solution for nginx, need less memory and cpu than realtime log analyzing. Useful for http traffic accounting based on nginx config logic ( per-location-traffic or per-server-traffic ). Liu Lantao Download
HTTP Push Turn Nginx into an adept long-polling HTTP Push (Comet) server. Leo Ponomarev Download
HTTP Push Stream Turn Nginx into an adept stream HTTP Push (Comet) server. Wandenberg Peixoto Download
HTTP rDNS Makes a reverse DNS (rDNS) lookup for incoming connection and provides simple access control of incoming hostname. Timofey Kirillov Download
HTTP Redis Redis support. Sergey A. Osokin <osa@FreeBSD.ORG.ru> Download
JavaScript Embedding SpiderMonkey. Full port of Perl module and more. Peter Leonov Download
Iconv A character encoding conversion nginx module using libiconv. Calio, agentzh Download
Internal Redirect A nginx module to make an internal redirect to the uri specified according to the condition specified. Flygoast Download
IP2Location Enables the user to identify the country code and country name by IP address using IP2Location database. IP2Location Download
Java A module for embedding Clojure or Java or Groovy programs, typically those Ring based handlers. xfeep Download
Limit Upstream Connection Limit the maximum of connections to each server in a upstream, the outnumbered connections will be delayed or dropped. cfsego Download
Limit Upload Rate Limit the transmission rate of request body from a client cfsego Download
Log If Log the requests only when given conditions are met cfsego Download
Lower Upper Case Simple module to upper-/lowercase a string in the Nginx config Mauro Stettler Download
Lua Embed the power of Lua into nginx chaoslawful, agentzh Download
Luafile Embed the power of Lua into nginx very easy. alacner Download
MD5 Filter Simple output filter to return the MD5 sum of the content that would've otherwise been served Keith Ainsworth Download
Memc An extended version of the standard memcached module that supports set, add, delete, and many more memcached commands. agentzh Download
ModSecurity Web application firewall. Alan Silva, Trustwave
Mogilefs Implements a MogileFS client, provides a replace to the Perlbal reverse proxy of the original MogileFS. Valery Kholodkov Download
Mongo Upstream module that allows nginx to communicate directly with MongoDB database. FRiCKLE & Simpl.it Download
MP4 Streaming Lite Will seek to a certain time within H.264/MP4 files when provided with a "start" parameter in the URL. Jiang Hong Download
Naxsi Web Application Firewall for nginx. Thibault Koechlin Download
Notice Serve static file to POST requests. Keith Rarick Download
OCSP proxy Nginx OCSP processing module designed for response caching. kyprizel Download
OpenSSL Version OpenSSL minimum version constraints in configuration Apcera Download
OwnerMatch This module provides a simple file owner-based access control. Heiher Download
PageSpeed This module rewrites web pages and associated assets to reduce latency and bandwidth: image optimization, asset minification and compression, HTML rewriting for better visual rendering performance, cache extension, and more. Google Download
PHP-Memache Standard Hash This is a loadbalancer that imitates the PHP-Memcache standard hash's behaviour Mauro Stettler Download
PHP Session Parser Extract values that are stored in a serialized PHP session Mauro Stettler Download
Postgres Upstream module that allows nginx to communicate directly with PostgreSQL database. FRiCKLE Download
Pubcookie Adds Pubcookie-based cross-site authentication method to Nginx. Vitki Download
RDS CSV Help ngx_drizzle, ngx_postgres, and others emit Comma-Separated Values (CSV). agentzh Download
RDS JSON Help ngx_drizzle, ngx_postgres, and others emit JSON data. agentzh Download
Redis2 Upstream module for the full Redis 2.0 protocol agentzh Download
Replace Filter Output filter module for doing streaming regular expression substitutions in response bodies (ngx_replace_filter) agentzh Download
Roboo HTTP Robot mitigator utilizing advanced non-interactive HTTP challenge/response mechanisms Yuri Gushin, Alex Behar Download
RRD Graph This module provides an HTTP interface to RRDtool's graphing facilities. Evan Miller Download
RTMP RTMP protocol support. Live streaming and video on demand. Roman Arutyunyan Download
Sass Compiles sass files in nginx before sending the response. Marc Neudert Download
Secure Download Create expiring links. Mauro Stettler, Szymon Modzelewski Download
Selective Cache Purge Module similar to Cache Purge from FRiCKLE, and based on it, to allow purge cache using GLOB expressions like *.jpg or /test* using Redis as a cache keys database. Wandenberg Peixoto Download
Set CConv Conversion between Simplified Chinese and Traditional Chinese at rewrite phase Liseen Wan Download
Set Hash Set a variable to a variety of hash functions (upper/lowercase), including MD5, SHA1 and Murmurhash 2 Marcus Clyne Download
Set Lang Set a variable to indicate the language based on a variety of sources including cookies, GET/POST variables, Accept Language header and more Marcus Clyne Download
Set Misc Various set_xxx directives added to nginx's rewrite module (md5/sha1, sql/json quoting, and many more) agentzh, Calio, shrimp Download
sFlow Operational performance monitoring with standard sFlow protocol Neil McKee Download
Slice Nginx module for serving a file in slices (reverse byte-range). Tengine Download
SlowFS Cache Module adding ability to cache static files. FRiCKLE Download
SmallLight Dynamic Image Transformation Module For nginx cubicdaiya Download
Sphinx Nginx upstream module for Sphinx 2.x Reetesh Ranjan Download
SPNEGO Support for SPNEGO/gssapi in nginx. stnoonan/mike503/muhgatus Download
SR Cache Transparent subrequest-based caching layout for arbitrary nginx locations (can be used with ngx_memc + memcached!) agentzh Download
Static etags Nginx doesn't generate etags for static content. I'd like it to. Let's see if I can remember some C from college. mikewest Download
Statsd Adds the ability for Nginx to interacting with statsd. zebrafishlabs Download
Sticky upstream A nginx module to add an upstream server persistance using cookies, extended version w/ httponly/secure - cookies Jérôme Loyet et al Download
Strip Whitespace remover. Evan Miller File:Mod strip-0.1.tar.gz
Substitutions A filter module which can do both regular expression and fixed string substitutions on response bodies. Weibin Yao Download
Summarizer Nginx upstream module for Summarizer 1.0, the text summary service using a highly efficient version of popular open-text-summarizer (or OTS) Reetesh Ranjan Download
Supervisord Module providing nginx with API to communicate with supervisord and manage (start/stop) backends on-demand. FRiCKLE Download
SysGuard A module to protect servers when system load or memory use goes too high. Tengine Download
Subrange Split one big HTTP/Range request to multiple subrange requesets. Qihoo360, renenglish Download
TCP Proxy A module to protect servers when system load or memory use goes too high. Weibin Yao Download
TestCookie module Simple robot (DDoS) mitigation module using cookie based challenge/response technique. kyprizel Download
Types Filter A filter module which change the `Content-Type` output header depending on an extension variable according to a optional condition specified in the 'if' clause. Flygoast Download
UnZip serve file directly from the archives (unzip on the fly). Bartek Jarocki Download
Upload Adds support for TCP proxying. Valery Kholodkov Download
Upload Progress Tracks and reports upload progress. Brice Figureau Download
Upstream Consistent Hash Select backend based on Consistent hash ring. Mauro Stettler Download
Upstream Domain Resolve An asynchronous domain name resolve module for nginx upstream. wdaike Download
Upstream Fair Balancer Sends an incoming request to the least-busy backend server, rather than distributing requests round-robin. Gregory Nosek Download
Upstream Hash Provides simple upstream load distribution by hashing a configurable variable. Evan Miller Download
Upstream Ketama CHash Provides upstream load distribution by hashing a configurable variable using ketama consistent hashing algorithm. Flygoast Download
Upstream Keepalive Provides keep-alive connections to memcached upstreams. Maxim Dounin Download
Dynamic Upstream Update upstreams' config by restful interface. yzprofile Download
Url A module to convert uri to user defined encoding before accessing a file of the uri.(similar to apache's mod_url) vozlt Download
User Agent A more powerful module than the native BrowserModule Tengine Download
Video Thumb Extractor Nginx module to extract thumbs from a video file. Wandenberg Peixoto Download
VTS A virtual host and upstream traffic status module vozlt Download
WSGI WSGI implementation for Nginx. Allows easy deployment of Python applications. Manlio Perillo Download
XSS Native support for cross-site scripting (XSS) in an nginx. agentzh Download
Zip Assemble ZIP archives on the fly. Evan Miller Download

Tools for module developers

Name Description Author Link
Nginx Auto Lib Core Reusable file for module developers to include with their modules to easily and consistently handle including external libraries; used in the Auto Lib module and included in the Nginx Development Kit Marcus Clyne Download
Nginx Development Kit An extension to the core functionality of Nginx which can be used as a basis for other modules Marcus Clyne Download
Nginx Sync Messages API This module provides a mechanism to sync messages between workers for other modules. yzprofile Download

Third party patches

These patches must be applied to the Nginx source code tree. There's no guarantee these patches will apply to a particular version of Nginx.

As with third party modules, these patches are not officially supported. Your mileage may vary.

Description Author Link
Log to syslog. Marlon de Boer Patch for version 0.8.49 with 'sh is not bash' fix | Syslog Patch for Nginx 0.8.54+
Disable nginx's memory pool to help valgrind and other tools (for nginx C developers only) shrimp, agentzh Git repository for the patch
SSL Session tickets distributed via memcached Matthew Palmer Git repository for changes
output client certificate expiration time SunGod File:Nginx-0.7.67.ssl cert date.patch.txt
Support for BCrypt hashes in auth_basic_user_file z38 Patch for version 1.3.14

Tools for Migration

Name Description Author Link
Apache2Nginx A command line tool, which can be used to generate nginx config file according to given config files of Apache 李德(Reed), 李金虎(Li Jinhu), 최영석(Choi Youngseok) Download