nodeginx is a node.js module to create a Nginx configuration file for your nodejs application.
The package generates a file for /etc/nginx/sites-available
.
It makes Ngnix as proxy for static content with Node.js website or webapp.
The idea is to use Nginx server to prevent unnecessary traffic for node.js websites and webapps. And also to serve static content.
You can install nodeginx
and its dependencies with npm:
npm install nodeginx -g
for a global installation (for example)
To generate the configuration file from the command line, use following options:
$ nodeginx --help
usage: nodeginx [options]
Generate the Nginx configuration file as proxy for Node.js
options:
-o, --outputfile <OUTPUTFILE> File name or path for configuration file
-p, --port <PORT> Listen port for connections
-r, --rootdir <ROOT> Root path for (public) static content
-s, --servername <SERVERNAME> Server name
-u, --upstream <UPSTREAM> Upstream name value
-c, --config [CONFIG] Generate Nginx http section configuration
-w, --withoutwww [WITHOUTWWW] Redirect www to non-www
Error:
Cannot generate Nginx conf file: no options defined.
In order to use the configuration file, be sure to update Nginx http section with following values:
http {
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=one:8m max_size=3000m inactive=600m;
proxy_temp_path /var/tmp;
include mime.types;
default_type application/octet-stream;
sendfile on;
keepalive_timeout 65;
gzip on;
gzip_comp_level 6;
gzip_vary on;
gzip_min_length 1000;
gzip_proxied any;
gzip_types text/plain text/html text/css application/json application/x-javascript text/xml application/xml application/xml+rss text/javascript;
gzip_buffers 16 8k;
}
To run the tests under node you will need mocha
and should
installed (it's listed as a
devDependencies
so npm install
from the checkout should be enough), then do
$ npm test
nodeginx is currently maintained by Yassine Azzout.
- Yassine Azzout (Creator, Coder, Keeper)