biosludge/minecraft

Minecraft服务器镜像（基于itzg/minecraft-server修改版）

镜像概述

该镜像为itzg/minecraft-server的定制修改版本，核心功能是允许指定tgz压缩文件并解压到世界（world）文件夹，从而支持将游戏世界存储在tmpfs（内存文件系统）中，相比传统磁盘存储显著提升运行速度。

核心功能与特性

• tgz文件解压支持：可指定外部tgz压缩文件，自动解压到世界文件夹，实现世界数据的快速恢复
• tmpfs优化：支持将世界数据存储在tmpfs中，大幅提升读写性能
• 兼容itzg/minecraft-server的基础功能与环境变量
• 支持与itzg/mc-backup等备份工具集成，实现数据备份与恢复

使用场景

• 需要提升Minecraft服务器世界加载速度和响应性能的场景
• 对磁盘I/O敏感，希望通过内存存储优化性能的服务器部署
• 需要频繁重置或恢复世界数据的开发/测试环境

使用方法与配置说明

环境变量说明

Docker Compose部署示例

yaml
version: "3"

services:
  mc:
    image: biosludge/minecraft
    ports:
      - "25566:25565"  # Minecraft服务器端口映射
    volumes:
      - "data:/data"    # 数据卷（配置为tmpfs）
      - "./backup:/backup:ro"  # 只读备份目录
      - "./config:/config"     # 配置文件目录
    environment:
      EULA: "TRUE"              # 接受EULA协议
      ENABLE_RCON: "true"       # 启用RCON
      RCON_PASSWORD: "somepass" # RCON密码
      LATEST: "/backup/latest.tgz"  # 指定tgz压缩文件路径
      RCON_PORT: 28016          # RCON端口
      COPY_CONFIG_DEST: "/data" # 配置文件复制目标
    restart: always

  backup-mc:
    image: itzg/mc-backup
    environment:
      BACKUP_INTERVAL: "10m"        # 备份间隔（10分钟）
      PRUNE_BACKUPS_DAYS: "14"      # 备份保留天数（14天）
      RCON_HOST: "mc"               # RCON主机（服务名）
      RCON_PORT: "28016"            # RCON端口
      RCON_PASSWORD: "somepass"     # RCON密码
      EXLUDES: "cache,logs,jar,gz,tgz,xml"  # 排除的文件/目录
      BACKUP_METHOD: "tar"          # 备份方法（tar）
      DEST_DIR: "/backup"           # 备份目标目录
      LINK_LATEST: "TRUE"           # 创建最新备份的链接
    volumes:
      - "data:/data:ro"    # 只读挂载数据卷
      - "./backup:/backup" # 备份存储目录
    restart: always

volumes:
  data:
    driver_opts:
      type: tmpfs  # 使用tmpfs（内存文件系统）
      device: tmpfs

注意事项

• 数据风险：使用tmpfs存储世界数据时，若tmpfs被销毁（如服务器意外关闭），自上次备份后的世界数据可能丢失
• 备份依赖：必须配合定期备份机制（如示例中的itzg/mc-backup）使用，以降低数据丢失风险
• 内存需求：tmpfs会占用系统内存，需确保服务器有足够的内存空间容纳世界数据
• 使用此镜像即表示您了解并愿意承担数据丢失风险