├── LICENSE └── README.md /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2021 Su Yang 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # NJS Learning Materials 2 | 3 | List some learning materials to help you step into the world of njs. Thanks to these open source authors and engineer of Nginx/F5, inc. 4 | 5 | ## Docs / Repo 6 | 7 | - [nginx.org/en/docs/njs/](https://nginx.org/en/docs/njs/) An official nginx docs for njs. 8 | - [github.com/nginx/njs](https://github.com/nginx/njs) An official read-only mirror of `http://hg.nginx.org/njs/` which is updated hourly. 9 | 10 | ## Example 11 | 12 | - [xeioex/njs-examples](https://github.com/xeioex/njs-examples) Maintained by nginx,inc engineer [@Dmitry Volyntsev](https://github.com/xeioex), contains examples from official documentation. Project started at [24 Sep 2018](https://github.com/xeioex/njs-examples/commit/be03b8245fc5e6e6e8bdfabd50e1d733a87c23e2). 13 | - [zongzw-nginx/nginx-njs-usecases](https://github.com/zongzw-nginx/nginx-njs-usecases) Maintained by F5,inc engineer [@zongzw](https://github.com/zongzw), use `docker` and `docker-compose` to demonstrate some usage scenarios of njs.Project started at [Mar 9, 2020](https://github.com/zongzw-nginx/nginx-njs-usecases/commits/master/LICENSE). 14 | - [nginxinc/nginx-s3-gateway](https://github.com/nginxinc/nginx-s3-gateway) Maintained by nginx,inc engineer [@Elijah Zupancic](https://github.com/dekobon), illustrates setting up a S3 Gateway using njs and creating njs unit tests. 15 | 16 | ## Project 17 | 18 | - [Nginx RSA Encryption](https://github.com/soulteary/nginx-rsa-encryption) by [@soulteary](https://github.com/soulteary) 19 | - [Nginx DNS](https://github.com/TuxInvader/nginx-dns) by [@TuxInvader](https://github.com/TuxInvader) 20 | - [Nginx DDNS](https://github.com/soulteary/njs-ddns-service) by [@soulteary](https://github.com/soulteary) 21 | - [LDAP Auth](https://github.com/floffel/nla) by [@floffel](https://github.com/floffel) 22 | - [S3 Proxy](https://github.com/dedok/nginx-s3) by [@Vasiliy Soshnikov](https://github.com/dedok) 23 | - [JWT](https://github.com/lombax85/nginx-jwt) by [@lombax85](https://github.com/lombax85) 24 | - [Mod Security](https://github.com/sreinfrasystemjp/docker-nginx-modsecurity) by [@ihironao](https://github.com/ihironao) 25 | - [OAuth/OIDC Proxy](https://github.com/kaz/nginx-njs-oidc-proxy) by [@kaz](https://github.com/kaz) 26 | - [NJS TypeScript Definition](https://github.com/patricknelson/nginx-njs-typescript) by [@Patrick Nelson](https://github.com/patricknelson) 27 | - [MQTT Client Auth](https://github.com/casandberg/NGINX-mqtt-client-auth-with-SSL) by [@Chris Sandberg](https://github.com/casandberg) 28 | - [Nginx/NJS Binares](https://github.com/jirutka/nginx-binaries) by [@Jakub Jirutka](https://github.com/jirutka) 29 | - [Docker v2 Registry](https://github.com/psvmcc/static_docker_v2_registry) by [@Skitsanos](https://github.com/skitsanos) 30 | - [Babel Preset](https://github.com/jirutka/babel-preset-njs) by [@Jakub Jirutka](https://github.com/jirutka) 31 | - [OpenResty with NJS](https://github.com/skitsanos/openresty-njs) by [@Skitsanos](https://github.com/skitsanos) 32 | - [UML Diagram Renderer](https://github.com/soulteary/docker-nomnoml) 33 | - Docker Nomnoml is a simple but elegant self-hosted UML Generator & UML Sharing solution. This Project use NJS to provide server-side generation function. 34 | - NJS compatible: 0.5.0+ 35 | - [JSONRPC gateway](https://github.com/sah4ez/nginx-rpc-gateway) by [@sah4ez](https://github.com/sah4ez) 36 | 37 | ## Docker Image 38 | 39 | - [nginxinc/docker-nginx](https://github.com/nginxinc/docker-nginx) An official nginx docker images, contains njs executable files. 40 | - Registry: https://hub.docker.com/_/nginx 41 | - [soulteary/docker-njs](https://github.com/soulteary/docker-njs) Maintained by soulteary, minimal image containing only njs executable files for development and debugging. 42 | - Registry: https://hub.docker.com/r/soulteary/docker-njs 43 | - HowTo: https://soulteary.com/2021/01/10/let-us-start-with-the-mirroring-of-the-nginx-njs-tool-package.html 44 | 45 | ## Alternative 46 | 47 | > Independent project maintained by nginx fans. 48 | 49 | - Maintained by [@Peter Leonov](https://github.com/peter-leonov) at [4 Dec 2008](https://github.com/peter-leonov/ngx_http_js_module/commit/a5e13174211f26e0b821701c972715ebd8adbb2a), full port of [ngx_http_perl_module](http://nginx.org/en/docs/http/ngx_http_perl_module.html): [peter-leonov/ngx_http_js_module](https://github.com/peter-leonov/ngx_http_js_module) 50 | - Maintained by [@webcpp](https://github.com/webcpp) at [Apr 6, 2017](https://github.com/webcpp/hi-nginx/commit/18e478ccf4578d1136a2ea0e06f4535c7261b749#diff-a7a55a3590638a4406be827f58ad2a2b4724f42e00753b9a88d470dabf3133e9), use various languages to extend nginx as an application server: [webcpp/hi-nginx](https://github.com/webcpp/hi-nginx) 51 | --------------------------------------------------------------------------------