1. 为什么你需要一个像rtty这样的远程终端如果你玩过嵌入式开发或者折腾过树莓派、OpenWrt路由器肯定遇到过这样的场景设备放在实验室角落或者已经部署到现场了突然发现有个配置需要改或者日志需要看。这时候你难道要抱着显示器、键盘鼠标跑过去或者更麻烦的通过串口线连上去操作吗太折腾了。我最早接触远程终端的需求就是因为手头有几个跑着定制Linux的工控板分散在不同的测试台上。每次调试都得插拔串口线效率极低还容易把接口搞松。后来试过一些方案比如用ssh但前提是设备得有固定IP或者能在内网互通也试过一些需要复杂内网穿透的工具配置起来头大。直到我遇到了rtty。它就像一个为你设备量身定制的“远程桌面”特指终端但比VNC轻量得多核心就是一个客户端-服务端C/S架构。你的设备客户端主动连接到一台有公网IP的服务器服务端然后你就可以在任何有网络的地方通过网页浏览器访问这台服务器进而像操作本地终端一样操作你那台远在天边的设备。它的好处特别直接无需公网IP设备在内网、在防火墙后面都没关系只要它能访问互联网能连上你的rtty服务器就行。这是解决远程调试痛点的关键。纯Web访问你不需要在本地安装任何额外的客户端软件一个浏览器Chrome, Firefox等就够了跨平台特性拉满。部署相对简单服务端就一个Go编译的二进制文件客户端是C写的交叉编译到各种ARM、MIPS架构的设备上也很方便。安全可控通信可以启用SSL/TLS加密并且所有连接都通过你自己的服务器中转数据不经过第三方心里踏实。所以无论你是想远程维护家里的智能家居中枢还是管理公司成百上千的物联网设备或者像我一样只是不想再跑来跑去插串口线rtty都是一个值得放进工具箱的利器。下面我就结合在阿里云上部署服务端以及在本地Ubuntu虚拟机和实际ARM设备上部署客户端的完整过程带你一步步走通并分享我踩过的坑和解决办法。2. 实战前准备理解核心与获取资源动手之前我们花几分钟把rtty的核心组件和资源获取的路径搞清楚这能避免后面很多困惑。rtty项目主要包含两部分都在GitHub上由开发者zhaojh329维护rttys这是服务端Server。它是用Go语言编写的意味着它编译后是一个独立的、不依赖复杂运行环境的二进制文件。它的职责就是在一个有公网IP的服务器上运行监听端口等待客户端连接并提供Web界面供我们管理。rtty这是客户端Client。它是用C语言编写的非常轻量目标就是运行在各种资源受限的嵌入式Linux设备上。它的工作就是主动去连接上面提到的rttys服务端建立一条安全的通道。资源获取的“正确姿势” 原始文章里提到从https://github.com/zhaojh329下载这个路径需要细化。更准确的地址是服务端 rttys:https://github.com/zhaojh329/rttys客户端 rtty:https://github.com/zhaojh329/rtty我个人的习惯是服务端直接用官方编译好的Release版本省时省力。而客户端因为要适配不同架构的设备比如ARMv7, ARM64, MIPS等往往需要自己交叉编译。原始文章的作者在编译Go版服务端时遇到了依赖问题这其实很常见尤其是Go版本和模块依赖更新快的时候。所以对于新手我强烈建议服务端直接用预编译二进制文件客户端视情况而定。你需要准备的环境一台有公网IP的服务器我将以阿里云ECSUbuntu 20.04 LTS为例。腾讯云、华为云或者其他任何VPS都可以原理一样。待调试的设备可以是一台本地虚拟机用于模拟和测试也可以是真实的嵌入式设备如树莓派、基于ARM的工控板。我将演示两者。一个域名可选但推荐如果你打算启用SSLhttps访问Web界面需要一个域名。如果没有也可以使用IP访问但部分浏览器可能会有安全提示。好了概念清晰了资源也知道去哪找了接下来我们就进入实战环节从服务端部署开始。3. 服务端部署在阿里云上搭建rttys我们把rttys服务端搭建在阿里云上让它成为我们所有远程设备的中枢。3.1 服务器初始化与文件下载首先通过SSH登录到你的阿里云服务器。假设你已经在安全组规则里放行了后续需要用到的端口例如5912, 5913 还有HTTP/HTTPS端口。我们先创建一个工作目录并下载最新的rttys发布版。# 登录到你的阿里云服务器 ssh rootyour-aliyun-ip # 创建一个专门的目录方便管理 mkdir -p /opt/rttys cd /opt/rttys # 查看最新的发布版本这里以4.0.1为例请替换为最新版本号 # 可以去 https://github.com/zhaojh329/rttys/releases 查看 # 假设你的服务器是x86_64架构大多数云服务器都是 wget https://github.com/zhaojh329/rttys/releases/download/v4.0.1/rttys-linux-amd64.tar.gz # 解压 tar -zxvf rttys-linux-amd64.tar.gz # 进入解压后的目录通常会有一个可执行文件和一个配置文件样本 cd rttys-linux-amd64 ls -la你应该能看到类似这样的文件rttys 主程序二进制文件rttys.conf 配置文件示例LICENSE 许可证文件原始文章里提到了rttys.db和rttys.service这两个文件并不是发布包自带的。rttys.db是程序运行后自动生成的SQLite数据库文件用于存储设备令牌等信息rttys.service是Systemd服务文件需要我们手动创建以实现开机自启。3.2 配置文件的详解与定制接下来是核心步骤配置rttys.conf。我们复制一份示例配置文件并开始编辑。# 复制示例配置文件 cp rttys.conf rttys.conf.bak # 备份 vim rttys.conf # 或用nano配置文件是JSON格式的结构清晰。我挑几个最关键、最可能需要修改的选项说{ addr: :5912, ssl_addr: :5913, ssl: false, ssl_cert: , ssl_key: , auth: false, username: , password: , token: your-strong-token-here, proxy_addr: , db: rttys.db, http_addr: :80, https_addr: :443, https: false, https_cert: , https_key: }关键参数解读与我的建议addr和ssl_addr这是客户端连接的端口。addr(5912)用于非SSL连接ssl_addr(5913)用于SSL加密连接。我强烈建议只要条件允许就启用SSL。即使你暂时没有域名和证书也可以先使用自签名证书进行测试避免密码等敏感信息明文传输。ssl,ssl_cert,ssl_key启用客户端SSL连接。如果你有域名和SSL证书比如从Let‘s Encrypt免费申请的就把证书和私钥的路径填在这里。如果没有可以暂时设为false但生产环境务必启用。authWeb管理界面的HTTP Basic认证。建议设为true并设置下面的username和password否则你的Web界面可能被任何人访问。token这是重中之重这是客户端连接服务端时必须提供的“通行证”。务必把它改成一个足够复杂、唯一的字符串不要用默认的。你可以用openssl rand -hex 16命令生成一个。http_addr和https_addr这是Web管理界面访问的端口。默认80和443需要root权限。如果你不想用root运行或者端口已被占用可以改成如:8080和:8443。https,https_cert,https_key启用Web界面的HTTPS访问。同样有域名证书就填上安全性更高。我的典型配置测试环境如下供你参考{ addr: :5912, ssl_addr: :5913, ssl: false, auth: true, username: admin, password: YourStrongPassword!, token: a1b2c3d4e5f67890fedcba9876543210, db: /opt/rttys/rttys.db, http_addr: :8080, https: false }注意我把db的路径改成了绝对路径这样无论从哪个目录启动程序数据库文件位置都是固定的。3.3 运行测试与创建系统服务配置好后我们先在前台运行测试一下确保没有报错。# 确保在 /opt/rttys/rttys-linux-amd64 目录下 ./rttys -c rttys.conf如果看到类似下面的日志说明服务端启动成功2023/10/27 10:30:00 |INFO| Go Version: go1.19.3 2023/10/27 10:30:00 |INFO| Go OS/Arch: linux/amd64 2023/10/27 10:30:00 |INFO| Rttys Version: 4.0.1 2023/10/27 10:30:00 |INFO| Listen device on: :5912 SSL off 2023/10/27 10:30:00 |INFO| Listen user on: :8080现在打开你的浏览器访问http://你的阿里云服务器IP:8080。如果配置了认证输入用户名密码就能看到rtty的Web管理界面了。此时设备列表应该是空的因为我们还没连接客户端。测试无误后按CtrlC停止程序。接下来创建Systemd服务让它开机自启并在后台稳定运行。# 创建systemd服务文件 vim /etc/systemd/system/rttys.service将以下内容写入注意修改ExecStart的路径为你实际存放rttys二进制文件和配置文件的路径[Unit] DescriptionRttys Server Afternetwork.target [Service] Typesimple Usernobody # 为了安全可以用一个非root用户如nobody Restarton-failure RestartSec5s WorkingDirectory/opt/rttys/rttys-linux-amd64 ExecStart/opt/rttys/rttys-linux-amd64/rttys -c /opt/rttys/rttys-linux-amd64/rttys.conf [Install] WantedBymulti-user.target保存退出后执行以下命令启用并启动服务# 重新加载systemd配置 systemctl daemon-reload # 启动rttys服务 systemctl start rttys # 设置开机自启 systemctl enable rttys # 查看服务状态和日志确认运行正常 systemctl status rttys journalctl -u rttys -f看到状态为active (running)且没有报错服务端就部署完成了。你的远程终端“指挥中心”已经就绪。4. 客户端部署从虚拟机到真实设备服务端在云端跑起来了现在我们需要让客户端“入驻”到我们想远程控制的设备里。我分两种情况讲一是在本地Ubuntu虚拟机里测试模拟一个x86环境二是交叉编译到ARM设备比如树莓派或嵌入式板卡。4.1 在本地Ubuntu虚拟机中编译与运行这种方式主要用于验证整个流程或者你的客户端设备本身就是x86/64的Linux服务器或虚拟机。首先在虚拟机里获取rtty客户端源码并编译# 安装编译依赖 sudo apt update sudo apt install -y git build-essential cmake libssl-dev # 克隆源码 git clone https://github.com/zhaojh329/rtty.git cd rtty # 创建构建目录并编译 mkdir build cd build cmake .. make -j$(nproc)编译完成后在build目录下会生成rtty可执行文件。你可以先把它拷贝到一个方便的地方比如/usr/local/bin/或者直接在编译目录运行。运行客户端连接 这是最关键的一步。你需要知道服务端的公网IP或域名、端口如果启用了SSL就用5913否则用5912、以及之前在rttys.conf里设置的token。# 假设服务端IP是 8.142.6.184未启用SSLtoken是 my-secret-token # -I 参数指定设备ID这个ID可以自定义用于在Web界面区分设备 # -h 和 -p 指定服务端地址和端口 # -a 参数表示自动重连 # -v 输出详细信息 # -d 给设备一个描述名 sudo ./rtty -I my-ubuntu-vm -h 8.142.6.184 -p 5912 -a -v -t my-secret-token -d My Ubuntu Test VM运行命令后如果看到类似connected to server和register success的输出就说明连接成功了立刻刷新你的Web管理界面 (http://服务器IP:8080)你应该能看到一个名为“my-ubuntu-vm”的设备在线。点击它旁边的“终端”按钮一个基于浏览器的Shell就出现了你可以尝试输入ls,pwd等命令效果和直接SSH到这台虚拟机一模一样。4.2 为ARM设备交叉编译客户端嵌入式设备资源有限通常需要我们在功能强大的开发机比如你的笔记本电脑通常是x86架构上为ARM架构的设备编译出可执行文件。这个过程就是交叉编译。搭建交叉编译环境 以最常见的ARMv732位和AArch6464位为例。你需要安装对应的交叉编译工具链。如果你用的是Ubuntu可以很方便地安装# 对于 ARM 32位 (arm-linux-gnueabihf) sudo apt install -y gcc-arm-linux-gnueabihf # 对于 ARM 64位 (aarch64-linux-gnu) sudo apt install -y gcc-aarch64-linux-gnu交叉编译rtty 编译步骤和本地编译类似但需要指定交叉编译工具链。我们以ARM 64位为例# 回到rtty源码根目录 cd rtty rm -rf build # 清理之前的构建 mkdir build-arm64 cd build-arm64 # 关键指定交叉编译工具链 cmake -DCMAKE_C_COMPILERaarch64-linux-gnu-gcc -DCMAKE_CXX_COMPILERaarch64-linux-gnu-g .. # 编译 make -j$(nproc)编译完成后build-arm64目录下的rtty文件就是一个可以在ARM64设备上运行的可执行文件了。你可以用file命令验证一下file rtty # 输出应包含ELF 64-bit LSB executable, ARM aarch64, version 1 (SYSV), dynamically linked, ...部署到ARM设备并运行 将编译好的rtty文件传输到你的ARM设备上比如树莓派。可以用scp命令scp ./rtty piraspberrypi.local:/home/pi/然后SSH登录到你的ARM设备给文件添加执行权限并运行# 在ARM设备上操作 chmod x rtty sudo ./rtty -I my-raspberry-pi -h 你的服务器IP -p 5912 -a -t 你的token -d Raspberry Pi 4B同样连接成功后在Web界面就能看到并控制这台树莓派了。对于没有图形界面、只有串口或网络Console的设备rtty提供的这个Web终端简直是救命稻草。5. 深度配置与故障排查指南基础功能跑通后我们来看看如何让它更稳定、更安全以及遇到问题怎么解决。5.1 启用SSL/TLS加密通信明文传输总是不安全的。为客户端连接启用SSL是生产环境的必备步骤。你需要为你的服务器域名准备SSL证书和私钥。如果你没有可以用Let‘s Encrypt免费申请或者用于测试时生成自签名证书。生成自签名证书仅测试用 在服务端服务器上执行openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes -subj /CNyour-server-ip-or-domain这会生成cert.pem证书和key.pem私钥。记住自签名证书浏览器会报警告但rtty客户端可以接受。修改服务端配置 在rttys.conf中修改SSL相关配置{ ssl: true, ssl_cert: /opt/rttys/cert.pem, ssl_key: /opt/rttys/key.pem, ssl_addr: :5913, // ... 其他配置不变 }重启rttys服务sudo systemctl restart rttys修改客户端连接命令 客户端连接时需要指定SSL端口5913并可能需要忽略证书验证对于自签名证书。rtty客户端通过-s参数来指定使用SSL。# 使用SSL连接 sudo ./rtty -I my-device -h your-domain.com -p 5913 -s -a -t your-token -d My Device # 如果你的证书是自签名的客户端可能会报错。rtty客户端目前似乎没有直接忽略证书验证的选项。 # 稳妥起见测试环境可以先不用SSL生产环境务必使用可信证书。5.2 客户端作为系统服务常驻运行我们不能每次都手动SSH到设备上去启动rtty客户端。我们需要让它开机自启并且崩溃后能自动重启。在客户端设备上比如树莓派我们也可以创建一个Systemd服务。在客户端设备上创建服务文件/etc/systemd/system/rtty.service[Unit] DescriptionRtty Client Afternetwork.target [Service] Typesimple Userroot Restartalways RestartSec10 ExecStart/usr/local/bin/rtty -I device-unique-id -h your-server.com -p 5913 -s -a -t your-strong-token -d Device Description # 注意请将路径、ID、服务器地址、token等替换成你自己的真实信息。 # 如果不用SSL去掉 -s 并将端口改为5912 [Install] WantedBymulti-user.target然后启用并启动它sudo systemctl daemon-reload sudo systemctl enable rtty sudo systemctl start rtty sudo systemctl status rtty5.3 常见问题与解决方案在我部署的过程中踩过不少坑这里总结几个最常见的客户端连接失败提示“Connection refused”或超时检查防火墙这是最常见的原因。确保云服务器安全组/防火墙入方向放行了你配置的端口5912/5913, 8080/443等。检查服务端是否运行在服务器上执行sudo systemctl status rttys和sudo netstat -tlnp | grep rttys看服务是否在监听正确端口。检查客户端命令参数仔细核对-hIP/域名、-p端口、-ttoken是否正确。token错误也会导致连接被拒绝。Web界面能打开但设备列表为空或设备离线检查客户端日志在客户端设备上运行rtty时加上-v参数查看详细输出。确认看到了connected to server和register success。检查服务端日志sudo journalctl -u rttys -f查看实时日志看是否有设备连接和注册的记录。设备ID冲突确保每个客户端使用的-I参数设备ID是唯一的。重复的ID可能导致新设备挤掉旧设备。Web终端连接后无法输入或显示异常浏览器兼容性尽量使用Chrome、Firefox、Edge等现代浏览器。网络问题网络延迟或丢包可能导致终端响应迟钝。检查网络状况。客户端进程权限确保rtty客户端是以有足够权限的用户通常是root运行的否则可能无法启动某些子进程。服务端启动报错提示端口被占用修改rttys.conf中的http_addr或addr/ssl_addr为一个未被占用的端口。使用sudo lsof -i :端口号或sudo netstat -tlnp | grep :端口号查看是哪个进程占用了端口。交叉编译失败提示找不到工具链或库确认已正确安装交叉编译工具链包。在CMake命令中确保CMAKE_C_COMPILER和CMAKE_CXX_COMPILER的路径和名称完全正确。有时需要指定完整路径如/usr/bin/aarch64-linux-gnu-gcc。记住日志是你的好朋友。无论是服务端的journalctl日志还是客户端的-v输出都能提供最直接的错误线索。