搬瓦工搭建 Crafty Minecraft 管理面板教程

Crafty Controller 是一款专为 Minecraft 服务器设计的开源 Web 管理面板，使用 Python 开发，提供直观的图形界面来创建和管理多个 Minecraft 服务器实例。相比 Pterodactyl 等通用游戏面板，Crafty 对 Minecraft 的支持更加深入和便捷。本文将介绍如何在搬瓦工 VPS 上通过 Docker 快速搭建 Crafty Controller。购买搬瓦工 VPS 请参考全部方案，使用优惠码 NODESEEK2026 可享受 6.77% 的折扣。

一、Crafty Controller 特点

专为 Minecraft 优化的 Web 管理界面。
支持同时管理多个 Minecraft 服务器实例。
一键导入 Vanilla、Paper、Forge、Fabric 等各种服务端。
内置文件管理器，可直接编辑服务器配置文件。
实时监控 CPU、内存、在线玩家等信息。
支持定时任务和自动备份功能。
内置终端，可直接在浏览器中执行服务器命令。

二、系统要求

操作系统：Ubuntu 22.04 LTS 推荐。
内存：Crafty 本身约需 256MB，加上 Minecraft 服务器至少需要 2GB 以上。
Docker：需要预先安装 Docker 和 Docker Compose。
端口：8443（Web 面板）、25565（Minecraft 默认端口）。

三、使用 Docker 安装 Crafty

3.1 安装 Docker

如果尚未安装 Docker，请参考 Docker 安装教程完成安装。

3.2 创建目录结构

mkdir -p /opt/crafty/{backups,logs,servers,config,import}
cd /opt/crafty

3.3 创建 Docker Compose 文件

cat > /opt/crafty/docker-compose.yml << 'EOF'
version: '3.8'

services:
  crafty:
    container_name: crafty_controller
    image: registry.gitlab.com/crafty-controller/crafty-4:latest
    restart: always
    environment:
      - TZ=Asia/Shanghai
    ports:
      - "8443:8443"
      - "25565:25565"
      - "25566:25566"
      - "25567:25567"
      - "19132:19132/udp"
    volumes:
      - ./backups:/crafty/backups
      - ./logs:/crafty/logs
      - ./servers:/crafty/servers
      - ./config:/crafty/app/config
      - ./import:/crafty/import
EOF

如果需要运行多个 Minecraft 服务器，可以映射更多端口（如 25566、25567 等）。

3.4 启动 Crafty

cd /opt/crafty
docker compose up -d

3.5 获取初始登录凭据

首次启动后，查看日志获取初始管理员密码：

docker compose logs crafty | grep -i password

使用浏览器访问 https://VPS的IP:8443，使用默认用户名和日志中显示的密码登录。首次登录后请立即修改密码。

四、创建 Minecraft 服务器

4.1 通过面板创建

登录 Crafty 面板，点击左侧的"Servers"。
点击"Create New Server"。
选择服务端类型（Paper、Vanilla、Forge、Fabric 等）。
选择 Minecraft 版本。
设置服务器名称和端口号。
配置最小和最大内存分配。
点击创建，Crafty 会自动下载并配置服务端。

4.2 导入已有服务器

将已有的 Minecraft 服务器文件放入 /opt/crafty/import/ 目录，然后在面板中使用导入功能。

五、服务器管理功能

5.1 控制台

Crafty 提供 Web 终端，可以直接在浏览器中输入 Minecraft 服务器命令：

# 常用服务器命令（在 Crafty 终端中输入）
op 玩家名
whitelist add 玩家名
difficulty hard
gamerule keepInventory true
save-all

5.2 文件管理

通过 Crafty 内置的文件管理器可以直接编辑服务器配置文件，无需通过 SSH 操作。可以直接修改 server.properties、bukkit.yml 等配置文件。

5.3 定时任务

在 Crafty 面板中可以设置定时任务，例如：

每天凌晨自动重启服务器。
定时执行 save-all 命令保存世界。
定时广播消息通知玩家。

六、配置防火墙

ufw allow 8443/tcp    # Crafty 面板
ufw allow 25565/tcp   # Minecraft Java
ufw allow 19132/udp   # Minecraft Bedrock
ufw reload

七、Nginx 反向代理（可选）

如果你想通过域名访问 Crafty 面板：

cat > /etc/nginx/sites-available/crafty.conf << 'EOF'
server {
    listen 80;
    server_name crafty.yourdomain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name crafty.yourdomain.com;

    ssl_certificate /etc/letsencrypt/live/crafty.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/crafty.yourdomain.com/privkey.pem;

    location / {
        proxy_pass https://127.0.0.1:8443;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}
EOF

ln -s /etc/nginx/sites-available/crafty.conf /etc/nginx/sites-enabled/
nginx -t && systemctl restart nginx

八、备份与恢复

8.1 面板内置备份

Crafty 提供内置的备份功能，可以在每个服务器的设置中配置自动备份计划。备份文件保存在 /opt/crafty/backups/ 目录下。

8.2 额外的系统级备份

cat > /opt/crafty/backup.sh << 'EOF'
#!/bin/bash
DATE=$(date +%Y%m%d-%H%M%S)
BACKUP_DIR=/opt/crafty-system-backups

mkdir -p $BACKUP_DIR
tar -czf $BACKUP_DIR/crafty-full-$DATE.tar.gz -C /opt/crafty servers/ config/
find $BACKUP_DIR -name "*.tar.gz" -mtime +7 -delete
echo "[$DATE] System backup completed"
EOF
chmod +x /opt/crafty/backup.sh

(crontab -l 2>/dev/null; echo "0 4 * * * /opt/crafty/backup.sh") | crontab -

九、更新 Crafty

cd /opt/crafty
docker compose pull
docker compose up -d

十、常见问题

无法访问面板

确认防火墙已开放 8443 端口。Crafty 使用 HTTPS 协议，注意访问时使用 https:// 前缀。首次访问时浏览器可能提示证书不受信任（自签名证书），点击继续访问即可。

Minecraft 服务器内存不足

在创建服务器时合理分配内存。每个 Minecraft 服务器建议分配 1-4GB 内存，确保 VPS 总内存能满足所有服务器的需求。

总结

Crafty Controller 是管理 Minecraft 服务器的优秀方案，界面友好、功能完善。通过 Docker 方式部署在搬瓦工 VPS 上非常便捷。如果你还需要管理非 Minecraft 游戏服务器，可以考虑使用 Pterodactyl 面板。更多游戏服务器教程请参阅 Terraria、Valheim 等。购买搬瓦工 VPS 请访问 bwh81.net，使用优惠码 NODESEEK2026 可享受 6.77% 的折扣。