rtty：在任何地方通过 Web 访问您的终端

> 本文由 [简悦 SimpRead](http://ksria.com/simpread/) 转码， 原文地址 [www.tuicool.com](https://www.tuicool.com/articles/uqEvYfN)

rtty
----

![](https://img1.tuicool.com/eYzIje7.gif!web)

![](https://img2.tuicool.com/fYzIriy.gif!web)

它由客户端和 [服务端](https://github.com/zhaojh329/rttys) 组成。客户端采用纯 C 实现。 [服务端](https://github.com/zhaojh329/rttys) 采用 GO 语言实现，前端界面采用 [iview](https://github.com/iview/iview) 和 [vue](https://github.com/vuejs/vue) 实现。

你可以在任何地方通过 Web 访问你的终端。通过设备 ID（如果不设置则使用设备的 MAC 地址）来区分你的不同的终端。

rtty 非常适合远程维护你的或者你公司的部署在全球各地的成千上万的 Linux 设备。

特性
--

*   部署简单，使用方便
*   根据设备 ID 访问不同的设备
*   提供 dashboard，直观的展示在线设备
*   基于 [Xterm.js](https://github.com/xtermjs/xterm.js) 的全功能终端
*   支持使用 [lrzsz](https://ohse.de/uwe/software/lrzsz.html) 传输文件
*   支持 SSL: openssl, mbedtls, CyaSSl(wolfssl)
*   支持远程执行命令
*   客户端非常小，适合嵌入式 Linux: rtty(20.1K) + libev(48.5K) + libuwsc(24.4K) + libwolfssl(595.9K) = 688.9K

客户端依赖
-----

*   [libev](http://software.schmorp.de/pkg/libev.html) - 高性能的事件循环库
*   [libuwsc](https://github.com/zhaojh329/libuwsc) - 一个轻量的针对嵌入式 Linux 的基于 libev 的 WebSocket 客户端 C 库。
*   [mbedtls(polarssl)](https://github.com/ARMmbed/mbedtls) 、 [CyaSSl(wolfssl)](https://github.com/wolfSSL/wolfssl) 或者 [openssl](https://github.com/openssl/openssl) - 如果你需要支持 SSL

[部署服务端](https://github.com/zhaojh329/rttys/blob/master/README_ZH.md)
--------------------------------------------------------------------

如何安装和运行 rtty 客户端
----------------

针对 Linux 发行版：Ubuntu, Debian, ArchLinux, Centos
----------------------------------------------

安装

```
wget -qO- https://raw.githubusercontent.com/zhaojh329/rtty/master/tools/install.sh | sudo bash
```

查看命令行选项

```
Usage: rtty [option]
  -i ifname    # Network interface name - Using the MAC address of
                      the interface as the device ID
  -I id        # Set an ID for the device(Maximum 63 bytes, valid character:letters
                      and numbers and underlines and short lines) - If set,
                      it will cover the MAC address(if you have specify the ifname)
  -h host      # Server host
  -p port      # Server port
  -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
```

运行 RTTY(将下面的参数替换为你自己的参数)

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

嵌入式 Linux 平台
------------

你需要自行交叉编译

[如何在 OpenWRT 中使用](https://github.com/zhaojh329/rtty/blob/master/OPENWRT_ZH.md)
------------------------------------------------------------------------------

如何使用
----

使用你的 Web 浏览器访问你的服务器: `https://your-server-host:5912` ，然后点击连接按钮。

你可以非常方便的将 RTTY 嵌入到你现有的平台： `https://your-server-host:5912/#/?id=your-id`

自动登录: `https://your-server:5912/#/?id=device-id&username=device-username&password=device-password`

远程执行命令
------

### Shell

```
curl -k https://your-server:5912/cmd -d '{"devid":"test","username":"test","password":"123456","cmd":"ls","params":["/"],"env":{}}'

{"Err":0,"msg":"","code":0,"stdout":"bin\ndev\netc\nlib\nmnt\noverlay\nproc\nrom\nroot\nsbin\nsys\ntmp\nusr\nvar\nwww\n","stderr":""}
```

### Jquery

```
var data = {devid: 'test', username: 'test', password: '123456', cmd: 'ls', params: ['/'], env: {}};
$.post('https://your-server:5912/cmd', JSON.stringify(data), function(r) {console.log(r)});
```

### Axios

```
var data = {devid: 'test', username: 'test', password: '123456', cmd: 'ls', params: ['/'], env: {}};
axios.post('https://your-server:5912/cmd', JSON.stringify(data)).then(function (response) {
    console.log(response.data);
}).catch(function (error) {
    console.log(error);
});
```

[捐赠](https://gitee.com/zhaojh329/rtty#project-donate-overview)
--------------------------------------------------------------

贡献代码
----

如果你想帮助 [rtty](https://github.com/zhaojh329/rtty) 变得更好，请参考 [CONTRIBUTING_ZH.md](https://github.com/zhaojh329/rtty/blob/master/CONTRIBUTING_ZH.md) 。

技术交流
----

QQ 群：153530783

如果该项目对您有帮助，请随手 star，谢谢！
-----------------------