WebSocket Relay Server

This server will relay any data posted to it's http socket to whichever websocket clients are connected, making it useful for a variety of tasks.

Dependencies

1. node.js

2. ws

    $ npm install ws
   

Quick start

1. Install the depenencies

    $ npm install
   

2. Run the app

    $ node app.js
   

Using Nginx + Upstart (optional)

1. Included are sample nginx and upstart configuration files. You will need to update both configuration files to match your specific instalation:

   • nginx.conf:

     Update line 14 to the correct IP address of the server allowed to post data to the relay.

      13: …
     14: allow <add-controlling-address-here>;
     15: …
     

   • upstart.conf:

     Update line 9 to the correct directory of the location of app.js

      8: …
     9: env RELAY_ROOT=/webapps/relay
     10: …
     

2. Symlink in both services repsective configuration files:

    sudo ln -s /path/to/root/nginx.conf /etc/nginx/sites-available/relay.conf
   sudo ln -s /path/to/root/upstart.conf /etc/init/relay.conf
   

3. Start both services:

    sudo service relay start
   sudo service nginx start
   

4. You should now be able to post to /send and any websocket clients connected will recieve any posted data.