快速开始

ElementsPanel 是一个分布式的游戏服务器管理面板，可以集中管理多台机器上的多个实例，并发创建、启动、停止服务端，并提供多用户权限、文件管理、终端与插件市场。

它是 MCSManager 的分支（Apache-2.0），核心被重构为基于 cordis 的插件架构：面板与守护进程的内核只保留容器、插件加载器与日志，其余功能都以可装卸的插件提供。

两个进程

ElementsPanel 由两个互相独立的进程组成，缺一不可：

面板与守护进程可以装在同一台机器，也可以分散在多台机器上组成分布式部署（见连接其他机器）。

裸机与发行包使用 Node.js 20.x。Daemon Docker 镜像也安装 Node 20；Web Docker 镜像的 Node 基础层跟随 node:lts-alpine。
运行 Minecraft Java 版实例需要 JDK；官方守护进程 Docker 镜像已内嵌 Eclipse Temurin JDK，裸机安装则需自行准备并可在面板的 Java 管理页中下载。
默认需要放行的端口：

端口进程用途

端口	进程	用途
`23333`	Panel	Web 界面与 API。
`24444`	Daemon	节点协议（面板以 WebSocket 长连接接入）。

23333

Panel

Web 界面与 API。

24444

Daemon

节点协议（面板以 WebSocket 长连接接入）。

Note	`SystemConfig.dataPort` 仍保留默认值 `23334`，但当前运行时没有为它启动独立监听器；网页、API、上传与 WebSocket 都通过 `23333`。无需仅因该字段额外放行 `23334`。

三种方式任选其一，详见安装。想先跑起来看效果，最省事的是发行包或 Docker：

发行包（Linux）解压后的标准流程：

# 安装依赖（仅首次）
./install.sh

# 先启动守护进程
./start-daemon.sh

# 再启动面板 Web 服务（建议放在另一个终端）
./start-web.sh

Windows 发行包解压后直接运行 start.bat 即可（包内自带 Node 运行时）。

启动后浏览器访问 http://localhost:23333/ ，面板一般会自动发现本机守护进程。

ElementsPanel 没有初始化向导。首次启动时，若系统中还没有任何用户，面板会自动创建一个管理员账号并把随机密码仅打印一次到控制台/日志：

已创建默认管理员账户。
用户名：epanel
密码：xxxxxxxxxx
此密码仅显示一次。

请立刻用这组凭据登录，并到用户设置里修改密码。

Caution

若停用了 user 插件，面板将不再鉴权，对所有人开放所有请求。生产环境请勿关闭它。

目录内容

目录	内容
`web/data/`（源码仓库为 `panel/data/`）	面板配置、用户、节点配置、插件覆盖项、操作日志等（见数据与配置）。
`daemon/data/`	节点配置、实例配置与实例文件、计划任务、备份、Java 运行时等。
`web/plugins/`、`daemon/plugins/`	生产发行目录中的插件。内置插件与市场插件都从这里加载；市场插件目录带有 `.market-install.json` 所有权标记。
`panel/plugins/`、`daemon/plugins/`	源码仓库中的内置插件源码与清单。
`panel/data/plugins/`、`daemon/data/plugins/`	源码开发环境中安装的市场插件，避免改动仓库的内置插件树。

web/data/（源码仓库为 panel/data/）

面板配置、用户、节点配置、插件覆盖项、操作日志等（见数据与配置）。

daemon/data/

节点配置、实例配置与实例文件、计划任务、备份、Java 运行时等。

web/plugins/、daemon/plugins/

生产发行目录中的插件。内置插件与市场插件都从这里加载；市场插件目录带有 .market-install.json 所有权标记。

panel/plugins/、daemon/plugins/

源码仓库中的内置插件源码与清单。

panel/data/plugins/、daemon/data/plugins/

源码开发环境中安装的市场插件，避免改动仓库的内置插件树。

旧版本使用过的 market_plugins/ 仍会被扫描，但不会被自动移动或删除；确认插件已迁移或重新安装后再手工清理。