README.md · lhp625/WebTerminal - Gitee.com

1月18日，北京，聊聊2025如何加入技术开发？

forked from armink-rtt-pkgs/WebTerminal

加入 Gitee

与超过 1200万开发者一起发现、参与优秀开源项目，私有仓库也完全免费：）

文件

该仓库未声明开源许可证文件（LICENSE），使用请关注具体项目描述及其代码上游依赖。

克隆/下载

README.md 2.05 KB

# Web Terminal 让你的终端在浏览器上跑起来

---

## 1、Web Terminal 是什么

Web Terminal 是一款针对 RT-Thread RTOS 的库。启动后，可以通过网页访问设备的控制台(命令行)系统，实现设备的 **远程/移动化** 操控。

## 2、依赖信息

- RT-Thread 组件
    - LWIP
    - LWIP/app/tftp
    - Finsh/MSH
    - DFS
- RT-Thread 包
    - Mongoose

## 3、如何使用

### 3.1 初始化

在 mongoose 初始化完成后，执行 `web_terminal_init()`

### 3.2 启动

在 Web Terminal 初始化成功后，执行 `web_terminal_start()`

PS：初始化、启动及停止功能都已经集成到了 RT-Thread 的 Finsh/MSH 命令中，也可以手动命令启动，命令格式如下：

```
web_term <init|start|stop>
```

### 3.3 传送资源文件

在根目录下新建并进入 `web_root` 文件夹

```
msh />mkdir web_root
msh />cd web_root
```

启动 TFTP 服务器

> msh /web_root>tftp_server

安装并打开 `/tools/Tftpd64-4.60-setup.exe` 这款 TFTP 工具，然后选择 **Tftp Client** 功能，如下图。（PS：如果电脑上有多个网卡，务必记得网卡也要选择）

![tftp_client](/docs/zh/images/tftp_client.png)

然后选择库源码中 `web_root` 下的 `web_finsh.html` 进行上传。（PS：如果固件开启了  `DFS_USING_WORKDIR` ，所以当前 Finsh/MSH 在哪个文件目录位置， TFTP 就会把文件保存在那里。TFTP 时请注意切换目录）

### 3.4 使用 Web Finsh

如果启用了 `DFS_USING_WORKDIR` ，要保证 Finsh/MSH 控制台当前的目录位于根目录。然后在浏览器中打开 http://put.ip.here/web_finsh.html 即可看到 Web Finsh 真容。

打开网页后的效果如下，现在即可畅快地在网页中输入各种命令，自动补全也支持的。（PS：手机上也一样可以打开 Web Finsh，现在 Finsh/MSH 已被你随时随地的掌控了）

![web_finsh](/docs/zh/images/web_finsh.png)

最后，需要注意，当 Web Finsh 网页打开后， 串口的 Finsh/MSH 就不可使用了。如果想要继续使用，则关闭 Web Finsh 网页即可。

一键复制编辑原始数据按行查看历史

提交于 2017-09-30 18:57 . 1、【增加】初始版本。

# Web Terminal 让你的终端在浏览器上跑起来

---

## 1、Web Terminal 是什么

Web Terminal 是一款针对 RT-Thread RTOS 的库。启动后，可以通过网页访问设备的控制台(命令行)系统，实现设备的 **远程/移动化** 操控。

## 2、依赖信息

- RT-Thread 组件
    - LWIP
    - LWIP/app/tftp
    - Finsh/MSH
    - DFS
- RT-Thread 包
    - Mongoose

## 3、如何使用

### 3.1 初始化

在 mongoose 初始化完成后，执行 `web_terminal_init()`

### 3.2 启动

在 Web Terminal 初始化成功后，执行 `web_terminal_start()`

PS：初始化、启动及停止功能都已经集成到了 RT-Thread 的 Finsh/MSH 命令中，也可以手动命令启动，命令格式如下：

```
web_term <init|start|stop>
```

### 3.3 传送资源文件

在根目录下新建并进入 `web_root` 文件夹

```
msh />mkdir web_root
msh />cd web_root
```

启动 TFTP 服务器

> msh /web_root>tftp_server

安装并打开 `/tools/Tftpd64-4.60-setup.exe` 这款 TFTP 工具，然后选择 **Tftp Client** 功能，如下图。（PS：如果电脑上有多个网卡，务必记得网卡也要选择）

![tftp_client](/docs/zh/images/tftp_client.png)

然后选择库源码中 `web_root` 下的 `web_finsh.html` 进行上传。（PS：如果固件开启了  `DFS_USING_WORKDIR` ，所以当前 Finsh/MSH 在哪个文件目录位置， TFTP 就会把文件保存在那里。TFTP 时请注意切换目录）

### 3.4 使用 Web Finsh

如果启用了 `DFS_USING_WORKDIR` ，要保证 Finsh/MSH 控制台当前的目录位于根目录。然后在浏览器中打开 http://put.ip.here/web_finsh.html 即可看到 Web Finsh 真容。

打开网页后的效果如下，现在即可畅快地在网页中输入各种命令，自动补全也支持的。（PS：手机上也一样可以打开 Web Finsh，现在 Finsh/MSH 已被你随时随地的掌控了）

![web_finsh](/docs/zh/images/web_finsh.png)

最后，需要注意，当 Web Finsh 网页打开后， 串口的 Finsh/MSH 就不可使用了。如果想要继续使用，则关闭 Web Finsh 网页即可。

Loading...

马建仓 AI 助手

尝试更多

代码解读

代码找茬

代码优化

1

https://gitee.com/lhp625/WebTerminal.git

[email protected]:lhp625/WebTerminal.git

lhp625

WebTerminal

WebTerminal

master