Deploy and Use rtty for Web‑Based Remote Linux Terminal Access

What is rtty?

rtty consists of a client written in pure C, a server implemented in Go, and a front‑end UI built with Vue. It enables web‑based terminal access to any device identified by a unique device ID, making it ideal for remote Linux maintenance.

Key Features

Lightweight C client suitable for embedded Linux

Remote batch command execution

SSL support (OpenSSL, mbedtls, CyaSSL/wolfssl)

Mutual TLS authentication (mTLS)

Easy file upload/download

Device‑specific access via device ID

HTTP proxy for web access to devices

Full‑featured terminal powered by Xterm.js

Simple deployment and usage

Installation and Deployment

Install Dependencies

sudo apt install -y libev-dev libssl-dev   # Ubuntu/Debian

sudo pacman -S --noconfirm libev openssl   # ArchLinux

sudo yum install -y libev-devel openssl-devel   # CentOS

Clone the Repository

git clone --recursive https://github.com/zhaojh329/rtty.git

Build the Server

cd rtty && mkdir build && cd build
cmake .. && make install

Configure Your Device

Replace the placeholders with your own values:

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

Generate a Token

$ rttys token
Please set a password:******
Your token is: 34762d07637276694b938d23f10d7164

Use the Token

$ rttys -t 34762d07637276694b938d23f10d7164

Access via Browser

Open your web browser and navigate to: http://your-server-host:5913 Click the connect button, or connect directly without the web UI (requires a whitelist on the server):

http://your-server-host:5913/connect/devid1 http://your-server-host:5913/connect/devid2

File Transfer Commands

From local to remote: rtty -R From remote to local:

rtty -S test.txt

Open‑Source Repository

https://github.com/zhaojh329/rtty