Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zyyzyykk/kkTerminal
kkTerminal，一个web终端实现ssh远程连接服务器。kkTerminal, a web-based terminal for SSH remote server connection.
https://github.com/zyyzyykk/kkTerminal
docker shell ssh terminal web xterm xterm-js
Last synced: 3 months ago
JSON representation
kkTerminal，一个web终端实现ssh远程连接服务器。kkTerminal, a web-based terminal for SSH remote server connection.
- Host: GitHub
- URL: https://github.com/zyyzyykk/kkTerminal
- Owner: zyyzyykk
- License: apache-2.0
- Created: 2023-10-14T08:05:24.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-08-24T14:02:02.000Z (3 months ago)
- Last Synced: 2024-08-25T12:25:20.641Z (3 months ago)
- Topics: docker, shell, ssh, terminal, web, xterm, xterm-js
- Language: Vue
- Homepage: https://ssh.kkbpro.com/
- Size: 35.1 MB
- Stars: 13
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# kkTerminal
> kkTerminal，一个web终端实现ssh远程连接服务器
>
> kkTerminal, a web-based terminal for SSH remote server connection.
>
> 作者：[zyyzyykk](https://github.com/zyyzyykk/)
>
> 源代码：https://github.com/zyyzyykk/kkTerminal
>
> docker仓库地址：https://hub.docker.com/repository/docker/zyyzyykk/kkterminal/general
>
> 预览：https://ssh.kkbpro.com/ (国内服务器访问) 或 https://ssh.kkbapps.com/ (国外服务器访问)
>
> 更新时间：2024-08-14
>
### **⚡** 快速引入
在html网页中使用 `iframe` 标签实现快速引入：
```html
```
### 💪 使用docker部署
1.拉取镜像：
```bash
docker pull zyyzyykk/kkterminal
```
2.创建并运行容器，进行端口映射：`-p 端口号:3000`
```bash
docker run -d --name kkterminal -p 3000:3000 zyyzyykk/kkterminal
```
3.挂载数据卷：`-v 数据卷路径:/data`
```bash
docker run -d --name kkterminal -p 3000:3000 -v /data:/data zyyzyykk/kkterminal
```
4.自定义艺术字：`-e TITLE="自定义艺术字"`
```bash
docker run -d --name kkterminal -p 3000:3000 -e TITLE="kkbpro" zyyzyykk/kkterminal
```
5.在浏览器中访问：`http://服务器ip:3000/`
### 🛸 预览
访问以下网址：
- 🌐 国内服务器访问：https://ssh.kkbpro.com/
- 🌍 国外服务器访问：https://ssh.kkbapps.com/
[**更多模块预览**](./MODULE.md)
### 💡 功能说明
1.kkTerminal是一个web端ssh远程连接服务器的工具，点击左上角的终端图标，选择连接设置进行ssh连接
2.支持在网页中使用 `iframe` 标签引入，可快速集成到第三方网站中
3.支持本地PC端部署，启动时会自动打开浏览器窗口
4.支持窗口大小自适应，支持中文输入
5.支持自定义偏好设置，可选择终端的背/前景色、字体字号、光标显示样式、启用TCode
6.支持重启：当修改ssh连接设置或自定义偏好设置后会自动重启，也可在ssh连接断开后手动进行重启
7.支持复制粘贴：
- 复制同 `git` 终端，选中文本会自动进行复制
- 粘贴同 `cmd` 终端，单击鼠标右键进行粘贴（需要浏览器打开权限）
8.支持文件管理，打开文件管理模块进行文件/文件夹的查看、上传与下载；
9.支持文件多选/全选、复制粘贴、剪切等快捷键操作
10.支持文件的浏览与编辑，修改文件后使用 `ctrl+s` 保存至远程服务器
11.支持 [TCode (终端代码)](./TCODE.md)，能够通过自定义TCode实现类似Shell脚本的自动化Workflow
### 👨💻 更新记录
##### zyyzyykk/kkterminal:3.2.2：latest
- TCode支持 会话级/本地级 变量的存取
- 文本编辑器新增TCode原生对象 `kkTerminal` 的智能提示
- 文件管理模块快捷键适配MacOS
##### zyyzyykk/kkterminal:3.2.0：
- 文件管理模块支持快捷键操作：多选/全选、复制粘贴、剪切等
- 支持文件夹下载
- 重构部分逻辑，优化显示
##### zyyzyykk/kkterminal:3.1.7：
- 适配默认字体、优化TCode状态显示
- 支持本地PC端部署，自动打开浏览器窗口
##### [历史更新记录](./UPDATE.md)
### 🧬 架构
```markdown
+---------+ http +-------------+ ssh +---------------+
| browser | <===========> | kk Terminal | <========> | remote server |
+---------+ websocket +-------------+ sftp +---------------+
Vue + Xterm SpringBoot + SSHJ Linux OS
```
### 🏘️ 关于此项目
作者：[zyyzyykk](https://github.com/zyyzyykk/)
欢迎对此项目提出宝贵的意见或建议，也可以加入我们一起进行此项目的维护与开发