实例管理
实例是面板托管的一个服务端进程,包含服务端程序、世界存档与配置。
新建实例
- 进入「实例」页面,点击「新建实例」。
- 选择服务端程序目录。
- 填写实例名称、内存上限与启动参数。
- 选择是否在创建后立即启动。
面板会为实例生成独立的工作目录与端口配置,多个实例可以并行运行。
导入实例
已有服务端目录可以直接导入:
- 点击「导入实例」,选择目录。
- 面板会识别
Worlds、配置文件和插件目录。 - 确认后实例出现在列表中,原有存档保持不动。
导入不会修改服务端文件,只在面板配置中登记路径与启动参数。
启动与停止
| 操作 | 行为 |
|---|---|
| 启动 | 由守护进程拉起服务端进程 |
| 停止 | 发送正常退出信号,等待存档落盘 |
| 重启 | 停止后重新启动 |
| 强制停止 | 进程无响应时使用,可能丢失未落盘数据 |
守护进程会监控实例进程,异常退出时记录日志并按配置决定是否自动重启。
控制台
实例详情页的「控制台」可以:
- 发送服务端命令并查看输出。
- 查看历史输出与错误信息。
- 复制日志内容用于排查。
控制台命令以当前登录用户的实例权限为准。
配置
可调整的常见项包括:
- Java/运行参数与内存上限(取决于服务端类型)。
- 启动参数、工作目录与环境变量。
- 自动重启策略与启动延迟。
- 面板显示的实例名称与分组。
修改配置后需要重启实例才能生效。
备份
- 手动备份:立即打包实例目录。
- 定时备份:按小时或按天执行,支持保留份数与自动清理。
- 恢复:选择备份文件恢复到指定实例,恢复前会先停止实例。
备份默认保存在 backups/,建议定期复制到其他磁盘或对象存储。
文件管理
实例详情页提供文件浏览与编辑:
- 查看、上传、下载、重命名与删除。
- 在线 编辑文本配置。
- 查看文件大小与修改时间。
涉及服务端运行中的文件时,建议先停止实例再修改,避免存档损坏。
删除实例
删除实例会从面板配置中移除该实例。默认保留磁盘目录;如需同时删除文件,请勾选对应选项并确认。删除操作不可撤销。