rxmllc/rxmtty

By rxmllc

Updated 29 days ago

RX-M browser terminal bridge implemented in Rust

Image
Networking
Developer tools
1

10.0K

rxmllc/rxmtty repository overview

rxmtty

rxmtty is a Rust based web to ssh terminal service. Users browse to http://somehost/tty and rxmtty provides an in-browser terminal interface bridged to a local ssh client.

More info here: https://github.com/RX-M/rxmtty

Example running rxmtty on an AWS Ubuntu cloud instance using Docker (user connects to the instance public IP with a browser, e.g. http://11.12.13.14/tty):

ubuntu:~$ wget -O - https://get.docker.com | sh  #install docker
ubuntu:~$ sudo rm -f /etc/ssh/sshd_config.d/60-cloudimg-settings.conf #This file disables password authentication in EC2, so remove it
ubuntu:~$ PASS="${1:-rx-m$(date +%Y%m%d)}"       #set a password for rxmtty default user `ubuntu`
ubuntu:~$ echo $PASS
rx-m20260522
ubuntu:~$ echo "ubuntu:${PASS}" | sudo chpasswd
ubuntu:~$ sudo systemctl restart ssh             #restart ssh so that it will use the new password
ubuntu:~$ docker run --net=host  rxmllc/rxmtty

rxmtty settings:
  port: 80
  host: 0.0.0.0
  base: /tty
  ssh_host: 127.0.0.1
  ssh_user: ubuntu
  ssh_port: 22
  command: <none>
  ssl_cert: <none>
  ssl_key: <none>

inbound connection from 881.878.321.453

Options

$ docker run --net=host  rxmllc/rxmtty -h

RX-M browser terminal bridge implemented in Rust

Usage: rxmtty [OPTIONS]

Options:
  -p, --port <PORT>          [default: 80]
      --host <HOST>          [default: 0.0.0.0]
      --base <BASE>          [default: /tty]
      --ssh-host <SSH_HOST>  [default: 127.0.0.1]
      --ssh-user <SSH_USER>  [default: ubuntu]
      --ssh-port <SSH_PORT>  [default: 22]
      --command <COMMAND>    Arbitrary command to run instead of ssh
      --ssl-cert <SSL_CERT>  
      --ssl-key <SSL_KEY>    
  -h, --help                 Print help
  -V, --version              Print version

$ 

Tag summary

Content type

Image

Digest

sha256:614321926

Size

12.2 MB

Last updated

29 days ago

docker pull rxmllc/rxmtty