njs-examples
njs
njs-examples | njs | |
---|---|---|
6 | 3 | |
547 | 737 | |
1.7% | 0.3% | |
4.9 | 9.2 | |
5 months ago | 1 day ago | |
JavaScript | C | |
- | BSD 2-clause "Simplified" License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
njs-examples
- Nginx Development Guide
- THE LIST - You want the goods? You got the goods.
-
A nginx and docker built reverse proxy server to cache the slow expensive requests to the openai api.
this is also extremely helpful when using nginx https://github.com/nginx/njs-examples
-
Reverse Proxy: creating a fixed port offset?
I don't know if you can do this directly in nginx config but you can definitely do it with njs. This github repo has some examples of how njs is used to do things during in-flight request: https://github.com/nginx/njs-examples. Also I think the variable you are looking for is $proxy_port (http://nginx.org/en/docs/varindex.html)
-
Create Nginx extensions in JavaScript
Examples on GitHub: https://github.com/nginx/njs-examples/
- Nginx JavaScript in Your Web Server Configuration
njs
-
The Future of Nginx: Getting Back to Our Open Source Roots
This article came at an interesting timing for me, since I recently started to explore building my own CDN node on top of NGINX open source inspired by this article from Fly: https://fly.io/blog/the-5-hour-content-delivery-network/
I've worked with nginx in the past, and didn't have a great experience, so I was apprehensive diving in, but this time was very different. I think njs (their custom JS scripting environment) was a game changer. Support is built in to nginx core, and available by default in their docker containers, so it's much easier to get started with than Lua scripting. Their JS feature support has some quirks (no optional chaining, array destructuring, console.log's don't show up in logs, are some examples of things that threw me off) but overall nothing that blocked me from implementing the functionality I needed, and the integration points within the nginx config felt fairly natural.
I did run into a number of things that were locked behind their commercial offering that made me a bit uncomfortable betting on it for the long term compared to purely open source alternatives. Off the top of my head:
- DNS discovery. There's a thread on the Fly example repo accompanying the blog post that describes the use case and proposes some workarounds: https://github.com/fly-apps/nginx-cluster/issues/2. Life would be a lot simpler if DNS discovery from the commercial offering was just available (i.e. we can outright delete a brittle bash script that makes DNS queries and reloads nginx on a 5 second interval). This was mentioned in the article as something they're planning to open source.
- Access to some kind of shared key-value store for custom caching logic in njs scripts. With Lua we could just connect to Redis, but njs can't seem to establish persistent network connections for now, so that's off the table. This wasn't mentioned in the article, but they did mention in this Github issue that they're planning on open sourcing their keyval module for this use case: https://github.com/nginx/njs/issues/437. I have some use cases where being able to connect to Redis would be ideal, since syncing keyval across a cluster seems to be eventually consistent (https://docs.nginx.com/nginx/admin-guide/high-availability/z...), but for most of my caching use cases it should be sufficient.
So this article, along with their overall willingness to work with the community to identify and bring commercial features into open source (at least from what I've observed across their responses to Github issues) does a lot to alleviate those concerns.
Though at the end of the day, I don't necessarily need every nginx feature to be in open source. I have no problems with paying for great software like nginx to support its development. But as a small bootstrapped founder, their current pricing structure (from what I could gather on the internet is ~ 2k-5k per running instance), is completely prohibitive. It'd probably require a revamp to the way they sell the software (i.e. self-serve onboarding and automatic license provisioning for smaller customers instead of having customers of all sizes go through expensive sales people), but I'd love to see a more progressive pricing structure with a lower barrier to entry for their commercial product.
-
ngx_stream_js_module: ngx.fetch in js_filter function
I'd leave guys a bug at github: https://github.com/nginx/njs .
- Nginx JavaScript in Your Web Server Configuration
What are some alternatives?
nginxconfig.io - ⚙️ NGINX config generator on steroids 💉
lua-nginx-module - Embed the Power of Lua into NGINX HTTP servers
Nginx Proxy Manager - Docker container for managing Nginx proxy hosts with a simple, powerful interface
server-side-tls - Server side TLS Tools
njs-learning-materials - List some learning materials to help you step into the world of njs.
nginx-cluster - A horizontally scalable NGINX caching cluster
ngx_wasm_module - Nginx + WebAssembly
kubernetes-ingress - NGINX and NGINX Plus Ingress Controllers for Kubernetes
h5ai - HTTP web server index for Apache httpd, lighttpd and nginx.
cache-handler - Distributed HTTP caching module for Caddy
replace-response - Caddy module that performs replacements in response bodies