Skip to content

Commit

Permalink
3.3.3
Browse files Browse the repository at this point in the history
  • Loading branch information
zyyzyykk committed Nov 4, 2024
1 parent f6e065e commit 3974bb0
Show file tree
Hide file tree
Showing 29 changed files with 281 additions and 122 deletions.
10 changes: 0 additions & 10 deletions EN/MODULE.md

This file was deleted.

119 changes: 59 additions & 60 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,19 @@
# kkTerminal

> kkTerminal,一个web终端实现ssh远程连接服务器
> kkTerminal, a web terminal for SSH remote server connection
>
> kkTerminal, a web terminal for SSH remote server connection.
> Author: [zyyzyykk](https://github.com/zyyzyykk/)
>
> 作者:[zyyzyykk](https://github.com/zyyzyykk/)
> Source Code: https://github.com/zyyzyykk/kkTerminal
>
> 源代码:https://github.com/zyyzyykk/kkTerminal
> Docker Hub Address: https://hub.docker.com/repository/docker/zyyzyykk/kkterminal/general
>
> docker仓库地址:https://hub.docker.com/repository/docker/zyyzyykk/kkterminal/general
> Preview: https://ssh.kkbpro.com/ (For domestic servers) or https://ssh.kkbapps.com/ (For foreign servers)
>
> 预览:https://ssh.kkbpro.com/ (国内服务器访问) 或 https://ssh.kkbapps.com/ (国外服务器访问)
>
> 更新时间:2024-10-14
> Update Time: 2024-11-04
>
<p align="center"><a href="https://ssh.kkbpro.com/" target="_blank" rel="noopener noreferrer"><img width="100" src="./img/kkTerminal.png" alt="kkterminal"></a></p>
<p align="center"><a href="https://ssh.kkbpro.com/" target="_blank" rel="noopener noreferrer"><img width="100" src="http://img.kkbapps.com/logo/terminal.png" alt="kkTerminal"></a></p>

<p align="center">
<a href="https://hub.docker.com/repository/docker/zyyzyykk/kkterminal/general"><img src="https://img.shields.io/docker/pulls/zyyzyykk/kkterminal?logo=docker" alt="Docker Image"></a>
Expand All @@ -25,112 +23,113 @@
<a href="https://www.apache.org/licenses/"><img src="https://img.shields.io/badge/licence-Apache-red?logo=apache&logoColor=%23D22128" alt="Apache Licence"></a>
<a href="https://github.com/zyyzyykk/kkTerminal"><img src="https://img.shields.io/github/stars/zyyzyykk/kkterminal" alt="GitHub"></a>
</p>
<p align="center">简体中文 | <a href="./README-EN.md" >English</a></p>
<p align="center">English | <a href="./doc/zh_CN/README.md" >简体中文</a></p>

### **** 快速集成
### ⚡ Quick integration

在html网页中使用 `iframe` 标签实现快速集成:
Using the `iframe` tag in HTML web pages to quick integration:

```html
<iframe src="https://ssh.kkbpro.com/" height="400px" width="600px" ></iframe>
```

### 💪 使用docker部署
### 💪 Deploy with Docker

1.拉取镜像:
1.Pull image:

```bash
docker pull zyyzyykk/kkterminal
```

2.创建并运行容器,进行端口映射:`-p 端口号:3000`
2.Create and run a container for port mapping: `-p port:3000`

```bash
docker run -d --name kkterminal -p 3000:3000 zyyzyykk/kkterminal
```

3.挂载数据卷:`-v 数据卷路径:/data`
3.Mount data volume: `-v path:/data`

```bash
docker run -d --name kkterminal -p 3000:3000 -v /data:/data zyyzyykk/kkterminal
```

4.自定义艺术字:`-e TITLE="自定义艺术字"`
4.Custom art word: `-e TITLE="ArtWord"`

```bash
docker run -d --name kkterminal -p 3000:3000 -e TITLE="kkbpro" zyyzyykk/kkterminal
```

5.在浏览器中访问:`http://服务器ip:3000/`
5.Accessing in browser: `http://server-ip:3000/`

### 🛸 预览
### 🛸 Preview

访问以下网址:
Visit the following website:

- 🌐 国内服务器访问:https://ssh.kkbpro.com/
- 🌍 国外服务器访问:https://ssh.kkbapps.com/
- 🌐 For domestic servers: https://ssh.kkbpro.com/
- 🌍 For foreign servers: https://ssh.kkbapps.com/

![Connect](./img/Connect.png)
![Connect](http://img.kkbapps.com/terminal/Connect-3.3.3.png)

![Preference](./img/Preference.png)
![Preference](http://img.kkbapps.com/terminal/Preference-3.3.3.png)

![File](./img/File.png)
![File](http://img.kkbapps.com/terminal/File-3.3.3.png)

![Editor](./img/Editor.png)
![Editor](http://img.kkbapps.com/terminal/Editor-3.3.3.png)

[**更多模块预览**](./ZH/MODULE.md)
[**More Module Previews**](./doc/en_US/MODULE.md)

### 💡 功能说明
### 💡 Function Description

1.kkTerminal是一个web端ssh远程连接服务器的工具,点击左上角的终端图标,选择连接设置进行ssh连接
1.kkTerminal is a web-based SSH remote connection tool for servers. Click on the terminal icon in the upper left corner and select the connection settings to establish an SSH connection

2.支持在网页中使用 `iframe` 标签引入,可快速集成到第三方网站中
2.Support the use of `iframe` tags in web pages for quick integration into third-party websites

3.支持本地PC端部署,启动时会自动打开浏览器窗口
3.Supports local PC deployment, automatically opens browser window upon startup

4.支持窗口大小自适应,支持中文输入
4.Support adaptive window size and Chinese input

5.支持自定义偏好设置,可选择终端的背/前景色、字体字号、光标显示样式、启用TCode
5.Support custom preference settings, allowing users to choose the background/foreground color, font size, cursor display style and enable TCode for the terminal

6.支持重启:当修改ssh连接设置或自定义偏好设置后会自动重启,也可在ssh连接断开后手动进行重启
6.Support restart: It will automatically restart after modifying SSH connection settings or custom preference settings, or can be manually restarted after SSH connection is disconnected

7.支持复制粘贴:
7.Support copy and paste:

- 复制同 `git` 终端,选中文本会自动进行复制
- 粘贴同 `cmd` 终端,单击鼠标右键进行粘贴(需要浏览器打开权限)
- Copy: Same as `Git` terminal, selecting text will automatically copy it
- Paste: Same as `Cmd` terminal, right-click to paste (requires browser access permission)

8.支持文件管理,打开文件管理模块进行文件/文件夹的查看、上传与下载
8.Support file management, open the File Management Module to view, decompress, upload and download files/folders

9.支持文件多选/全选、复制粘贴、剪切等快捷键操作
9.Support shortcut key operations such as multiple/all file selection, copy and paste and cut

10.支持文件的浏览与编辑,修改文件后使用 `ctrl+s` 保存至远程服务器
10.Support file browsing and editing, modify the file and save it to a remote server using `ctrl+s`

11.支持 [TCode (终端代码)](./ZH/TCODE.md)能够通过自定义TCode实现类似Shell脚本的自动化Workflow
11.Support [TCode (Terminal Code)](./doc/en_US/TCODE.md)which can achieve automated Workflow similar to Shell scripts through Customized TCode

### 👨‍💻 更新记录
### 👨‍💻 Update Records

##### zyyzyykk/kkterminal:3.2.9:latest
##### zyyzyykk/kkterminal:3.3.3: latest

- 新增文件URL上传功能
- 修复了取消文件夹下载导致连接断开的bug
- 优化页面显示与代码逻辑,优化打包体积
- Add compressed file decompression function
- Fixed the bug of file loss caused by folder drag upload
- Added preview for browser native supported format files
- Optimize the interface display of File Management Module

##### zyyzyykk/kkterminal:3.2.6:
##### zyyzyykk/kkterminal:3.2.9:

- 修复文件特殊字符操作问题的bug
- 优化文件上传与下载
- 文件属性模块:文件夹新增包含属性、文件大小属性实时刷新
- 优化显示逻辑,规范编码
- Add file URL upload
- Fixed bug where canceling folder downloads caused disconnection
- Optimize page display and code logic, optimize packaging volume

##### zyyzyykk/kkterminal:3.2.2:
##### zyyzyykk/kkterminal:3.2.6:

- TCode支持会话级/本地级变量的存取
- 文本编辑器新增TCode原生对象 `kkTerminal` 的智能提示
- 文件管理模块快捷键适配MacOS
- Fix bugs related to special character operations in files
- Optimize file upload and download
- File Attribute Module: Folder addition includes attributes, file size attributes, and real-time refresh
- Optimize display logic and standardize coding

[**历史更新记录**](./ZH/UPDATE.md)
[**History Update Records**](./doc/en_US/UPDATE.md)

### 🧬 架构
### 🧬 Architecture

```markdown
+---------+ http +-------------+ ssh +---------------+
Expand All @@ -139,8 +138,8 @@ docker run -d --name kkterminal -p 3000:3000 -e TITLE="kkbpro" zyyzyykk/kktermin
Vue + Xterm SpringBoot + SSHJ Linux OS
```

### 🏘️ 关于此项目
### 🏘️ About this project

作者:[zyyzyykk](https://github.com/zyyzyykk/)
Author: [zyyzyykk](https://github.com/zyyzyykk/)

欢迎对此项目提出宝贵的意见或建议,也可以加入我们一起进行此项目的维护与开发
Welcome to provide valuable opinions or suggestions on this project, and you can also join us in maintaining and developing this project together
10 changes: 0 additions & 10 deletions ZH/MODULE.md

This file was deleted.

2 changes: 1 addition & 1 deletion backend/terminal/src/main/resources/application.properties
Original file line number Diff line number Diff line change
Expand Up @@ -16,4 +16,4 @@ spring.servlet.multipart.max-file-size=20MB
spring.servlet.multipart.max-request-size=100MB

# PC端启用窗口
kk.pc.window=false
kk.pc.window=true

This file was deleted.

Loading

0 comments on commit 3974bb0

Please sign in to comment.