Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mogria/rtsh-wetty-cli

A Client for rtsh based on wetty
https://github.com/mogria/rtsh-wetty-cli

Last synced: 1 day ago
JSON representation

A Client for rtsh based on wetty

Awesome Lists containing this project

README 

        
rtsh-wetty-cli = rtsh + web + tty

--------------------------



[rtsh](https://github.com/mogria/rtsh)client based on [wetty](https://github.com/krishnasrinivas/wetty).



Terminal over HTTP and HTTPS. Wetty is an alternative to

ajaxterm/anyterm but much better than them because wetty uses ChromeOS'

terminal emulator (hterm) which is a full fledged implementation of

terminal emulation written entirely in Javascript. Also it uses

websockets instead of Ajax and hence better response time.



hterm source - https://chromium.googlesource.com/apps/libapps/+/master/hterm/



![Wetty](/terminal.png?raw=true)



Install

-------



*  `git clone https://github.com/krishnasrinivas/wetty`



*  `cd wetty`



*  `npm install`



Run on HTTP:

-----------



    node app.js -p 3000



If you run it as root it will launch `/bin/login` (where you can specify

the user name), else it will launch `ssh` and connect by default to

`localhost`.



If instead you wish to connect to a remote host you can specify the

`--sshhost` option, the SSH port using the `--sshport` option and the

SSH user using the `--sshuser` option.



You can also specify the SSH user name in the address bar like this:



  `http://yourserver:3000/wetty/ssh/`



Run on HTTPS:

------------



Always use HTTPS! If you don't have SSL certificates from a CA you can

create a self signed certificate using this command:



  `openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 30000 -nodes`



And then run:



    node app.js --sslkey key.pem --sslcert cert.pem -p 3000



Again, if you run it as root it will launch `/bin/login`, else it will

launch SSH to `localhost` or a specified host as explained above.



Run wetty behind nginx:

----------------------



Put the following configuration in nginx's conf:



    location /wetty {

	    proxy_pass http://127.0.0.1:3000/wetty;

	    proxy_http_version 1.1;

	    proxy_set_header Upgrade $http_upgrade;

	    proxy_set_header Connection "upgrade";

	    proxy_read_timeout 43200000;



	    proxy_set_header X-Real-IP $remote_addr;

	    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

	    proxy_set_header Host $http_host;

	    proxy_set_header X-NginX-Proxy true;

    }



If you are running `app.js` as `root` and have an Nginx proxy you have to use:



    http://yourserver.com/wetty



Else if you are running `app.js` as a regular user you have to use:



    http://yourserver.com/wetty/ssh/



**Note that if your Nginx is configured for HTTPS you should run wetty without SSL.**



Dockerized Version

------------------



This repo includes a Dockerfile you can use to run a Dockerized version of wetty.  You can run

whatever you want!



Just do:



```

    docker run --name term -p 3000 -dt nathanleclaire/wetty

```



Visit the appropriate URL in your browser (`[localhost|$(boot2docker ip)]:PORT`).  

The username is `term` and the password is `term`.



Run wetty as a service daemon

-----------------------------



Install wetty globally with -g option:



```bash

    $ sudo npm install wetty -g

    $ sudo cp /usr/local/lib/node_modules/wetty/bin/wetty.conf /etc/init

    $ sudo start wetty

```



This will start wetty on port 3000. If you want to change the port or redirect stdout/stderr you should change the last line in `wetty.conf` file, something like this:



    exec sudo -u root wetty -p 80 >> /var/log/wetty.log 2>&1