xiaozhu674/gameservermanager repository overview

⁠📋 项目简介

GameServerManager 3.0（简称GSM3）是一个基于现代化技术栈的游戏服务器管理平台，采用 React + TypeScript + Node.js 架构，专为简化游戏服务器的部署、管理和维护而设计。

⁠🎉 GSM3.0 重大更新

⁠✨ 核心特性

• 🚀 现代化架构 - 基于 React 18 + TypeScript + Node.js 的全栈解决方案
• 🎯 一键部署 - 支持 Steam 平台多款热门游戏的快速部署
• 🌐 Web 管理界面 - 基于 Ant Design 的现代化管理面板，响应式设计
• 🔧 实时终端 - 集成 Xterm.js 的 Web 终端，支持实时命令执行和日志查看
• 📊 资源监控 - 实时监控服务器资源使用情况和游戏实例状态
• 🔐 权限管理 - 基于 JWT 的用户认证和权限控制系统
• 🎮 多游戏支持 - 支持 40+ 款 Steam 游戏服务端，持续更新
• 💾 数据持久化 - 游戏数据和配置文件统一管理，安全可靠
• 🔌 WebSocket 通信 - 实时双向通信，即时状态更新
• 📦 Docker 支持 - 完整的容器化部署方案，一键启动
• 🎨 可视化配置 - 游戏配置文件的图形化编辑界面

⁠本地开发部署

⁠标准部署（x86_64）

# 安装依赖
npm run install:all

# 开发模式运行
npm run dev

# 生产模式构建
npm run package:<windows/linux>

⁠ARM64 架构部署

如果您在 ARM64 架构的系统上开发，或需要在 x86_64 系统上通过 QEMU 模拟 ARM64 环境：

⁠环境准备

# 安装 QEMU 用户模式模拟器
sudo apt-get install qemu-user-static

# 安装 ARM64 交叉编译库
sudo apt-get install libc6-dev-arm64-cross

# 确保 ARM64 Node.js v20.19.0 已安装到指定路径
# /home/xiaozhu/qemu/Node/node-v20.19.0-linux-arm64/

⁠一键启动

# 安装所有依赖并启动双终端开发环境（推荐）
./start-arm64.sh

# 或者仅启动开发环境（假设依赖已安装）
./dev-arm64.sh

# 其他选项
./start-arm64.sh install    # 仅安装依赖
./start-arm64.sh dev-dual   # 双终端模式（推荐）
./start-arm64.sh dev-simple # 后台模式
./start-arm64.sh help       # 显示帮助信息

详细的 ARM64 部署说明请参考 scripts/arm/README.md⁠

⁠🏗️ 技术架构

⁠前端技术栈

• React 18 - 现代化前端框架，支持并发特性
• TypeScript - 类型安全的 JavaScript 超集
• Ant Design 5 - 企业级 UI 组件库
• Zustand - 轻量级状态管理库
• Monaco Editor - VS Code 同款代码编辑器
• Xterm.js - 功能完整的 Web 终端模拟器
• Socket.IO Client - 实时双向通信客户端
• Framer Motion - 流畅的动画库
• Vite - 极速构建工具
• TailwindCSS - 原子化 CSS 框架

⁠后端技术栈

• Node.js 18+ - 高性能 JavaScript 运行时
• TypeScript - 类型安全的服务端开发
• Express.js - 轻量级 Web 框架
• Socket.IO - 实时双向通信服务端
• JWT - JSON Web Token 认证
• Winston - 专业级日志系统
• Multer - 文件上传处理
• Node-cron - 定时任务调度
• Axios - HTTP 客户端
• Joi - 数据验证库

⁠系统集成

• SteamCMD - Steam 命令行工具
• Docker - 容器化部署
• PTY - 伪终端支持（跨平台）
• File System - 统一文件管理系统

⁠📁 项目结构

GSManager3/
├── client/                     # 前端应用
│   ├── src/                   # React + TypeScript 源码
│   │   ├── components/        # 可复用组件
│   │   ├── pages/            # 页面组件
│   │   ├── stores/           # Zustand 状态管理
│   │   ├── types/            # TypeScript 类型定义
│   │   ├── utils/            # 工具函数
│   │   └── config/           # 配置文件
│   ├── public/               # 静态资源
│   └── package.json          # 前端依赖
├── server/                    # 后端服务
│   ├── src/                  # Node.js + TypeScript 源码
│   │   ├── routes/           # API 路由
│   │   ├── modules/          # 功能模块
│   │   │   └── game/         # 游戏管理模块
│   │   ├── middleware/       # 中间件
│   │   ├── utils/            # 工具函数
│   │   └── Python/           # Python 脚本
│   ├── data/                 # 数据存储目录
│   │   ├── games/            # 游戏数据
│   │   ├── lib/              # 运行依赖（PTY、Zip-Tools 等二进制文件）
│   │   └── plugins/          # 插件数据
│   └── package.json          # 后端依赖
├── scripts/                   # 构建脚本
├── docker-compose.yml         # Docker 编排文件
├── Dockerfile                # Docker 镜像构建文件
└── package.json              # 项目根依赖

⁠🤝 贡献流程

⁠贡献者准则

1. 我们不限制您使用AI等辅助工具对代码进行贡献，若您使用AI参与开发请确保您的编辑器已导入项目规则，项目规则在根目录下AGENTS.md文件
2. 不得提交具有后门，入侵操作系统等严重违规违法故意破坏使用者计算机的行为！
3. 请确保您提交的代码清晰标注注释，变量请使用驼峰命名法。
4. 代码逻辑不能采用非常简单粗暴的行为，应当评估代码在正式环境中对系统性能影响程度，始终要把性能消耗降到最低。

⁠📞 支持与反馈

• 🐛 问题反馈：GitHub Issues⁠
• 💬 QQ交流群：1040201322
• 📖 详细文档：GSM3 文档站⁠
• 🌐 官方网站：GSM3 官网⁠
• 💝 赞助支持：爱发电⁠

⁠📄 开源协议

本项目采用 GPL-3.0 license⁠ 开源协议。

⁠👨‍💻 关于作者

此项目由 又菜又爱玩的小朱 独立开发维护。

如果这个项目对你有帮助，请给个 ⭐ Star 支持一下！

⁠🔄 版本说明

• GSM3.0 - 全新架构，基于 React + TypeScript + Node.js
• GSM2.0 - 基于 Python + Flask 的经典版本 查看源码⁠
• GSM1.0 - 游戏容器 查看源码⁠

⁠主要更新

• ✅ 全新的现代化 Web 界面
• ✅ TypeScript 全栈开发，类型安全
• ✅ 实时 WebSocket 通信
• ✅ 游戏配置可视化编辑
• ✅ 更好的性能和稳定性
• ✅ 完整的 Docker 支持
• ✅ 跨平台兼容性

⁠📈 项目统计