认识 Felis

基于 Kubernetes 的 Minecraft 服务器托管平台。

单条命令完成部署，自动管理服务器生命周期、备份与安全。

注意

此项目仍处于早期开发阶段，您不该在任何生产环境使用该项目。若产生任何问题，贵用户的使用行为与 FelisMC 团队无任何民事刑事法律关系。

特性

• 按需启停：玩家连接代理时自动启动目标服务器，启动期间玩家进入等待队列，服务器就绪后自动传送；服务器空闲后自动停止，释放内存。

• Web 控制面板：在浏览器中查看服务器状态、在线玩家与资源用量。

  • 控制台（RCON）、白名单、封禁、OP 与 LuckPerms 权限管理
  • 文件管理：新建、删除、重命名、分片上传、下载，以及停服状态下解压 zip，可用于导入世界
  • 计划任务：按星期与时区定时执行命令、重启、停止、启动或备份，执行前在游戏内向玩家发送提醒

• 备份与恢复：默认启用，归档 PVC 及其路径由安装器生成。

  • 手动备份：将服务器的完整数据卷（/data，含世界、配置、插件与模组）归档至集群内的归档存储，可回滚至任一备份点
  • 每日恢复点：当天有玩家进入过的服务器在停止后自动生成恢复点，默认保留 7 个，保存期限 90 天；恢复点单独轮换，不影响手动备份
  • 下载与导出：支持下载单个备份（附 sha256 校验）、删除单个备份及导出完整世界
  • 异地副本（可选）：备份在主机上加密后同步至 S3 兼容存储（AWS S3、Cloudflare R2、Backblaze B2、MinIO 等）
  • 控制面数据库：存放账号、服务器归属、配额与存档索引的数据库每日自动备份，每次升级迁移前额外创建快照，故障时可通过 felis db restore 整库原子回滚；面板「维护与备份」页显示最近一次备份的时效（参见 故障排查 §16）

• 运维诊断

  • sudo felis status：汇总显示节点、控制面、游戏代理、各服务器、备份及未解决的告警
  • sudo felis doctor：执行全部健康检查，按模块列出问题及排查方向，执行过程中不发送邮件
  • sudo felis support-bundle：生成已脱敏的诊断包，供提交问题时附带（参见 故障排查 §0）
  • 看门狗：每 2 分钟执行一次巡检，异常持续时向平台所有者发送邮件告警，支持外部心跳监测

• 世界回收（可选）：超过 15 天无人游玩的世界在备份后删除，以释放磁盘空间。安装时设置 FELIS_WORLDS_HOST_PATH（k3s 默认为 /var/lib/rancher/k3s/storage）即启用每日回收；未设置时不删除任何世界。过期备份的每日清理与此设置无关，始终执行。

• 多核心支持：兼容 Paper、Fabric、Forge 与 NeoForge，统一经由 Velocity 代理接入。

• 模组包投稿：玩家可上传模组包，经服主审批后自动构建并通过 Trivy 安全扫描；构建产物加入镜像白名单后，可直接选作服务器镜像。

• 安全

  • Passkey 登录：支持指纹、面容识别及硬件密钥等无密码认证方式
  • 零信任访问：面板流量经 Cloudflare Access 保护，集群内部 API 不对公网开放

• 多机部署（实验性，默认关闭）：由一台主控节点统一下发指令，其余节点仅运行游戏服务器，已停止的服务器可迁移至其他节点。该功能目前仅位于 main 分支，尚未完成三机验收（参见 多机部署）。

阅读文档

• 安装与部署
• 运维手册
• 故障排查
• 多机部署
• 贡献指南
• 项目说明

致谢

• Kubernetes：容器编排引擎
• K3s：轻量级 Kubernetes 发行版
• Cloudflare Zero Trust：零信任安全基础设施
• PostgreSQL：数据持久化
• React：前端用户界面框架
• Vite：前端构建工具
• TailwindCSS：CSS 框架
• Bubble Tea：TUI 框架
• Minecraft：本项目服务的游戏

---

原文：README.md。