An intelligent routing proxy for npm with support for: private, whitelisted, and blacklisted packaged
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


build status

An intelligent routing proxy for npm with support for: private, whitelisted, and blacklisted packages.

Sample Usage

n.b. Default CouchDB rewrites automatically loaded from config/rewrites.js.

  var smartPrivateNpm = require('smart-private-npm'),
      url = require('url');

  // Configure your private npm. You could load this in from a file
  // somewhere
  var config = {
    // Private npm options.
    rewrites: require('./config/rewrites'),
    proxy: {
      // This can optionally just be a single url.parsed URL or an array to
      // cycle through. Optionally you can also have an array of url.parsed urls
      // as well
      npm: {
        read: url.parse(''),
        write: url.parse('')
      policy: {
        npm: url.parse(''),
        private: {
          // This is the list of "known private modules"
          // that will always be proxied to the private npm.
          // It is built over time by remembering "publish" requests.
        blacklist: {
          // This is the list of modules that will ALWAYS be proxies
          // to the private npm, no matter what.
        whitelist: {
          // If enabled: only requests for these modules will be served
          // by the proxy (unless they are "known private modules").
        // In "transparent mode" the proxy will always forward to
        // the public registry.
        transparent: false
    // Server options (from "create-servers")
    http: 80,
    https: {
      port: 443,
      root: '/path/to/your/ssl/files',
      key: 'your-ssl.key',  // or .pem
      cert: 'your-ssl.cert' // or .pem

  smartPrivateNpm.createServer(config, function (err, servers) {
    if (err) {
      console.log('Error starting private npm: %j', servers);
      return process.exit(1);

    console.log('Private npm running on %j servers.', Object.keys(servers));

Understanding a Policy

In order to get your smart-private-npm setup you'll need to decide on a policy for your users, which are assumed to be authenticated by the CouchDB and the npm CouchApp. A policy is composed of:

  • Private: This is the set of "known private packages" which are always proxied to your private CouchDB server. All new publish requests are also proxied to your private CouchDB server.
  • Blacklist: These packages are explicitly forbidden to be retrieved from the public npm. It is possible for a package to be both private and blacklisted. This is how you can take ownership over a given module.
  • Whitelist: If set, only these packages (and all private npm packages) will be permitted from the public npm registry.

Both the sets of whitelisted and blacklisted packages are read from on start time and require updating from the caller.

License: Apache2
Author: Nodejitsu Inc.
Contributors: Charlie Robbins, Jarrett Cruger