# WebGoXterm

**Repository Path**: futurelei/web-go-xterm

## Basic Information

- **Project Name**: WebGoXterm
- **Description**: 基于go语言实现的xterm网页端应用，实现ssh、串口等会话连接。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-08
- **Last Updated**: 2026-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# WebGoXterm

**单文件 Web SSH / 串口 终端工具 · MobaXterm 风格 · 纯 Go · 零依赖**

[![Go Version](https://img.shields.io/badge/Go-1.18%2B-00ADD8?logo=go&logoColor=white)](https://go.dev)
[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![CGO](https://img.shields.io/badge/CGO-disabled-lightgrey.svg)](#)
[![Platform](https://img.shields.io/badge/Platform-Linux%20%7C%20Windows-6C63FF.svg)](#)
[![Arch](https://img.shields.io/badge/Arch-amd64%20%7C%20arm64-3ECFCF.svg)](#)
[![Offline](https://img.shields.io/badge/Offline-Fully%20self--contained-2ecc71.svg)](#)
[![Release](https://img.shields.io/badge/Release-v0.4.3-FF6584.svg)](https://github.com/)

**[:us: English](docs/README.en-US.md) · [:cn: 简体中文](docs/README.zh-CN.md)**

*一个可执行文件即完整应用 —— 后端 Go + 内嵌前端, 无 CGO, 本地 sqlite3, 离线可用*

</div>

---

## ✨ 特性速览

| 分类 | 能力 |
| --- | --- |
| 终端 | 多标签 SSH/串口/Telnet/VNC/RDP 远程桌面、双认证、TOFU 指纹、跳板机、断线自动重连、TCP 预检、命令拦截（危险指令 warn/block）、分屏布局（竖向/横向嵌套+拖动比例） |
| 文件 | SFTP 树形浏览、拖拽/批量传输、**内嵌编辑器**（Ace 语法高亮+补全）、图片/视频/PDF 预览、**压缩包查看器**（tar/zip 层级浏览）+ 解压/压缩、GBK 文件名兼容 |
| 监控 | 资源看板（CPU/内存/网络 sparkline/磁盘/Top）、状态栏阈值变色、tail -F 日志、桌面通知 |
| 效率 | 快捷命令（组合键/占位符）、批量广播、端口转发（本地/SOCKS5）、会话管理（搜索/分页/分组/批量生成/导入导出）、工具面板（端口扫描/IP/抓包/网络配置+Docker 管理） |
| AI | 气泡助手、接管终端、深度思考、OpenAI 兼容多厂家、本地路由模糊匹配、token 统计 |
| 体验 | 浅色/深色/跟随系统主题、中英 i18n、会话刷新恢复、大文件流式加载 |

## 🚀 快速开始

```bash
# 直接运行 (自动打开浏览器 http://127.0.0.1:8092)
./bin/webgoxterm

# 指定端口与数据目录
./bin/webgoxterm -http 127.0.0.1:18080 -data ./data -open=false

# 自行编译 (详见 docs)
./scripts/build.sh --all
```

## 📚 文档

| 文档 | 说明 |
| --- | --- |
| [简体中文](docs/README.zh-CN.md) | 完整中文文档（特性/架构/API/开发/配置/安全） |
| [English](docs/README.en-US.md) | Full English documentation |

## 🏗️ 架构

```
┌──────────────────┐  REST + WebSocket  ┌──────────────┐  SSH/SFTP   ┌──────────┐
│ web/index.html   │ ─────────────────► │  server      │ ──────────► │ 目标主机  │
│ (单文件内嵌前端)  │ ◄───────────────── │  (会话/监控/  │  ProxyJump  │ (Linux)  │
│  xterm + Ace     │   out/st/notify事件│   AI/转发)   │ ──────────► │ 跳板机    │
└──────────────────┘                    └──────┬───────┘             └──────────┘
                                               │ sqlite (modernc, 纯 Go)
                                               ▼
                                        data/webgoxterm.db
```

## 🧱 技术栈

[![Go](https://img.shields.io/badge/-Go-00ADD8?logo=go&logoColor=white)](#) [![x/crypto](https://img.shields.io/badge/-golang.org%2Fx%2Fcrypto-7E57DD?logo=go&logoColor=white)](#) [![pkg/sftp](https://img.shields.io/badge/-pkg%2Fsftp-1B6AC6)](#) [![sqlite](https://img.shields.io/badge/-modernc.org%2Fsqlite-003B57)](#) [![xterm.js](https://img.shields.io/badge/-xterm.js-F37626?logo=javascript&logoColor=white)](#) [![Ace](https://img.shields.io/badge/-Ace%20Editor-61259E)](#) [![lucide](https://img.shields.io/badge/-lucide%20icons-5E81AC)](#)

## 🤝 贡献

欢迎提交 Issue / PR。开发规范见 [docs/README.zh-CN.md#开发](docs/README.zh-CN.md#-开发)。

## 📄 许可证

[MIT](LICENSE) © WebGoXterm contributors