MCDReforged-Extra Docker镜像文档

镜像概述

MCDReforged-Extra是MCDReforged的Docker化镜像，基于官方MCDReforged构建，并预装了额外Python包，旨在简化部署流程，减少用户手动安装依赖的操作。MCDReforged是一款功能强大的Minecraft服务器管理工具，支持插件扩展、命令自定义等功能，该镜像进一步增强了其易用性和扩展性。

核心功能与特性

• 预装额外Python包：无需手动安装常用Python依赖，开箱即可使用扩展功能
• 多标签支持：提供多种标签以适应不同场景：
  • 稳定版：如latest（最新稳定版）、2.13.0（指定版本）
  • 开发版：dev（开发分支最新构建）
  • 精简版：-slim后缀（基于精简基础镜像，体积更小）
  • 指定Python版本：-py3.11后缀（如dev-py3.11，使用Python 3.11运行环境）
• 快速部署：Docker化封装，支持跨平台一致运行，简化环境配置

使用场景

• 快速部署MCDReforged：适合需要立即启动MCDReforged的用户，避免依赖安装步骤
• 插件开发与测试：预装额外Python包，便于直接测试依赖第三方库的插件
• 生产环境部署：选择稳定版标签（如2.13.0）确保运行稳定性
• 资源受限环境：使用slim标签减少镜像体积，节省存储空间和网络带宽
• 版本兼容性测试：通过指定Python版本标签（如-py3.11）验证不同Python环境下的兼容性

使用方法

拉取镜像

根据需求选择标签拉取镜像：

# 最新稳定版
docker pull mcdreforged/mcdreforged-extra:latest

# 最新开发版（精简版）
docker pull mcdreforged/mcdreforged-extra:dev-slim

# 指定版本+Python 3.11
docker pull mcdreforged/mcdreforged-extra:2.13.0-py3.11

基本运行（docker run）

使用docker run启动容器，建议挂载数据目录以持久化配置和数据：

docker run -d \
  --name mcdreforged \
  -v /path/to/local/data:/data \  # 挂载数据目录（配置、插件、日志等）
  -p 25565:25565 \  # 如需映射Minecraft服务器端口（根据实际需求调整）
  mcdreforged/mcdreforged-extra:latest

Docker Compose配置

创建docker-compose.yml文件，示例如下：

version: '3.8'
services:
  mcdreforged:
    image: mcdreforged/mcdreforged-extra:latest
    container_name: mcdreforged
    volumes:
      - ./data:/data  # 本地数据目录映射
    ports:
      - "25565:25565"  # Minecraft服务器端口（按需调整）
      - "24444:24444"  # MCDReforged远程管理端口（如需）
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动服务：

docker-compose up -d

标签说明

配置与数据持久化

• 数据目录：建议将容器内/data目录挂载至宿主机，以持久化MCDReforged配置（config/）、插件（plugins/）、日志（logs/）等数据
• 配置修改：通过宿主机挂载的/data/config目录直接编辑配置文件，无需进入容器
• 插件安装：将插件文件放入宿主机挂载的/data/plugins目录，容器重启后生效

参考文档

• 官方GitHub仓库：[***]
• 官方文档：[***]