JavaScript
Latest commit 27e0fc7 Jul 24, 2014 @snorp snorp committed with eamsen Serve PAC content encrypted.
Permalink
Failed to load latest commit information.
config
keys Initial. May 20, 2014
lib Serve PAC content encrypted. Nov 21, 2014
test Serve PAC content encrypted. Nov 21, 2014
.gitignore Add logs to gitignore. Jul 28, 2014
.jscsrc Add heap profiling metrics. Sep 1, 2014
.jshintignore Move StatsD backend out of repo. Jul 8, 2014
.jshintrc Bump up max cyclomatic complexity for HTTP/1.1 cacheability testing. Aug 6, 2014
.travis.yml Changed mozjpeg module and install nasm in travis. Jul 23, 2014
LICENSE Updated license. May 23, 2014
README.md Update readme - mozjpeg no long a direct dependency. Oct 31, 2014
package.json Use latest compatible SPDY module version for unlimites streams. Oct 30, 2014
proxy Rename start script. Jul 2, 2014

README.md

Janus - Privacy & Compression Proxy

Build Status

Requirements

Installation

Get the code first.

git clone https://github.com/mozilla/node-janus

Next, use NPM to install all the dependencies.

cd node-janus  
npm install

Configuration and Usage

Proxy

You can find the default proxy configuration in config/default.yml. All settings are exposed and documented there.

You may edit the settings directly in the default configuration file or preferably override some of settings using a custom configuration file, see the node-config documentation for more details about the configuration system.

To start the proxy, just run

./proxy

The only command-line arguments supported are -h for help and -v for showing the version.

Firefox

Minimal Version

You need at least Firefox 33 for SPDY proxy support.

Self-Signed Certificates

When using a self-signed certificate, you need to add it to Firefox first. To do this, use Firefox to open the proxy via its host-port combination.

https://<proxy.host>:<proxy.port>/

This should prompt you to add an exception for the self-signed certificate.

Automatic Client Configuration Using the Add-On

The prefered way for using the proxy is by installing the Janus add-on. When using the add-on, you can conveniently configure the optional features of the proxy and view some statistics on bandwidth savings.

Should you have reasons to set up the proxy without the add-on, please follow the manual instructions next.

Manual Client Configuration

Desktop

You can configure the secure proxy in Preferences/Advanced/Network/Settings. Select Automatic proxy configuration URL and set it to your custom PAC file or use the default configuration served by the integrated PAC server.

http://<pac.host>:<pac.port>

This will serve a suitable PAC file with the proper host and ports set. Check config/default.yml for the default PAC server connection details.

Android

For Fennec the steps are similar. Open about:config and set network.proxy.autoconfig_url to the location of your PAC file or the Janus PAC server. To load the PAC file and activate the proxy, set network.proxy.type to 2.

Production Deployment

Additional Requirements

By default, the proxy uses a basic in-memory cache and does only log basic metric stats. Additionally, the proxy supports a Redis-based caching solution and StatsD metrics reporting.

To enable the Redis cache, you need to have a running Redis server instance. The proxy-side configuration is straight-forward using config/default.yml, where you set the host and port accordingly and switch caching modes by setting cache.type.

To view and process the full metrics, you need a receiver compatible to StatsD metrics. To establish a connection, simply set the metrics.statsd settings accordingly in config/default.yml or your local overriding config files.

Self-Signed Certificate

You will also need to use your own certificate for your server FQDN. You can generate a new key and a new certificate simply by executing this command from node-janus root directory:

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout keys/key.pem -out keys/crt.pem

Be careful to correctly set the Common Name with your server FQDN, e.g., for example.com:

Common Name (e.g. server FQDN or YOUR name) []:example.com

Because a self-signed certificate is not delivered by a trusted CA, you will have to manually add it to your browser. Please have a look to the Firefox section for more details.

Development

We would be happy to accept pull requests for known issues or useful new features, so we encourage you to contribute!

Please make sure all tests pass locally before putting the request up for review, additional tests for new features would be great, too.

Tests

To run all tests use

npm test

To get coverage statistics use

npm run-script coverage

To run performance tests using Marionette you need to point the configuration to your Firefox binary in file config/test/test.yml, setting test.firefoxPath. Then launch the tests using

npm run-script marionette

To simulate different mobile network environments, use

npm run-script networksimulation 2G|3G|4G

and stop the system-wide simulation by reverting to the defaults using

npm run-script networksimulation default