Ethanfly c0fe5b3321 Implement SFTP functionality and enhance UI/UX

- Added SFTP file management capabilities including list, upload, download, delete, and directory operations.
- Integrated SFTP progress callbacks to provide real-time feedback during file transfers.
- Updated the UI to include a dedicated SFTP browser and host information panel.
- Enhanced the sidebar and title bar with improved styling and animations for a cyberpunk theme.
- Refactored host management to support editing and connecting to hosts with a more intuitive interface.
- Updated package dependencies to support new features and improve performance.

2025-12-29 13:50:23 +08:00

3.8 KiB

Raw Blame History

EasyShell 🚀

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

支持 Windows / macOS / Linux / Android 多平台运行。

✨ 功能特点

🎨 赛博朋克 UI - 霓虹色调、玻璃拟态、动态特效
🖥️ SSH 终端 - 完整的 xterm.js 终端模拟
📁 SFTP 文件管理 - 远程文件浏览、上传、下载
📊 主机信息面板 - 实时系统状态监控
☁️ 云端同步 - MySQL 数据库同步支持
📱 跨平台 - 桌面端和移动端统一体验

🏗️ 项目结构

easyshell/
├── src/                    # React 前端源码
│   ├── components/         # UI 组件
│   ├── services/           # 服务层
│   │   ├── api.js          # 跨平台 API 适配层
│   │   ├── database.js     # 数据库服务
│   │   ├── ssh.js          # SSH 服务 (Electron)
│   │   └── sftp.js         # SFTP 服务 (Electron)
│   └── ...
├── server/                 # 后端服务器 (移动端需要)
│   ├── index.js            # Express + Socket.IO 服务
│   └── package.json
├── android/                # Android 原生项目 (Capacitor)
├── main.js                 # Electron 主进程
├── preload.js              # Electron 预加载脚本
└── capacitor.config.ts     # Capacitor 配置

🚀 快速开始

安装依赖

# 安装前端依赖
npm install

# 安装服务器依赖
cd server && npm install && cd ..

桌面端开发

# 启动 Electron 开发模式
npm start

移动端开发

1. 启动后端服务器

# 在电脑上启动服务器
npm run server

# 或开发模式 (自动重启)
npm run server:dev

服务器将在 http://0.0.0.0:3001 启动。

2. 构建并运行安卓应用

# 首次使用需要初始化
npm run cap:add:android

# 构建并打开 Android Studio
npm run android

# 或直接运行到设备
npm run android:run

3. 在手机上配置

确保手机和电脑在同一局域网
打开 EasyShell 应用
点击右上角设置图标
输入电脑 IP 地址，如 http://192.168.1.100:3001
点击测试连接，确认成功后保存

📦 构建发布

桌面端

# Windows
npm run dist

# macOS (需要在 Mac 上构建)
npm run dist

# Linux
npm run dist

安卓端

# 构建 Release APK
npm run build
npx cap sync android
cd android && ./gradlew assembleRelease

APK 位于 android/app/build/outputs/apk/release/

🔧 配置说明

服务器配置

服务器默认端口 3001，可通过环境变量修改：

PORT=8080 npm run server

Capacitor 配置

编辑 capacitor.config.ts 可以修改：

应用 ID
状态栏样式
背景颜色
等等

🛡️ 安全说明

SSH 密码和私钥存储在本地 (桌面端使用 electron-store，移动端使用 localStorage)
移动端通过 WebSocket 与后端服务器通信
建议在受信任的网络环境中使用
生产环境建议配置 HTTPS/WSS

📱 移动端限制

由于浏览器安全限制，移动端有以下差异：

功能	桌面端	移动端
SSH 连接	直连	通过服务器代理
SFTP 上传	✅	⚠️ 需要文件选择器
MySQL 同步	✅	❌ 暂不支持
窗口控制	✅	❌ 不需要

🤝 技术栈

前端:

React 18
Tailwind CSS
Framer Motion
xterm.js

桌面端:

Electron 28
electron-store
ssh2

移动端:

Capacitor 5
Socket.IO

后端:

Express
Socket.IO
ssh2

📄 许可证

MIT License

Made with ❤️ and ⚡ by EasyShell Team

3.8 KiB Raw Blame History Unescape Escape