已知限制
本页列出 Felis 当前尚未实现或只部分实现的功能,并说明它们对运维人员、管理员和玩家的影响及可行的应对方式。部署或升级之前,请确认这些限制不影响预期用途。
发布状态
Felis 只提供开发快照,没有公开发布的 Release 资产。开发快照仅供开发者在隔离的测试主机上验证,不应用于生产环境。安装开发版需要显式选择 dev 通道,见安装与部署。
安装与升级
- 不支持完全离线安装。 使用
FELIS_ARTIFACT_DIR从预先下载的发布资产安装时,Felis 二进制、镜像和代理插件从该目录读取,但 k3s 及其镜像、JRE、cloudflared、Velocity、Via 插件和系统软件包仍需联网下载。主机需要能通过 HTTPS 访问这些地址,或配置https_proxy。见从预下载资产安装与网络要求。 - PostgreSQL 大版本升级需要手动完成。 发布版把 PostgreSQL 镜像升级到新的大版本时,安装器检测到旧版本的数据目录后停止,不会自动迁移数据;需要先生成数据库备份包,再在新版本上恢复。见PostgreSQL 大版本升级。
控制面
- felis-api 只能以单副本运行。 felis-api 的 Deployment 固定为一个副本,更新时先停止旧 Pod 再启动新 Pod,期间 API 短暂不可用。邮箱验证码的重发冷却、投稿频率限制和每用户上传存储预算都只在单个进程内生效,多个后台任务也在进程内运行;把 felis-api 扩展为多个副本会使这些限制失效、后台任务重复执行,因此不受支持。
- 不自动应用版本更新,也不发送更新通知。
felis-update-check.timer每日检查一次组件版本,结果显示在「维护与备份 → 版本更新」中;Felis 不会通过邮件或游戏内消息通知可用更新,也不会自动安装。应用更新需要在主机上执行sudo felis update --apply,见升级。
多机部署与高可用
多机部署、故障切换和主控高可用属于实验性功能,默认关闭,尚未完成在多台真实主机上的验收。只应在测试主机上启用。具体限制如下:
- 未启用主控高可用时,主控是控制面和公共入口的单点。主控重启期间控制操作暂停,主控上的世界无法故障切换。
- 主控高可用启用后无法在面板中关闭。需要回退时,使用启用过程中保存的数据库备份(标签
pre-migrate)和集群状态快照(pre-ha)手动恢复。 - 面板不提供移除主控的操作。永久下线一台主控时,先确认其余主控仍构成 etcd 多数,再按 k3s 文档移除其 etcd 成员并删除节点。
- 故障切换后,原世界卷保留在失联节点的磁盘上,不会自动清理。
- 多机部署不允许为游戏服务器设置访问私有网络的例外,见主机与网络。
操作步骤见多机部署与高可用。
主机与网络
- 游戏服务器无法访问私有网络。
minecraft命名空间的网络策略只允许游戏服务器访问 DNS 和公网,所有私有地址段都被排除。依赖局域网服务的插件(例如连接局域网数据库的权限插件)无法工作。单机部署中,只能在使用felis manifests生成清单时通过--server-egress-allow-cidr添加例外,安装器和面板不提供该设置;多机部署不允许任何例外。 - firewalld 重新加载可能移除面板端口防护。 使用 Cloudflare Tunnel 访问方式时,Felis 用一张独立的 nftables 表(
inet felis_edge)关闭面板 NodePort 的公网访问,使面板只能经过 Cloudflare 访问。在运行 firewalld 的主机上,firewalld 重新加载可能清除这张表,面板端口会重新暴露在公网上。firewalld 重新加载后,执行sudo nft list table inet felis_edge检查;表不存在时重新应用 Cloudflare Tunnel 访问方式,见访问方式。主机缺少nft命令时,防护步骤明确报错,端口仍开放时不会报告成功。 - SELinux 主机上的主机运维服务没有独立的进程域。
felis-node-control.service的套接字目录和文件使用专用的 SELinux 类型,felis-api 通过文件权限和独占挂载访问该服务;当前策略允许容器进程连接以unconfined_service_t运行的服务的 Unix 流套接字,实际可达范围由文件标签和挂载范围限定。
玩家与游戏
- 服务器列表只显示 Felis 生成的 MOTD。 游戏代理根据服务器的生命周期状态(运行中、启动中、启动失败、休眠)和缓存的玩家人数生成服务器列表信息,不显示服务器自身配置的 MOTD。查询服务器列表不会唤醒服务器。
- 用户名冲突处理只部分实现。 登录空间会拒绝用户名冲突黑名单中的 UUID。游戏代理不会自动检测并记录用户名冲突,被替换账户的数据也没有供新账户继承的流程;面板中没有管理该黑名单的页面。
- 加载器模组不会自动安装。 Fabric、Forge、NeoForge 模组只提供
/link,面向 Minecraft 1.20.x 的独立服务器,无法加载到 Felis 网络使用的 26.x 服务器,安装器也不会部署它们。在 Felis 网络中,游戏代理的/link已覆盖所有服务器。见服务端插件。
构建流水线
- 批准投稿时的部分失败需要人工处理。 极少数情况下,批准投稿后构建已经启动,但构建与投稿的关联未能写入,此时接口返回的错误会注明正在运行的构建 ID。构建会继续运行并推送镜像;不要再次批准或重新提交该投稿,否则会重复构建。投稿记录中的构建关联需要由运维人员手动修正。投稿审核见平台管理。