它由客户端和服务端组成。客户端采用纯C实现。服务端采用GO语言实现,前端界面采用vue实现。
您可以在任何地方通过Web访问您的设备的终端。通过设备ID来区分您的不同的设备。
rtty非常适合远程维护您的或者您的公司的部署在全球各地的成千上万的Linux设备。
特性
- 客户端C语言实现,非常小,适合嵌入式Linux
- 远程批量执行命令
- 支持SSL: openssl, mbedtls, CyaSSl(wolfssl)
- SSL 双向认证(mTLS)
- 非常方便的上传和下载文件
- 根据设备ID访问不同的设备
- 支持 HTTP 代理 - 访问您的设备的 Web
- 基于Xterm.js的全功能终端
- 部署简单,使用方便
客户端依赖
- libev - 高性能的事件循环库
- mbedtls(polarssl)、CyaSSl(wolfssl)或者openssl - 如果您需要支持SSL
部署服务端
如何安装rtty
针对Linux发行版
安装依赖
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
克隆rtty代码
git clone --recursive https://github.com/zhaojh329/rtty.git
编译
cd rtty && mkdir build && cd build cmake .. && make install
如何在Buildroot中使用
在menuconfig中选中rtty然后编译
Target packages ---> Shell and utilities ---> [*] rtty
如何在OpenWRT中使用
其它嵌入式Linux平台
命令行选项
Usage: rtty [option] -I, --id=string Set an ID for the device(Maximum 63 bytes, valid character:letter, number, underline and short line) -h, --host=string Server's host or ipaddr(Default is localhost) -p, --port=number Server port(Default is 5912) -d, --description=string Adding a description to the device(Maximum 126 bytes) -a Auto reconnect to the server -s SSL on -D Run in the background -t, --token=string Authorization token -f username Skip a second login authentication. See man login(1) about the details -R Receive file -S file Send file -v, --verbose verbose -V, --version Show version --help Show usage
运行rtty
将下面的参数替换为您自己的参数
sudo rtty -I 'My-device-ID' -h 'your-server' -p 5912 -a -v -d 'My Device Description'
如果您的rttys配置了一个token,请加上如下参数(将下面的token替换为您自己生成的)
-t 34762d07637276694b938d23f10d7164
如何使用
使用您的Web浏览器访问您的服务器: http://your-server-host:5913
,然后点击连接按钮。
直接连接设备,无需Web登录(需要在服务端配置设备白名单)
http://your-server-host:5913/connect/devid1
http://your-server-host:5913/connect/devid2
传输文件
从本地传输文件到远程设备
rtty -R
从远程设备传输文件到本地
rtty -S test.txt