| # WebShell - Hugging Face Spaces版本 | |
| 这是一个基于Flask和WebSocket的Web终端和文件管理系统，专为Hugging Face Spaces部署优化。 | |
| ## 功能特性 | |
| ### 🗂️ 文件管理 | |
| - 📁 文件/文件夹浏览、创建、删除、重命名 | |
| - 📤 文件上传下载 | |
| - ✏️ 在线代码编辑器（支持语法高亮） | |
| - 👀 文件预览功能 | |
| ### 💻 终端模拟器 | |
| - 🖥️ 实时终端交互（基于WebSocket） | |
| - 🐧 支持Linux bash命令 | |
| - 📜 命令历史记录（↑↓键浏览） | |
| - 🔄 多终端会话支持 | |
| ### 🛡️ 安全特性 | |
| - 🔒 路径遍历攻击防护 | |
| - 📁 访问权限限制在应用目录内 | |
| - 🚫 恶意命令执行防护 | |
| ## 技术栈 | |
| **后端：** | |
| - Flask + Flask-SocketIO | |
| - Python subprocess | |
| - 多线程处理 | |
| **前端：** | |
| - Bootstrap 5 响应式设计 | |
| - CodeMirror 代码编辑器 | |
| - Socket.IO 实时通信 | |
| - Font Awesome 图标 | |
| ## 部署说明 | |
| 这个版本已经针对Hugging Face Spaces进行了优化： | |
| 1. **端口配置**：使用环境变量 `PORT`（默认7860） | |
| 2. **Linux兼容**：支持Linux bash终端 | |
| 3. **Docker化**：包含完整的Dockerfile | |
| 4. **依赖管理**：requirements.txt包含所有必需的包 | |
| ## 环境变量 | |
| - `PORT`: 服务端口（默认7860） | |
| - `HOST`: 服务主机（默认0.0.0.0） | |
| - `DEBUG`: 调试模式（默认False） | |
| ## 使用方法 | |
| 部署到Hugging Face Spaces后，访问以下功能： | |
| 1. **主页**：`/` - 功能选择页面 | |
| 2. **文件管理**：`/files` - 文件浏览和编辑 | |
| 3. **终端**：`/terminal` - 命令行界面 | |
| ## 安全提醒 | |
| ⚠️ **重要安全提醒**： | |
| - 此工具仅用于开发和学习目的 | |
| - 请勿在生产环境中暴露于公网 | |
| - 定期检查和更新依赖包 | |
| - 谨慎使用终端功能 | |
| ## 许可证 | |
| MIT License | |
| --- | |
| **注意**：本项目仅供学习和开发使用，请遵守相关法律法规和平台使用条款。 |