awesome-resty

awesome-resty is a list of OpenResty / Nginx modules, Lua libraries, and related resources.

Official Channels

Web Site: http://openresty.org/
Mailing List: https://groups.google.com/forum/#!forum/openresty-en
Github Organization: https://github.com/openresty
Lead Developer: @agentzh

How to Contribute on this List?

Create a New Issue where you describe the needed additions, deletions or changes.
Fork this repository and make the changes, and create a pull request.
Post a reply in the awesome-resty thread in openresty-en mailing list.

Modules
Libraries
Books and Tutorials
- Tutorials and Guides
See Also

Modules

Core Modules

Core modules come bundled in OpenResty package.

ngx_openresty — Turning Nginx into a full-fledged Web App Server - Sources for OpenResty Bundle Generation
lua-nginx-module — Embed the power of Lua into Nginx
echo-nginx-module — An Nginx module for bringing the power of "echo", "sleep", "time" and more to Nginx's config file
xss-nginx-module — Native support for cross-site scripting (XSS) in an nginx
set-misc-nginx-module — Various set_xxx directives added to nginx's rewrite module (md5/sha1, sql/json quoting, and many more)
encrypted-session-nginx-module — Encrypt and decrypt Nginx variable values
srcache-nginx-module — Transparent subrequest-based caching layout for arbitrary nginx locations
lua-upstream-nginx-module — Nginx C module to expose Lua API to ngx_lua for Nginx upstreams
headers-more-nginx-module — Set and clear input and output headers...more than "add"!
array-var-nginx-module — Add support for array variables to nginx config files
memc-nginx-module — An extended version of the standard memcached module that supports set, add, delete, and many more memcached commands
redis2-nginx-module — Nginx upstream module for the Redis 2.0 protocol
rds-json-nginx-module — An nginx output filter that formats Resty DBD Streams generated by ngx_drizzle and others to JSON
rds-csv-nginx-module — Nginx output filter module to convert Resty-DBD-Streams (RDS) to Comma-Separated Values (CSV)
drizzle-nginx-module — An Nginx upstream module that talks to mysql and drizzle by libdrizzle
ngx_postgres — Upstream module that allows Nginx to communicate directly with PostgreSQL database
form-input-nginx-module — This is a nginx module that reads HTTP POST and PUT request body encoded in "application/x-www-form-urlencoded", and parse the arguments in request body into nginx variables.
ngx_coolkit — Collection of small and useful nginx add-ons

Please also note that there is resty command line client included in OpenResty bundle. The command line client sources can be found on Github.

Core Nginx Modules

Please refer Nginx Documentation about the Core Nginx Modules.

Third-party Nginx Modules

ngx_pagespeed (Github) — Automatic PageSpeed optimization module for Nginx
ModSecurity — Open Source Web Application Firewall
NAXSI — NAXSI is an open-source, high performance, low rules maintenance WAF for NGINX; NAXSI means Nginx Anti Xss & Sql Injection

Libraries

Core Libraries

Core Libraries are bundled in OpenResty package, and you don't need to separately install them.

lua-resty-core - New FFI-based Lua API for the ngx_lua module
lua-resty-upstream-healthcheck — Health Checker for Nginx Upstream Servers in Pure Lua
lua-resty-string — String utilities and common hash functions for ngx_lua and LuaJIT
lua-resty-lock — Simple nonblocking lock API for ngx_lua based on shared memory dictionaries
lua-resty-lrucache — Lua-land LRU Cache based on LuaJIT FFI
lua-resty-dns — DNS resolver for the Nginx Lua module
lua-resty-upload — Streaming reader and parser for HTTP file uploading based on ngx_lua cosocket
lua-resty-websocket — Lua WebSocket implementation for the ngx_lua module
lua-resty-mysql — Non-blocking Lua MySQL client driver for ngx_lua based on the cosocket API
lua-resty-memcached — Lua memcached client driver for the ngx_lua based on the cosocket API
lua-resty-redis — Lua Redis client driver for the ngx_lua based on the cosocket API
lua-redis-parser — Redis reply parser and request constructor library for Lua
lua-rds-parser — Resty-DBD-Stream (RDS) parser for Lua written in C
lua-cjson — Lua cJSON is a fast JSON encoding / parsing module for Lua

Web Frameworks

Lapis — Lapis is a framework for building web applications using MoonScript or Lua that runs inside of a customized version of Nginx called OpenResty
Lusty — Lua RESTful Web Application Framework, an extensible and speedy web framework
Sailor — A Lua MVC Web Framework
lua-resty-rack — A simple and extensible HTTP server framework for OpenResty
MOOCHINE — A simple and lightweight web framework based on OpenResty
sinatra-openresty — Sinatra ported to OpenResty framework
lj-web — Lightweight Web Framework Based On ngx_openresty
Gimlet Cocktail — A micro web application framework for OpenResty written in Moonscript inspired by Martini & Sinatra
Ziggy Stardust — Ziggy Stardust (or just "stardust") is a simple nginx/Lua framework inspired by Sinatra, Express, and Mercury
zLua — A Codeigniter like Lua framework based on OpenResty
lua-resty-stack — OpenResty Simple Application Stack
dodolu — A lightweight web framework based on OpenResty

Web Development Essentials

lua-resty-cookie — Lua library for HTTP cookie manipulations for OpenResty/ngx_lua
lua-resty-session — Session library for OpenResty implementing Secure Cookie Protocol
lua-resty-woothee — The Lua-Openresty implementation of Project Woothee, which is multi-language user-agent strings parsers
router.lua — A barebones router for Lua, it matches urls and executes lua functions

Templating

lua-resty-template — A Compiling (HTML) templating engine for Lua and OpenResty
etlua — Embedded Lua templates

Cryptography

lua-resty-string — String utilities and common hash functions for ngx_lua and LuaJIT
lua-resty-nettle — LuaJIT FFI bindings for Nettle (a low-level cryptographic library)
lua-resty-murmurhash2 — LuaJIT MurmurHash 2 bindings to Nginx / OpenResty murmurhash2 implementation
lua-resty-hmac — Lua driver for making and receiving hmac signed requests
lua-resty-scrypt — LuaJIT FFI-based scrypt library for OpenResty

Networking

lua-resty-http by @pintsized — Lua HTTP client cosocket driver for OpenResty / ngx_lua
lua-resty-http by @liseen — Lua http client driver for the ngx_lua based on the cosocket API
lua-resty-http by @DorianGray — Lua HTTP client driver for ngx_lua based on the cosocket API
lua-resty-http-simple — Simple Lua HTTP client driver for ngx_lua
lua-resty-httpipe — Lua HTTP client cosocket driver for OpenResty / ngx_lua
lua-resty-httpclient — Nonblocking Lua HTTP Client library for aLiLua & ngx_lua
lua-httpcli-resty — Lua HTTP client module for OpenResty
lua-resty-websocket — Lua WebSocket implementation for the ngx_lua module
lua-resty-iputils — Utility functions for working with IP addresses in OpenResty
lua-resty-readurl — Lua library for capturing urls, decoding, and logging results

Databases and Storages

lua-resty-mysql — Non-blocking Lua MySQL client driver for ngx_lua based on the cosocket API
lua-resty-postgres — Nonblocking Lua PostgreSQL driver library for ngx_lua
pgmoon — A pure Lua Postgres driver for use in OpenResy & more
lua-resty-memcached — Lua memcached client driver for the ngx_lua based on the cosocket API
lua-resty-redis — Lua Redis client driver for the ngx_lua based on the cosocket API
lua-resty-cassandra — Pure Lua Cassandra client using CQL binary protocol
lua-resty-riak — Lua riak protocol buffer client driver for the ngx_lua based on the cosocket API
lua-resty-mongol — Native Lua Mongodb driver which supports both luasocket and ngx_lua based on the cosocket API
lua-resty-mongo — Lua mongodb client driver for the ngx_lua based on the cosocket API
lua-resty-kyototycoon — Lua client driver for KyotoTycoon using its native wire protocol (OpenResty/ngx_lua)
lua-nginx-tarantool — A driver for a NoSQL database in a Lua script Tarantool build on fast nginx cosockets
lua-resty-ssdb — Lua ssdb client driver for the ngx_lua based on the cosocket API, SSDB is a leveldb server
ledis-openresty — Lua LedisDB client driver for the ngx_lua based on the cosocket API
lua-resty-fastdfs — Nonblocking Lua FastDFS driver library for ngx_lua
openresty-statsd — A Lua module for OpenResty to send metrics to StatsD

Message Queuing and Task Management

lua-resty-qless — Lua binding to Qless (Queue / Pipeline management) for OpenResty
lua-resty-rabbitmqstomp — Lua RabbitMQ client library which uses cosocket api for communication over STOMP 1.2 with a RabbitMQ broker which has the STOMP plugin
lua-resty-gearman — Lua gearman client driver for the ngx_lua based on the cosocket API
lua-resty-kafka — Lua kafka client driver for the ngx_lua based on the cosocket API
lua-resty-beanstalkd — Lua beanstalkd client driver for the ngx_lua based on the cosocket API
lua-resty-ironmq — Simple IronMQ client for OpenResty

Utilities

lua-resty-fileinfo — LuaJIT FFI bindings to libmagic, magic number recognition library - tries to determine file types
lua-resty-taglib - LuaJIT FFI bindings for TagLib - An Audio Meta-Data Library
lua-resty-uuid — LuaJIT FFI bindings for libuuid, a DCE compatible Universally Unique Identifier library

Date and Time

These libraries are not build to using lua-nginx-modules date time functions (except luatz) like ngx.today, ngx.time, ngx.now, ngx.localtime, or ngx.utctime, but they may still come handy. At some point we may need a more "official" time library for OpenResty.

luatz — A Lua library for time and date manipulation (has a fallback to ngx.now)
LuaDate — Lua Date and Time module for Lua 5.x
SciLua Time Library — Library for the manipulation of dates and periods according to the Gregorian calendar, i.e. the internationally accepted calendar for most uses

Compression

lua-resty-snappy — LuaJIT FFI bindings for Snappy, a fast compressor/decompressor

Text Formats

lua-resty-hoedown — LuaJIT FFI bindings to Hoedown, a standards compliant, fast, secure markdown processing library in C
lua-gumbo — Lua bindings for the Gumbo HTML5 parsing library, with a set of DOM APIs implemented in pure Lua

Document Formats

lua-resty-libxl — LuaJIT FFI-based LibXL (Excel) library for OpenResty
lua-resty-hpdf — LuaJIT FFI-based libHaru (PDF) library for OpenResty

Localization

lua-resty-gettext — LuaJIT FFI-based gettext library for OpenResty

Caching

lua-resty-lrucache — Lua-land LRU Cache based on LuaJIT FFI
Ledge — A Lua application for OpenResty, providing HTTP cache functionality for Nginx, using Redis as a cache / metadata store

Metrics and Statistics

LUAMETER — A Lua module for Nginx that records and provides key status and performance metrics, right from within Nginx and in real-time (Proprietary)
ngxtop — Real-Time metrics for nginx server

Logging

lua-resty-logger-socket — Raw-socket-based Logger Library for Nginx (based on ngx_lua)
lua-nginx-logging — Logging utilities for Nginx written in Lua
lua-resty-logger — Custom Logger Library for OpenResty

Web APIs

lua-resty-github — Lua library for using the github api in the ngx_lua nginx module
lua-resty-hipchat — Lua library for using the hipchat api
lua-resty-aws — AWS signature V4 library for OpenResty + Lua
lua-resty-s3 — Lua driver for uploading content to Amazon S3
lua-resty-paypal — Lua Paypal client using express checkout for OpenResty
lua-resty-17monip — 17MonIP parsing library for ngx_lua

Other Sources for Libraries

Books and Tutorials

Tutorials and Guides

agentzh's Nginx Tutorials
The Latest and Greatest from ngx_lua: New Features & Tools (Summary, Slides, PDF, Video)
Nginx Configuration Snippets — A collection of useful Nginx configuration snippets

level077 / awesome-resty