Version 0.1.1
This is an RPC proxy for running a public server for the Twister P2P microblogging network. Public servers allow anyone to easily read news posted on Twister from the web. If a user wants to become active on the network, he/she is directed to instructions on how to install the app. Twister proxy needs twister-core to be able to access the network.
Twister is in alpha phase, it's still under construction. It is already being used, but it may be unstable, and difficult to compile. This is the project website http://twister.net.co/
Twister is open source, the source code is available here: https://github.com/miguelfreitas/twister-core
1 - install Twister
instructions can be found here: http://twister.net.co/?page_id=23
2 - install node.js
it's available for all major platforms from here: http://nodejs.org/
3 - install twister-proxy
clone it from the repository
git clone https://github.com/digital-dreamer/twister-proxy.git
install it
cd twister-proxy
npm install
4 - run twisterd
go to your twister-core folder and run twisterd with the following options:
./twisterd -daemon -rpcallowip=127.0.0.1 -public_server_mode=1
This will run twister server in background, allow RPC calls, but only from the same computer, and put it in "public server mode", which is designed for this purpose.
5 - run twister-proxy
go to the twister-proxy folder and run
node twister-proxy.js &
(If you use ports lower that 1024 you need to use sudo - sudo node twister-proxy.js &) this will launch a public server on default http port 80. If you need to change any settings, you can edit the settings.json file.
If you type your server's URL into a web browser, you should see the twister web application. It is now functional, but if you care about privacy for your users, I highly recommend taking one more step and enabling SSL.
1 - upgrade OpenSSL to the latest version to protect your server from Heartbleed
Visit http://heartbleed.com/ if you want to know more about this issue.
2 - generate a key and certificate request
openssl genrsa -des3 -out server-key.pem 2048
openssl req -new -key server-key.pem -out request.csr
Keep the generated server-key.pem safe.
If you want to know more about keys: https://www.openssl.org/docs/HOWTO/keys.txt
3 - request a certificate
You now give the request.csr file to a Certification Authority (CA) - a company that will generate a certificate and give it back to you.
This guide shows where to get a certificate cheap or for free:
http://webdesign.about.com/od/ssl/tp/cheapest-ssl-certificates.htm
4 - enable SSL in twister-proxy
Edit the settings.json file
- In "ssl_key_file", specify a path to the server-key.pem file that you generated.
- In "ssl_certificate_file", specify a path to the file that you received from your Certificate Authority.
- Change "enable_https" from false to true.
That's it. If you now run twister-proxy, it will use secure https connections.
1 - To keep a log, redirect twister proxy output to a file
Example:
node twister-proxy.js > output.log &
2 - You can use the "forever" module to keep the proxy server running
A guide can be found here:
https://blog.nodejitsu.com/keep-a-nodejs-server-up-with-forever/
Twister must be running and accepting RPC calls, run it with these parameters:
./twisterd -daemon -rpcallowip=127.0.0.1 -public_server_mode=1
If you changed the RPC port, username or password in twister.conf, you need to change it in settings.json too.
You probably damaged settings.json when editing it. If you can spot what went wrong, you can correct it, if not, download the default settings.json and redo your customization.
If you get stuck, and need some help setting up a public Twister server, you can ask in the issue section, even if it is not an actual issue with the code.