Node static server

A simple http server to serve static resource files from a local directory.

Getting started

• Install node.js
• Install npm package globally npm -g install static-server
• Go to the folder you want to serve
• Run the server static-server

Options

-h, --help                 output usage information
-V, --version              output the version number
-p, --port <n>             the port to listen to for incoming HTTP connections
-i, --index <filename>     the default index file if not specified
-f, --follow-symlink       follow links, otherwise fail with file not found
-d, --debug                enable to show error messages
-n, --not-found <filename> the error 404 file
-c, --cors <pattern>       Cross Origin Pattern. Use "*" to allow all origins
-z, --no-nocache           disable cache (http 304) responses.
-o, --open                 open server in the local browser

Using as a node module

The server may be used as a dependency HTTP server.

Example

1var StaticServer = require('static-server');
2var server = new StaticServer({
3  rootPath: '.',            // required, the root of the server file tree
4  port: 1337,               // required, the port to listen
5  name: 'my-http-server',   // optional, will set "X-Powered-by" HTTP header
6  host: '10.0.0.100',       // optional, defaults to any interface
7  cors: '*',                // optional, defaults to undefined
8  followSymlink: true,      // optional, defaults to a 404 error
9  templates: {
10    index: 'foo.html',      // optional, defaults to 'index.html'
11    notFound: '404.html'    // optional, defaults to undefined
12  }
13});
14
15server.start(function () {
16  console.log('Server listening to', server.port);
17});
18
19server.on('request', function (req, res) {
20  // req.path is the URL resource (file name) from server.rootPath
21  // req.elapsedTime returns a string of the request's elapsed time
22});
23
24server.on('symbolicLink', function (link, file) {
25  // link is the source of the reference
26  // file is the link reference
27  console.log('File', link, 'is a link to', file);
28});
29
30server.on('response', function (req, res, err, file, stat) {
31  // res.status is the response status sent to the client
32  // res.headers are the headers sent
33  // err is any error message thrown
34  // file the file being served (may be null)
35  // stat the stat of the file being served (is null if file is null)
36
37  // NOTE: the response has already been sent at this point
38});

FAQ

• Can I use this project in production environments? Obviously not.
• Can this server run php, ruby, python or any other cgi script? No.
• Is this server ready to receive thousands of requests? Preferably not.

Contributors

An special thank you to all contributors who allow this project to continue to evolve.

License

The MIT License (MIT)