arcadiatechnology/crafty-4

Crafty Controller

基于Python的Minecraft服务器控制面板

什么是Crafty Controller？

Crafty Controller是一款Minecraft服务器控制面板/启动器。其主要功能是在后台启动Minecraft服务器，并提供Web界面供服务器管理员与服务器进行交互。Crafty兼容Docker、Linux、Windows 7、Windows 8和Windows 10系统。

文档

完整文档可访问 Crafty Docs

项目信息

项目主页 - [***]

服务器 - []

Git仓库 - [***]

Docker基本使用 🐳

在Crafty Controller 4.0版本中，我们专注于构建DevOps原则，实现构建自动化，并加强容器安全性，旨在让容器用户的使用体验更便捷。

- 两个主要变化：

• 现在提供预构建镜像。
• 容器以非root用户运行，采用OpenShift和Kubernetes的实践（root组权限）。

⚠ 🔻警告：[WSL/WSL2 | Windows 11 | Docker Desktop]🔻
请注意！在WSL/WSL2、Windows 11 / Docker Desktop环境下，Docker中的Minecraft运行存在上游问题！
当“停止”或“重启”MC服务器时，有90%的概率会导致世界区块被永久损坏！
请仅在Linux上运行Docker，若使用Windows，可通过以下链接获取便携版安装程序：最新稳定版，最新开发版

- 开始使用Docker 🛫

只需从本Git仓库的 registry 拉取镜像即可（无需像3.x版本那样克隆仓库并构建）。

若已有来自先前本地安装或Docker设置的配置文件夹，镜像会挂载该卷并修复所需权限；若无配置，镜像将自动生成配置文件夹。

由于Dockerfile内部使用crafty:root权限结构，无需担心与主机系统的UID或GID匹配问题。

- 使用registry镜像 🌎

提供的镜像支持arm64和amd64架构。若遇到问题，可使用docker/目录下的compose文件自行构建。

镜像地址：registry.gitlab.com/crafty-controller/crafty-4:latest 或 arcadiatechnology/crafty-4

以下是几种快速启动方式🚀：

docker-compose.yml配置：

sh
# 创建compose文件
$ vim docker-compose.yml

yml
version: '3'

services:
  crafty:
    container_name: crafty_container
    image: registry.gitlab.com/crafty-controller/crafty-4:latest
    restart: always
    environment:
      - TZ=Etc/UTC  # 时区设置
    ports:
      - "8000:8000"  # HTTP端口
      - "8443:8443"  # HTTPS端口
      - "8123:8123"  # DYNMAP端口
      - "19132:19132/udp"  # BEDROCK版端口
      - "25500-25600:25500-25600"  # MC服务器端口范围
    volumes:
      - ./docker/backups:/crafty/backups  # 备份文件
      - ./docker/logs:/crafty/logs  # 日志文件
      - ./docker/servers:/crafty/servers  # 服务器文件
      - ./docker/config:/crafty/app/config  # 配置文件
      - ./docker/import:/crafty/import  # 导入文件

sh
$ docker-compose up -d && docker-compose logs -f  # 启动并查看日志

docker run命令：

sh
$ docker run \
	--name crafty_container \
	--detach \
	--restart always \
	-p 8000:8000 \
	-p 8443:8443 \
	-p 8123:8123 \
	-p 19132:19132/udp \
	-p 25500-25600:25500-25600 \
	-e TZ=Etc/UTC \
	-v "/$(pwd)/docker/backups:/crafty/backups" \
	-v "/$(pwd)/docker/logs:/crafty/logs" \
	-v "/$(pwd)/docker/servers:/crafty/servers" \
	-v "/$(pwd)/docker/config:/crafty/app/config" \
	-v "/$(pwd)/docker/import:/crafty/import" \
	registry.gitlab.com/crafty-controller/crafty-4:latest

从克隆仓库构建：

若通过docker-compose构建，可在./docker/docker-compose.yml找到配置文件，进入docker目录后执行docker-compose up -d即可。

若不使用docker-compose，可在Dockerfile所在目录执行以下命令：

sh
# 先构建镜像
$ docker build . -t crafty

$ docker run \
	--name crafty_container \
	--detach \
	--restart always \
	-p 8000:8000 \
	-p 8443:8443 \
	-p 8123:8123 \
	-p 19132:19132/udp \
	-p 25500-25600:25500-25600 \
	-e TZ=Etc/UTC \
	-v "/$(pwd)/docker/backups:/crafty/backups" \
	-v "/$(pwd)/docker/logs:/crafty/logs" \
	-v "/$(pwd)/docker/servers:/crafty/servers" \
	-v "/$(pwd)/docker/config:/crafty/app/config" \
	-v "/$(pwd)/docker/import:/crafty/import" \
	crafty

首次构建可能需要几分钟（取决于系统性能），后续构建会更快。