第一个实例
本页把面板与节点接起来,并创建、启动第一个服务器实例。
1. 连接节点
面板自己不能运行服务端,必须通过节点(Daemon)操作被控机器。启动 start-daemon.sh 后,在面板的节点页面新建一个节点:
| 字段 | 说明 |
|---|---|
地址 |
节点所在机器的 IP 与端口,本机为 |
API Key |
节点与面板约定的密钥,两端必须一致。 |
API Key 来自节点的配置文件 daemon/data/Config/global.json 的 key 字段。面板侧填写的值必须与它相同;不匹配时节点会拒绝连接。
保存后面板会立即用 WebSocket 连上节点,节点卡片上会显示在线状态。分布式部署(连接其他机器)见 连接其他机器。
2. 认识插件与市场
面板的功能菜单由已安装的插件决定。插件页面列出所有面板插件与节点插件,每一项都有一个开关:
-
关闭开关会立即卸载该插件的作用域——它注册的路由、页面、协议事件一并消失;
-
打开开关会重新加载。
生产环境里,面板插件直接安装到 web/plugins/,节点插件安装到用户选中的各节点 daemon/plugins/;源码开发环境则使用两端各自的 data/plugins/。旧版 market_plugins/ 只作为兼容扫描目录保留。详见 插件系统。
|
Tip
|
在插件市场里可以浏览、安装第三方插件。含 Daemon 端的插件会先要求选择目标节点;个别节点失败会单独报告,不回滚已经成功写入的面板端或其他节点。 |
3. 创建实例
进入实例页面,点击新建:
-
选择所属节点。
-
选择实例类型 / 预设。预设由插件提供,例如:
-
Minecraft Java 版 / 基岩版等内置预设,由
instance插件提供; -
install预设用于直接从市场包一键安装,由market插件提供。
-
-
按需填写启动命令、工作目录、内存上限、是否使用 Docker 等。
创建过程会要求节点准备实例目录(默认在 daemon/data/InstanceData/<uuid>/),完成后实例出现在列表中。
|
Note
|
如果选择用 Docker 运行实例,节点所在机器需要可用的 Docker 环境;节点以容器方式部署时,要让该容器能访问宿主机的 Docker socket。 |
4. 日常操作
创建之后,围绕一个实例常用的功能都集中在实例页里,均由对应插件提供:
| 功能 | 说明 |
|---|---|
控制台 / 终端 |
启动、停止、重启,查看实时输出并发送命令( |
文件管理 |
在线编辑、上传下载、压缩解压,内置文本编辑器与图片查看器( |
计划任务 |
定时执行命令、定时备份等;任务类型可由插件扩展( |
备份 |
创建、下载与还原实例备份( |
Java 管理 |
下载、安装、切换实例使用的 JDK( |
状态与玩家 |
查询 Minecraft 服务端在线状态与在线人数( |
模组 / 插件 |
搜索并安装 Minecraft 模组或服务端插件( |
停止某个插件会一并移除它提供的功能入口,这是插件化设计的一部分,不是故障。
5. 多用户与权限
user 插件提供账号、角色(管理员 / 普通用户)、实例授权与 SSO。管理员可以在用户页面新建用户,并把指定实例分配给某个用户;普通用户只能看到被授权的实例。
面板自身的外观(标题、Logo、背景图)以及登录页文案,在系统设置与插件设置中调整,见 数据与配置。