Crafty Controller v4 Docker镜像

镜像概述和主要用途

Crafty Controller是一款免费开源的Minecraft服务器启动器和管理器，允许用户通过友好的Web界面启动和管理Minecraft服务器。该界面作为自托管Web服务器运行，默认可在本地网络访问，也可通过端口转发提供外部访问。Crafty设计简洁，易于安装和使用，只需少量技术知识即可上手，目前由Arcadia Technology积极开发并持续改进。

作为功能丰富的面板，Crafty Controller支持创建和运行服务器、管理玩家、执行命令、修改服务器设置、查看和编辑服务器文件以及创建备份。借助它，可轻松直观地管理多个不同版本的Minecraft服务器。

核心功能和特性

• 用户友好Web界面：通过自托管Web服务器提供访问，支持HTTP和HTTPS
• 多服务器管理：轻松创建和管理多个不同版本的Minecraft服务器
• 全面服务器控制：启动/停止服务器、执行命令、调整设置
• 玩家管理：监控和管理服务器玩家活动
• 文件管理：查看、编辑服务器配置文件和数据文件
• 备份功能：创建和管理服务器备份，保障数据安全
• 跨版本支持：兼容Minecraft Java版和基岩版服务器

构建说明

基于GitHub 'master'分支的最新提交构建。

使用方法

基本运行命令

docker run -d \
    -p <主机Web UI HTTP端口>:8000 \
    -p <主机Web UI HTTPS端口>:8443 \
    -p <主机Minecraft基岩版TCP端口范围>:***-***/tcp \
    -p <主机Minecraft基岩版UDP端口范围>:***-***/udp \
    -p <主机Minecraft Java版TCP端口范围>:25565-25575/tcp \
    --name=<容器名称> \
    -v <配置文件路径>:/config \
    -v /etc/localtime:/etc/localtime:ro \
    -e TZ=Etc/<地区> \
    -e JAVA_VERSION=<8|11|17|21|latest> \
    -e HEALTHCHECK_COMMAND=<命令> \
    -e HEALTHCHECK_ACTION=<操作> \
    -e HEALTHCHECK_HOSTNAME=<主机名> \
    -e UMASK=<创建文件的权限掩码> \
    -e PUID=<用户ID> \
    -e PGID=<组ID> \
    binhex/arch-crafty-4

请将上述命令中所有由<>定义的用户变量替换为实际值。

访问Web界面

https://<主机IP>:8443
注意：8000端口的HTTP为旧版，将自动重定向到8443端口的HTTPS。

Web界面登录凭据

• 用户名：admin
• 密码：动态生成，未手动设置时，密码存储在/config/crafty/app/config/default-creds.txt中（历史硬编码密码为crafty）。

使用示例

docker run -d \
    -p 8000:8000 \
    -p 8443:8443 \
    -p ***-***:***-***/tcp \
    -p ***-***:***-***/udp \
    -p 25565-25575:25565-25575/tcp \
    --name=crafty \
    -v /apps/docker/crafty:/config \
    -v /etc/localtime:/etc/localtime:ro \
    -e TZ=Etc/UTC \
    -e JAVA_VERSION=latest \
    -e UMASK=000 \
    -e PUID=99 \
    -e PGID=100 \
    binhex/arch-crafty-4

注意事项

• 用户权限限制：Crafty v4不支持以root用户（ID 0）和root组（ID 0）运行，PUID和PGID禁止设置为0。
• 获取PUID/PGID：通过以下命令获取目标用户的用户ID（PUID）和组ID（PGID）：

  id <用户名>
  

相关链接

• 文档 | 支持论坛