# web-terminal

**Repository Path**: luzhining/web-terminal

## Basic Information

- **Project Name**: web-terminal
- **Description**: 用 Rust 编写的网页终端
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2023-03-09
- **Last Updated**: 2023-03-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# web-terminal

### 介绍
用 Rust 编写的网页终端。

实现方式：用 WebSocket 连接前端 [xterm.js](https://xtermjs.org/) 和后端 shell 进程。

### 构建

需要 `PAM` 开发库，`Ubuntu` 系统可用以下命令安装：
```shell
sudo apt install libpam0g-dev
```

构建：

```shell
cargo build --release
```

`bin` 目录有编译好的适用于 `x86_64 Ubuntu 20.04` 的可执行文件（只在 `Ubuntu 20.04` 上测试过）。

### 使用说明

```shell
web-terminal -b 127.0.0.1:8888
```

-b 选项指定地址。

### 用户验证

用户验证使用 `PAM`, service name 为 `web-terminal`。

用户可登录的前提是设置了密码，shell 不为 `false` 或 `nologin`。

如果以 root 权限执行本程序，所有可登录系统的用户都可以登录。

如果以普通权限执行，只有执行用户可以登录。



[点此查看演示](https://demo.trait.pub/web-terminal/) （用户名密码均为 `demo`）