riftbit/minecraft

Minecraft服务器Docker镜像

概述

该Docker镜像集成了多种Minecraft服务器类型，旨在提供便捷的Minecraft服务器部署方案。支持原版(vanilla)、Nukkit（Bedrock版支持）、PowerNukkit（增强型Nukkit）等多种服务器类型，适用于个人、小型社区或开发者快速搭建不同特性的Minecraft服务器环境。

核心功能与特性

• 多服务器类型支持：包含原版Minecraft服务器（Java版）、Nukkit（Bedrock版支持）、PowerNukkit（扩展Nukkit功能）等主流服务器类型
• 简化部署流程：无需手动配置Java环境和服务器文件，通过Docker容器化部署，降低搭建门槛
• 灵活配置：支持通过环境变量自定义服务器版本、最大玩家数、服务器描述等核心参数
• 数据持久化：通过卷挂载实现服务器数据（世界文件、配置文件等）持久化存储，避免容器重启数据丢失

使用场景

• 个人玩家搭建私有Minecraft服务器，与朋友联机游戏
• 小型游戏社区部署多人服务器，支持不同版本客户端接入
• 开发者测试不同类型或版本的Minecraft服务器兼容性
• 教学或演示环境中快速部署临时Minecraft服务器

使用方法

基本部署命令

以部署原版Minecraft服务器为例：

bash
docker run -d -p 25565:25565 -v minecraft_data:/server/data --name minecraft-server minecraft-servers:latest

环境变量配置

通过环境变量自定义服务器参数：

数据持久化配置

为确保服务器数据（世界、配置、插件等）不丢失，建议挂载本地目录作为数据卷：

bash
docker run -d \
  -p 25565:25565 \
  -v /本地路径/minecraft_data:/server/data \
  -e SERVER_TYPE=powernukkit \
  -e SERVER_VERSION=1.19.70 \
  --name minecraft-server \
  minecraft-servers:latest

Docker Compose配置示例

yaml
version: '3.8'

services:
  minecraft-server:
    image: minecraft-servers:latest
    container_name: minecraft-server
    restart: always
    ports:
      - "25565:25565"  # Java版端口
      - "19132:19132/udp"  # Bedrock版端口（Nukkit/PowerNukkit时需要）
    volumes:
      - minecraft_data:/server/data
    environment:
      - SERVER_TYPE=nukkit
      - SERVER_VERSION=1.19.80
      - MAX_PLAYERS=30
      - MOTD="My Nukkit Server"
      - PVP=false

volumes:
  minecraft_data:

服务器管理

• 查看服务器日志：docker logs -f minecraft-server
• 进入服务器控制台：docker exec -it minecraft-server /bin/bash
• 停止服务器：docker stop minecraft-server
• 重启服务器：docker restart minecraft-server