@sealsystems/http-server
@sealsystems/http-server serves an Express app. It accepts local HTTP connections and HTTPS-encrypted connections from any given external interface.
Last updated 3 months ago by comgit .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @sealsystems/http-server 
SYNC missed versions from official npm registry.

@sealsystems/http-server

CircleCI AppVeyor

@sealsystems/http-server serves an Express app. It accepts local HTTP connections and HTTPS-encrypted connections from any given external interface.

Installation

$ npm install @sealsystems/http-server

Quick start

First you need to add a reference to @sealsystems/http-server within your application:

const httpServer = require('@sealsystems/http-server');

Starting the server

Create an Express app to define the routes that should be handled:

const express = require('express');
const myExpressApp = express();

myExpressApp.get('/', function(req, res){
  res.send('hello world');
});

Then, create an options object:

const options = {
  app: myExpressApp,
  host: '192.168.0.1',
  port: '3000',
  consul
};

host is the hostname or the IP address of the external interface you want the server to bind to. Regardless of the host value it will also bind to localhost. Both, local and external connections use the given port. If you ommit the property host, the address that is advertised by Consul will be used as the external interface. See Consul's docs for more information about its advertise_addr setting. consul is an initialized node-consul object.

Finally, call the start function:

await httpServer.start(options);

console.log('Http server is listening', options);

Shutting down the server

Before you exit the application, you can perform a graceful shutdown. In this case, no new connection will be accepted by the server. The function returns once all already open connections are closed. Thus, no connection will be dropped by the server.

To perform a graceful shutdown, call the shutdown function:

await httpServer.shutdown();

console.log('Http server is shut down.');

Environment variables

For connections via HTTPS you can define the set of allowed ciphers by setting the environment variable TLS_CIPHERS.

TLS_UNPROTECTED controls which connections are encrypted:

  • none

    Local and external connections are encrypted via HTTPS. This is the most secure setting but decreases the performance to some extend.

  • loopback

    Local connections are served via HTTP. External connections are encrypted via HTTPS. This is the default setting.

  • world

    Local and external connections are served via HTTP. This is insecure!

SERVICE_DISCOVERY=cloud and TLS_UNPROTECTED=world together uses one HTTP server for all network interfaces. This is used in cloud scenarios where we have a secure internal network.

Technical details

In order to handle traffic coming through the local and the given external interface(s), two server objects will be created: One binds to the local interface, the other one binds to the given external interface(s). Both servers use the same port. This also allows e.g. to use HTTP locally but to encrypt external connections via HTTPS.

For bookkeeping purposes the server objects are stored as properties of the instances variable in lib/httpServer.js.

const instances = {
  external: <external server object>,
  local: <local server object>
};

Depending on the environment variable TLS_UNPROTECTED, the server objects will be of type Http or Https.

If host in the options of the start function is set to localhost or 127.0.0.1, only the local server will be created. The instances variable will look like:

const instances = {
  local: <local server object>
};

Running the build

To build this module use roboter.

$ bot

Current Tags

  • 4.0.1                                ...           latest (3 months ago)

18 Versions

  • 4.0.1                                ...           3 months ago
  • 4.0.0                                ...           7 months ago
  • 3.3.0                                ...           8 months ago
  • 3.2.6                                ...           8 months ago
  • 3.2.5                                ...           8 months ago
  • 3.2.4                                ...           8 months ago
  • 3.2.3                                ...           8 months ago
  • 3.2.2                                ...           8 months ago
  • 3.2.1                                ...           9 months ago
  • 3.2.0                                ...           9 months ago
  • 3.1.2                                ...           2 years ago
  • 3.1.1                                ...           2 years ago
  • 2.1.3                                ...           2 years ago
  • 3.1.0                                ...           2 years ago
  • 3.0.0                                ...           2 years ago
  • 2.0.14                                ...           2 years ago
  • 2.0.13                                ...           2 years ago
  • 2.0.12                                ...           2 years ago
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 1
Last Month 1
Dependencies (4)
Dev Dependencies (7)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |