mlinarik/minecraft

Minecraft Paper Docker镜像文档

1. 镜像概述与主要用途

1.1 概述

本Docker镜像提供Minecraft服务器环境，支持自动下载并部署Paper服务端。镜像标签（Tag）对应所使用的Paper版本，基础镜像为构建时的最新Ubuntu系统，确保运行环境的稳定性与兼容性。

1.2 主要用途

快速部署Minecraft Paper服务器，无需手动配置服务端文件，简化服务器搭建流程，适用于个人或小型社区的Minecraft游戏服务需求。

2. 核心功能与特性

• 自动下载Paper服务端：启动容器时自动拉取对应版本的Paper服务端文件，无需手动下载配置。
• 版本标签化管理：通过镜像标签（如1.18、1.19）指定使用的Paper版本，latest标签默认对应最新版本（当前为1.19）。
• 基于最新Ubuntu构建：基础镜像采用构建时的最新Ubuntu系统，提供可靠的底层运行环境。

3. 使用场景与适用范围

• 个人服务器：适合玩家快速搭建个人Minecraft服务器，支持单人或好友联机。
• 小型社区服务器：满足小型游戏社区的轻量服务需求，简化运维流程。
• 版本测试环境：通过指定标签快速切换不同Paper版本，测试版本兼容性或新特性。

4. 使用方法与配置说明

4.1 Docker Run部署示例

基础部署命令

bash
docker run -d \
  --name myminecraftserver \
  -v /data/minecraft_data_folder:/mcdata \
  -p 25565:25565 \
  docker.xuanyuan.run/mlinarik/minecraft:{tag}

参数说明

• -d：后台运行容器（ detached mode ）。
• --name myminecraftserver：指定容器名称（可自定义）。
• -v /data/minecraft_data_folder:/mcdata：数据卷挂载，将宿主机目录/data/minecraft_data_folder映射到容器内/mcdata目录，用于持久化存储服务器配置、存档等数据。
• -p 25565:25565：端口映射，将容器内Minecraft默认端口25565映射到宿主机相同端口（宿主机端口可自定义，如25566:25565）。
• mlinarik/minecraft:{tag}：镜像名称及版本标签，{tag}替换为具体版本（如1.18、1.19），latest标签对应最新版本（当前为1.19）。

4.2 数据存储说明

宿主机目录/data/minecraft_data_folder需提前创建（若不存在，容器可能无法正常启动），用于存储服务器配置文件（如server.properties）、玩家存档、插件等数据，删除容器后数据仍可保留。

4.3 配置说明

必要配置项

• 数据卷挂载：必须通过-v参数挂载数据卷，否则服务器数据（如存档、配置）会随容器删除而丢失。
• 端口映射：默认使用Minecraft标准端口25565，若宿主机该端口被占用，可修改宿主机端口（如-p 25566:25565）。
• 版本选择：通过镜像标签指定Paper版本，例如mlinarik/minecraft:1.18使用1.18版本，mlinarik/minecraft:latest使用1.19版本。

4.4 Docker Compose部署示例（可选）

创建docker-compose.yml文件，内容如下：

yaml
version: '3'
services:
  minecraft-paper:
    image: docker.xuanyuan.run/mlinarik/minecraft:1.19  # 指定版本，或使用latest
    container_name: myminecraftserver
    restart: unless-stopped  # 容器退出时自动重启（可选）
    volumes:
      - /data/minecraft_data_folder:/mcdata  # 数据卷挂载
    ports:
      - "25565:25565"  # 端口映射

启动命令：docker-compose up -d

5. 注意事项

• 条款同意：使用本镜像即表示同意Minecraft/Mojang及Ubuntu/Canonical的服务条款：
  • Minecraft/Mojang条款：[***]
  • Ubuntu/Canonical条款：https://ubuntu.com/legal/terms
• 数据目录权限：确保宿主机数据目录（如/data/minecraft_data_folder）有足够权限，避免容器因权限不足无法写入数据。
• 端口冲突：启动前确认宿主机映射端口未被其他服务占用，否则容器可能启动失败。