Crafty Controller - 服务器管理面板

Crafty 4 是我们 Minecraft 服务器包装器/控制器/启动器的全新迭代版本。它拥有全新的简洁界面，并从底层完全重建。Crafty 4 带来了一系列新功能，例如支持基岩版服务器，并且即将加入 SteamCMD 支持！

Crafty 的主要目的是在后台启动 Minecraft 服务器，并为管理员提供一个可通过网页界面来管理和交互服务器的控制台。

💡核心功能

• 在后台启动和管理 Minecraft 服务器。
• 提供直观的网页控制界面。
• 支持 Minecraft Java 版和基岩版服务器。
• 支持所有主流操作系统和 Linux 发行版。
• 提供预构建的 Docker 镜像和 UnRaid 模板（使用 Docker 非强制要求）。

🎮技术架构

Crafty 使用 Python (最低版本 3.10) 编写，并采用了以下技术栈：

• 密码哈希：Argon2
• Web 后端：Tornado 网络服务器
• 数据存储：SQLite 数据库（用于存储设置和其他数据）
• 前端图标：Font Awesome 6（用于按钮和其他图形元素）
• 任务调度：APScheduler
• 进程管理：Subprocess（用于生成服务器进程）

💡关于 Crafty Controller

Crafty Controller 是一个功能强大的 Web 界面，用于在 Linux 服务器上轻松部署、管理和监控 Minecraft（以及多种其他游戏）服务器。它提供了一个直观的仪表板，让您无需复杂的命令行操作即可完成所有任务。

🎮核心功能

• 多服务器管理：从一个界面管理多个游戏服务器实例。
• 支持多种游戏：原生支持 Minecraft（Java 版和基岩版）、7 Days to Die、SteamCMD 游戏等。
• 一键安装：通过简单的安装脚本快速部署。
• Web 控制台：直接在浏览器中访问服务器控制台并发送命令。
• 文件管理：通过 Web 界面轻松上传、下载、编辑服务器文件。
• 备份与计划任务：配置自动备份和定时任务（如重启）。
• 实时监控：查看服务器资源使用情况（CPU、内存、磁盘）。
• 用户与权限：创建具有不同权限级别的子用户。
• 模组与插件支持：方便地安装和管理 Forge、Fabric、Paper、Spigot 等。
• Docker 支持：可选择使用 Docker 容器运行，便于部署和隔离。

🔧安装要求

• 操作系统：Ubuntu 20.04/22.04 LTS、Debian 10/11 或 CentOS 7/8（推荐使用 Ubuntu 22.04）。
• Python 版本：Python 3.8 或更高版本。
• 权限：需要 root 或具有 sudo 权限的用户。
• 内存：至少 2 GB RAM（建议 4 GB 以上，具体取决于托管的服务端数量）。
• 存储空间：至少 10 GB 可用磁盘空间。
• 网络：服务器需要开放端口（默认为 8443 用于 Web 界面，25565 等用于 Minecraft 服务端）。

✨快速安装

以下是在全新 Ubuntu 22.04 系统上的安装步骤：

• 以 root 用户或使用 sudo 权限登录服务器。
• 运行一键安装脚本：

    sudo apt update && sudo apt upgrade -y
    sudo apt install curl -y
    curl -sSL https://craftycontrol.com/install.py | sudo python3

• 按照安装向导完成设置，包括创建管理员账户。
• 安装完成后，在浏览器中访问 https://<你的服务器IP>:8443。
• 使用设置的管理员凭据登录，然后开始创建你的第一个游戏服务器。

使用 Docker 安装

如果你更喜欢使用 Docker

docker run \
  --name crafty \
  -d \
  -p 8443:8443 \
  -p 25565:25565 \
  -p 25566:25566 \
  -e TZ=Etc/UTC \
  -v /var/lib/crafty:/crafty \
  --restart unless-stopped \
  craftycontrol/crafty-4:latest

❓常见问题

• 无法访问 Web 界面？

- 检查防火墙是否放行了端口 `8443`（例如：`sudo ufw allow 8443`）。

- 确保 Crafty 服务正在运行：`sudo systemctl status crafty`。

• 如何更新 Crafty Controller？

- 在 Web 仪表板的“系统设置”或“关于”部分，通常有内置的更新检查器。

- 或者，可以运行更新脚本：`sudo /opt/crafty/update.py`。

• 如何迁移现有的 Minecraft 服务器？

- 在 Crafty 中创建一个相同服务端类型（如 Paper）的新服务器。

- 通过 Crafty 的文件管理器，将现有服务器的 `world`、`plugins`、`server.properties` 等关键文件夹/文件上传到新服务器的对应目录中。

- 修改 `server.properties` 等配置文件的路径（如果需要）。

- 启动服务器。

• 支持 Minecraft 基岩版吗？

- 支持。在创建服务器时，选择“Bedrock Edition”作为服务器类型。

• 备份存储在哪里？

- 默认备份路径在 Crafty 的数据目录下，例如 `/var/lib/crafty/backups`。你可以在设置中配置备份位置。

⭐获取帮助与社区

• 官方文档：访问 https://docs.craftycontrol.com 获取完整指南。
• Discord 社区：加入官方 Discord 频道获取实时帮助和交流。
• GitHub 仓库：报告问题或贡献代码，请访问 Crafty Controller GitHub。