Watch 63 Star 260 Fork 51

GVP赵建辉 / rttyCMIT

Join us
Explore and code with more than 2 million developers,Free private repositories !:)
Sign up
在任何地方通过web访问您的设备的终端 spread retract

Clone or download


license PRs Welcome Issue Welcome Release Version Build Status

It is composed of a client and a server. The client is written in pure C. The server is written in go language and the front-end interface is written in iview & Vue.

You can access your device's terminal from anywhere via the web. Differentiate your different device by device ID.

rtty is very suitable for remote maintenance your or your company's thousands of Linux devices deployed around the world.


  • Simple to deployment and easy to use
  • Access different devices based on device ID
  • Provide a dashboard to visualize online devices
  • Fully-featured terminal based on Xterm.js
  • Support transfer file
  • SSL support: openssl, mbedtls, CyaSSl(wolfssl)
  • Support device authorization
  • Support Execute a command remote
  • The client is very small, suitable for embedded Linux: rtty(20.1K) + libev(48.5K) + libuwsc(24.4K) = 93K. If you want to support ssl, +libwolfssl(595.9K) = 688.9K

Dependencies of the Client side

Deploying the server side

How to install and run the Client - rtty

For Linux distribution: Ubuntu, Debian, ArchLinux, Centos


wget -qO- | sudo bash

Command-line Options

Usage: rtty [option]
  -I id        # Set an ID for the device(Maximum 63 bytes, valid character:letter,
                      number, underline and short line)
  -h host      # Server's host or ipaddr
  -p port      # Server port(Default is 5912)
  -a           # Auto reconnect to the server
  -v           # verbose
  -d           # Adding a description to the device(Maximum 126 bytes)
  -s           # SSL on
  -k keepalive # keep alive in seconds for this client. Defaults to 5
  -V           # Show version
  -D           # Run in the background
  -t token     # Authorization token

Run RTTY(Replace the following parameters with your own parameters)

sudo rtty -I 'My-device-ID' -h 'your-server' -p 5912 -a -v -s -d 'My Device Description'

If your rttys is configured with a token, add the following parameter(Replace the following token with your own)

-t 34762d07637276694b938d23f10d7164

For OpenWRT

For Other Embedded Linux Platform


Use your web browser to access your server: https://your-server-host:5912, then click the connection button

You can easily embed RTTY into your existing platform: https://your-server-host:5912/#/?id=your-id

Automatic login: https://your-server:5912/#/?id=device-id&username=device-username&password=device-password

Transfer file

Transfer file from local to remote device

rtty -R

Transfer file from remote device to the local

rtty -S test.txt

Execute command remotely



If you would like to help making rtty better, see the file.

Comments ( 23 )

Sign in for post a comment


Help Search

191139_cd20d5fd_5186603 191143_ebef6f8d_5186603