archived-rtty/README.md

xTerminal(中文)(github)

XTerminal is a remote web shell tool for multi terminal devices. With it, you can access the Shell in any of your devices that can access the Internet via the browser on any device that can access the Internet. XTerminal is based on evmongoose implementation, It consists of two parts, server and client.

How To Install

Install server on Ubuntu

Install dependency

• evmongoose

• lua-cjson lua-posix mosquitto

    sudo apt install lua-cjson lua-posix mosquitto
  

Install xTerminal Server

git clone https://github.com/zhaojh329/xterminal.git
cd xterminal/ubuntu
sudo make install

Modify config(/etc/xterminal/xterminal.conf)

mqtt-port=1883
http-port=8443
document=/etc/xterminal/web
http-username=xterminal
http-password=xterminal
ssl-cert=/etc/xterminal/server.pem
ssl-key=/etc/xterminal/server.key

Run Server on Ubuntu

/etc/init.d/xterminal start

Install Client on OpenWRT/LEDE

git clone https://github.com/zhaojh329/evmongoose.git
cp -r evmongoose/openwrt openwrt_dir/package/evmongoose

git clone https://github.com/zhaojh329/xterminal.git
cp -r xterminal/openwrt openwrt_dir/package/xterminal

cd openwrt_dir
./scripts/feeds update -a
./scripts/feeds install -a

make menuconfig
Utilities  --->
	Terminal  --->
		<*> xterminal

make package/xterminal/compile V=s

How to use

Query online device

http://server:8000/list

Connect to devic

In the browser, enter the server address, the default port number 8000, and then in the page appears to enter the the MAC address of then device to be connected to, MAC address format can be: xx:xx:xx:xx:xx:xx, xx-xx-xx-xx-xx-xx, xxxxxxxxxxxxx

How To Contribute

Feel free to create issues or pull-requests if you have any problems.

Please read contributing.md before pushing any changes.

Thanks for the following project

• evmongoose
• xterm.js

If the project is helpful to you, please do not hesitate to star. Thank you!