存档与数据库设置
Utopia Server Panel 采用单存档独立 SQLite 数据库的隔离架构,确保同一服务端切换不同世界存档时,用户账号、权限、监控历史与地图缓存互不污染。
按存档隔离的数据目录
服务端启动并加载世界后,面板会在当前激活的世界存档目录下自动创建 utopia_server_panel 子目录,用于存放该存档专属的全部面板数据:
utopia_server_panel/utopia_server_panel.db:该存档独立的 SQLite 数据库,包含用户、角色、权限、配置、绑定关系、监控日志、路径点、白名单申请与聊天记录。utopia_server_panel/map_cache/:网页小地图渲染生成的磁盘瓦片缓存目录。
同时,面板会在 config/utopia_server_panel_worlds.json 中维护一份轻量级存档索引,记录各个历史存档的路径、世界名称、Minecraft 版本与最近活跃时间,便于在「存档与数据库」页面集中查看各存档的数据库大小与记录统计。
旧版数据库自动迁移
如果服务端此前在 config/utopia_server_panel.db 中存有旧版单库数据,且当前世界存档目录下尚未生成独立数据库,面板在启动时会自动完成以下迁移步骤:
- 将
config/utopia_server_panel.db及其 WAL/SHM 附属文件复制到当前世界存档的utopia_server_panel/utopia_server_panel.db。 - 将原
config/utopia_server_panel.db重命名为config/utopia_server_panel.db.migrated作为备份保留。 - 清理残留的临时 WAL/SHM 文件并正常初始化新路径数据库。