diff --git a/README-easyshell.md b/README-easyshell.md new file mode 100644 index 0000000..c81934f --- /dev/null +++ b/README-easyshell.md @@ -0,0 +1,339 @@ +

+ EasyShell Logo +

+ +

EasyShell

+ +

+ 🚀 赛博朋克风格的跨平台远程 Shell 管理终端 +

+ +

+ Stars + Version + Electron + React + Capacitor +

+ +

+ 支持 Windows · macOS · Linux · Android 多平台运行 +

+ +

+ GitHub · + 下载 · + 反馈问题 +

+ +--- + +## 📸 界面预览 + +### 🏠 欢迎界面 + +精心设计的赛博朋克风格欢迎界面,霓虹光效与深色主题完美融合。 + +![欢迎界面](docs/1.png) + +### ➕ 添加主机 + +便捷的主机配置面板,支持密码和 SSH 私钥两种认证方式,可自定义分组和标识颜色。 + +![添加主机](docs/2.png) + +### 💻 SSH 终端 + +功能完整的 SSH 终端,基于 xterm.js 打造,支持完整的终端模拟体验。 + +![SSH终端](docs/4.png) + +### 📁 SFTP 文件管理器 + +强大的 SFTP 文件管理功能,支持文件浏览、上传、下载、重命名、删除等操作。 + +![SFTP文件管理器](docs/5.png) + +### 📊 主机信息面板 + +实时监控远程主机状态,包括 CPU、内存、磁盘使用情况和系统运行时间。 + +![主机信息面板](docs/6.png) + +### ⌨️ 快捷命令面板 + +内置常用命令快捷面板,按 `Ctrl + K` 快速调出,支持 Docker、文件操作等常用命令。 + +![快捷命令](docs/7.png) + +### 🗂️ 主机管理 + +集中管理所有 SSH 主机,支持分组、搜索、批量操作。 + +![主机管理](docs/8.png) + +### ☁️ 云端同步 + +支持 MySQL 数据库云端同步,实现多设备主机配置共享。 + +![云端同步](docs/3.png) + +--- + +## ✨ 功能特点 + +| 功能 | 描述 | +|------|------| +| 🎨 **赛博朋克 UI** | 霓虹色调、玻璃拟态、动态光效,打造独特视觉体验 | +| 🖥️ **SSH 终端** | 完整的 xterm.js 终端模拟,支持各种终端操作 | +| 📁 **SFTP 文件管理** | 远程文件浏览、上传、下载、权限修改 | +| 📊 **主机监控** | 实时 CPU、内存、磁盘使用率监控 | +| ⌨️ **快捷命令** | 内置常用命令,Ctrl+K 快速调出 | +| ☁️ **云端同步** | MySQL 数据库同步,多设备配置共享 | +| 🏷️ **分组管理** | 主机分组、颜色标识、便捷管理 | +| 📱 **跨平台** | 桌面端和移动端统一体验 | + +--- + +## 🏗️ 项目结构 + +``` +easyshell/ +├── src/ # React 前端源码 +│ ├── components/ # UI 组件 +│ │ ├── Terminal.js # SSH 终端组件 +│ │ ├── SFTPBrowser.js # SFTP 文件管理器 +│ │ ├── HostInfoPanel.js # 主机信息面板 +│ │ ├── HostManager.js # 主机管理器 +│ │ ├── Sidebar.js # 侧边栏 +│ │ └── TitleBar.js # 标题栏 +│ ├── services/ # 服务层 +│ │ ├── api.js # 跨平台 API 适配层 +│ │ ├── database.js # 数据库服务 (SQLite/MySQL) +│ │ ├── ssh.js # SSH 服务 +│ │ └── sftp.js # SFTP 服务 +│ └── App.js # 主应用组件 +├── server/ # 后端服务器 (移动端需要) +│ ├── index.js # Express + Socket.IO 服务 +│ └── package.json +├── android/ # Android 原生项目 (Capacitor) +├── public/ # 静态资源 +│ ├── icon.svg # 应用图标 (SVG) +│ ├── icon.png # 应用图标 (PNG) +│ └── icon.ico # 应用图标 (Windows) +├── docs/ # 文档和截图 +├── main.js # Electron 主进程 +├── preload.js # Electron 预加载脚本 +├── capacitor.config.ts # Capacitor 配置 +└── tailwind.config.js # Tailwind CSS 配置 +``` + +--- + +## 🚀 快速开始 + +### 环境要求 + +- Node.js >= 16 +- npm >= 8 +- (可选) Android Studio (构建 Android 版本) + +### 安装依赖 + +```bash +# 克隆项目 +git clone https://github.com/ethanfly/easyshell.git +cd easyshell + +# 安装前端依赖 +npm install + +# 安装服务器依赖 (如需移动端) +cd server && npm install && cd .. +``` + +### 桌面端开发 + +```bash +# 启动开发模式 (React + Electron) +npm start +``` + +### 构建发布版 + +```bash +# 构建 Windows 安装包 +npm run dist + +# 生成的安装包位于 dist/ 目录 +``` + +--- + +## 📱 移动端部署 + +### 1. 启动后端服务器 + +移动端需要通过后端服务器代理 SSH 连接: + +```bash +# 启动服务器 +npm run server + +# 或开发模式 (自动重启) +npm run server:dev +``` + +服务器将在 `http://0.0.0.0:3001` 启动。 + +### 2. 构建 Android 应用 + +```bash +# 首次使用需要添加 Android 平台 +npm run cap:add:android + +# 构建并打开 Android Studio +npm run android + +# 或直接运行到设备 +npm run android:run +``` + +### 3. 手机配置 + +1. 确保手机和电脑在同一局域网 +2. 打开 EasyShell 应用 +3. 进入设置配置服务器地址 +4. 输入电脑 IP,如 `http://192.168.1.100:3001` +5. 测试连接成功后即可使用 + +--- + +## ⌨️ 快捷键 + +| 快捷键 | 功能 | +|--------|------| +| `Ctrl + K` | 打开命令面板 | +| `Ctrl + F` | SFTP 搜索文件 | +| `Enter` | 执行选中命令 | +| `Esc` | 关闭面板/弹窗 | + +--- + +## 🔧 配置说明 + +### 数据存储 + +- **桌面端**: 使用 `electron-store` + SQLite 本地存储 +- **移动端**: 使用 `localStorage` 存储配置 + +### 云端同步 + +支持 MySQL 数据库同步,配置步骤: + +1. 点击设置按钮 +2. 切换到「数据库同步」标签 +3. 填写 MySQL 连接信息 +4. 点击「连接数据库」 + +数据库不存在时会自动创建。 + +--- + +## 🛡️ 安全说明 + +- SSH 密码和私钥加密存储在本地 +- 移动端通过 WebSocket 与后端服务器通信 +- 建议在受信任的网络环境中使用 +- 生产环境建议配置 HTTPS/WSS + +--- + +## 🤝 技术栈 + + + + + + + + + + + + + + +
+ +**前端** + + + +**桌面端** + + + +**移动端** + + + +**后端** + +
+ +React 18
+Tailwind CSS
+Framer Motion
+xterm.js + +
+ +Electron 28
+electron-store
+ssh2
+sql.js + +
+ +Capacitor 5
+Socket.IO Client
+Android Studio + +
+ +Express
+Socket.IO
+ssh2
+mysql2 + +
+ +--- + +## 📦 脚本命令 + +```bash +npm start # 启动开发模式 +npm run build # 构建 React 应用 +npm run dist # 打包桌面应用 +npm run icons # 生成应用图标 +npm run server # 启动后端服务器 +npm run android # 构建并打开 Android Studio +``` + +--- + +## 📄 许可证 + +[MIT License](LICENSE) + +--- + +

+ Made with ❤️ and ⚡ by EasyShell Team +

+ +

+ © 2024 EasyShell - Cyberpunk Edition +

diff --git a/docs-easyshell/1.png b/docs-easyshell/1.png new file mode 100644 index 0000000..e7a7c04 Binary files /dev/null and b/docs-easyshell/1.png differ diff --git a/docs-easyshell/2.png b/docs-easyshell/2.png new file mode 100644 index 0000000..bf2f7c2 Binary files /dev/null and b/docs-easyshell/2.png differ diff --git a/docs-easyshell/3.png b/docs-easyshell/3.png new file mode 100644 index 0000000..8ff50d1 Binary files /dev/null and b/docs-easyshell/3.png differ diff --git a/docs-easyshell/4.png b/docs-easyshell/4.png new file mode 100644 index 0000000..8280d5e Binary files /dev/null and b/docs-easyshell/4.png differ diff --git a/docs-easyshell/5.png b/docs-easyshell/5.png new file mode 100644 index 0000000..f2cfca3 Binary files /dev/null and b/docs-easyshell/5.png differ diff --git a/docs-easyshell/6.png b/docs-easyshell/6.png new file mode 100644 index 0000000..609ab7c Binary files /dev/null and b/docs-easyshell/6.png differ diff --git a/docs-easyshell/7.png b/docs-easyshell/7.png new file mode 100644 index 0000000..57656ab Binary files /dev/null and b/docs-easyshell/7.png differ diff --git a/docs-easyshell/8.png b/docs-easyshell/8.png new file mode 100644 index 0000000..77ed5c5 Binary files /dev/null and b/docs-easyshell/8.png differ diff --git a/docs/.gitkeep b/docs-phper/.gitkeep similarity index 100% rename from docs/.gitkeep rename to docs-phper/.gitkeep diff --git a/docs/dashboard.png b/docs-phper/dashboard.png similarity index 100% rename from docs/dashboard.png rename to docs-phper/dashboard.png diff --git a/docs/mysql.png b/docs-phper/mysql.png similarity index 100% rename from docs/mysql.png rename to docs-phper/mysql.png diff --git a/docs/nginx.png b/docs-phper/nginx.png similarity index 100% rename from docs/nginx.png rename to docs-phper/nginx.png diff --git a/docs/nodejs.png b/docs-phper/nodejs.png similarity index 100% rename from docs/nodejs.png rename to docs-phper/nodejs.png diff --git a/docs/php.png b/docs-phper/php.png similarity index 100% rename from docs/php.png rename to docs-phper/php.png diff --git a/docs/python.png b/docs-phper/python.png similarity index 100% rename from docs/python.png rename to docs-phper/python.png diff --git a/docs/redis.png b/docs-phper/redis.png similarity index 100% rename from docs/redis.png rename to docs-phper/redis.png diff --git a/docs/setting.png b/docs-phper/setting.png similarity index 100% rename from docs/setting.png rename to docs-phper/setting.png diff --git a/easyshell.html b/easyshell.html new file mode 100644 index 0000000..20ef7ff --- /dev/null +++ b/easyshell.html @@ -0,0 +1,331 @@ + + + + + + + EasyShell - 赛博朋克风格跨平台远程 Shell 管理终端 + + + + + + + + + + + +
+
+
+
+
+
+
+
+ + + + + +
+
+
+
+ + 跨平台 · 开源免费 +
+

+ + EasyShell +

+

赛博朋克风格的跨平台远程 Shell 管理终端

+

+ 支持 Windows · + macOS · + Linux · + Android 多平台运行 +

+ +
+
+ 4 + 支持平台 +
+
+
+ SSH + 安全连接 +
+
+
+ ☁️ + 云端同步 +
+
+
+
+
+ + +
+
+
+ +

霓虹光效与深色主题完美融合

+

精心设计的赛博朋克风格界面,独特视觉体验

+
+
+ + + + + + + + +
+
+
+
+
+ +
+ EasyShell +
+
+ 欢迎界面 + 添加主机 + 云端同步 + SSH终端 + SFTP文件管理器 + 主机信息面板 + 快捷命令 + 主机管理 +
+
+
+
+
+ + +
+
+
+ +

强大功能
一应俱全

+

为远程服务器管理而生的专业工具

+
+
+
+
🎨
+

赛博朋克 UI

+

霓虹色调、玻璃拟态、动态光效,打造独特视觉体验

+
+
+
🖥️
+

SSH 终端

+

完整的 xterm.js 终端模拟,支持各种终端操作

+
+
+
📁
+

SFTP 文件管理

+

远程文件浏览、上传、下载、权限修改

+
+
+
📊
+

主机监控

+

实时 CPU、内存、磁盘使用率监控

+
+
+
⌨️
+

快捷命令

+

内置常用命令,Ctrl+K 快速调出

+
+
+
☁️
+

云端同步

+

MySQL 数据库同步,多设备配置共享

+
+
+
🏷️
+

分组管理

+

主机分组、颜色标识、便捷管理

+
+
+
📱
+

跨平台

+

桌面端和移动端统一体验

+
+
+
+
+ + +
+
+
+ +

键盘快捷操作

+
+
+
+ Ctrl + K + 打开命令面板 +
+
+ Ctrl + F + SFTP 搜索文件 +
+
+ Enter + 执行选中命令 +
+
+ Esc + 关闭面板/弹窗 +
+
+
+
+ + +
+
+
+ +

随时随地管理服务器

+
+
+
+
🪟
+

Windows

+

Electron 原生应用

+
+
+
🍎
+

macOS

+

Electron 原生应用

+
+
+
🐧
+

Linux

+

Electron 原生应用

+
+
+
📱
+

Android

+

Capacitor 移动端

+
+
+
+
+ + +
+
+
+

🛠️ 技术栈

+
+ React 18 + Tailwind CSS + Electron 28 + Capacitor 5 + xterm.js + ssh2 + Socket.IO +
+
+
+
+ + +
+
+
+

准备好连接你的服务器了吗?

+

下载 EasyShell,开启赛博朋克式的远程管理体验

+ +
+
+
+ + + + + + + + + diff --git a/index.html b/index.html index 188304c..9605fcd 100644 --- a/index.html +++ b/index.html @@ -4,40 +4,39 @@ - PHPer - Windows PHP 开发环境管理器 - - + 开发者工具集 - PHPer & EasyShell + + - +
-
-
-
-
+
+
+
+