【BubbleSharkPanel】自托管的游戏服务器管理面板开源项目Vibe Coding

本项目 BubbleSharkPanel 是一个自托管的游戏服务器管理面板，当前完整适配《饥荒联机版》（DST），让服主通过浏览器完成开服、配置和日常维护。
面向游戏服务器的部署与运维。
主要用户是拥有 Linux 服务器的个人服主，以及需要多人共同维护服务器的小型游戏社区。
典型场景包括：为朋友搭建长期运行的联机服务器；管理多个独立游戏实例；安排管理员分别负责玩家、Mod 和备份；将其他面板或裸机上的存档迁入继续使用。
它解决的具体问题是：开服需要安装游戏服务端、修改配置文件、分配端口和启动进程，后续还要处理更新、Mod、玩家管理与存档恢复。项目将这些操作集中到可视化界面中。

实例管理 创建实例，安装与更新 DST，启动、停止及查看运行状态，支持单机多实例
世界配置 配置房间与世界参数，管理地上、洞穴分片及现有存档
Mod 管理 搜索、订阅、启停创意工坊 Mod，配置 Mod 参数，支持单 Mod ZIP 导入
玩家管理 管理管理员、白名单、黑名单，查看在线玩家并执行踢出、封禁
控制台 实时查看游戏日志，向游戏下发命令
备份恢复 定时备份、重要操作前自动备份、恢复存档、导入外部存档及面板数据库快照
多人协作 独立成员账号、角色权限、实例授权和操作审计
运维监控 查看资源状态，执行环境自检，配置计划任务与通知

采用前后端分离、业务模块划分和双运行时适配。
技术栈方面，前端使用 Vue 3、TypeScript、Vite，配合 Pinia 管理状态、Vue Router 管理页面；后端使用 Node.js、TypeScript 和 Fastify；数据库使用 SQLite，通过 Drizzle ORM 定义数据结构和生成迁移。
代码组织方面，后端按认证、实例、世界、分片、Mod、玩家、备份、计划任务等业务拆分模块。应用服务负责组织操作，基础设施适配层负责访问 Docker、systemd、SteamCMD 和文件系统。前后端共用 shared/contracts 中的类型与 Zod 校验规则，保持接口字段和参数约束一致。
运行方式方面，项目通过统一运行时接口支持两种部署：Docker 模式管理游戏容器；Native 模式通过 systemd 管理游戏进程。上层业务复用启动、停止、状态查询、日志读取等接口，底层根据配置选择具体实现。
关键流程方面，游戏安装与更新由 SteamCMD 执行，后端维护任务状态、日志、取消与重试；DST 适配代码负责生成和维护房间、世界、分片及 Mod 配置；控制台通过 SSE 持续向浏览器推送日志。