第一个实例

更新于 2026-09-29在 GitHub 上编辑

本页把面板与节点接起来,并创建、启动第一个服务器实例。

1. 连接节点

面板自己不能运行服务端,必须通过节点(Daemon)操作被控机器。启动 start-daemon.sh 后,在面板的节点页面新建一个节点:

字段 说明

地址

节点所在机器的 IP 与端口,本机为 127.0.0.1:24444。

API Key

节点与面板约定的密钥,两端必须一致。

API Key 来自节点的配置文件 daemon/data/Config/global.json 的 key 字段。面板侧填写的值必须与它相同;不匹配时节点会拒绝连接。

保存后面板会立即用 WebSocket 连上节点,节点卡片上会显示在线状态。分布式部署(连接其他机器)见 连接其他机器。

2. 认识插件与市场

面板的功能菜单由已安装的插件决定。插件页面列出所有面板插件与节点插件,每一项都有一个开关:

  • 关闭开关会立即卸载该插件的作用域——它注册的路由、页面、协议事件一并消失;

  • 打开开关会重新加载。

生产环境里,面板插件直接安装到 web/plugins/,节点插件安装到用户选中的各节点 daemon/plugins/;源码开发环境则使用两端各自的 data/plugins/。旧版 market_plugins/ 只作为兼容扫描目录保留。详见 插件系统。

Tip
在插件市场里可以浏览、安装第三方插件。含 Daemon 端的插件会先要求选择目标节点;个别节点失败会单独报告,不回滚已经成功写入的面板端或其他节点。

3. 创建实例

进入实例页面,点击新建:

  1. 选择所属节点。

  2. 选择实例类型 / 预设。预设由插件提供,例如:

    • Minecraft Java 版 / 基岩版等内置预设,由 instance 插件提供;

    • install 预设用于直接从市场包一键安装,由 market 插件提供。

  3. 按需填写启动命令、工作目录、内存上限、是否使用 Docker 等。

创建过程会要求节点准备实例目录(默认在 daemon/data/InstanceData/<uuid>/),完成后实例出现在列表中。

Note
如果选择用 Docker 运行实例,节点所在机器需要可用的 Docker 环境;节点以容器方式部署时,要让该容器能访问宿主机的 Docker socket。

4. 日常操作

创建之后,围绕一个实例常用的功能都集中在实例页里,均由对应插件提供:

功能 说明

控制台 / 终端

启动、停止、重启,查看实时输出并发送命令(terminal 插件)。

文件管理

在线编辑、上传下载、压缩解压,内置文本编辑器与图片查看器(file 插件)。

计划任务

定时执行命令、定时备份等;任务类型可由插件扩展(instance 插件的 schedule 能力)。

备份

创建、下载与还原实例备份(backup 插件)。

Java 管理

下载、安装、切换实例使用的 JDK(java 插件)。

状态与玩家

查询 Minecraft 服务端在线状态与在线人数(mcstats 插件)。

模组 / 插件

搜索并安装 Minecraft 模组或服务端插件(mod 插件)。

停止某个插件会一并移除它提供的功能入口,这是插件化设计的一部分,不是故障。

5. 多用户与权限

user 插件提供账号、角色(管理员 / 普通用户)、实例授权与 SSO。管理员可以在用户页面新建用户,并把指定实例分配给某个用户;普通用户只能看到被授权的实例。

面板自身的外观(标题、Logo、背景图)以及登录页文案,在系统设置与插件设置中调整,见 数据与配置。

下一步