goobaroo/allthemods7 Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

ATM7-1.0.4 Docker镜像文档

镜像概述

本镜像用于部署Curseforge上的ATM7-1.0.4模组化Minecraft服务器。容器设计初衷为Unraid服务器环境，其他系统使用效果可能不同。首次运行时会自动下载并安装指定版本的服务器文件，后续启动则直接运行服务器。镜像本身不包含任何Minecraft模组文件，所有必要文件均在运行时下载。

核心功能与特性

• 自动部署：首次启动自动下载并安装ATM7-1.0.4服务器文件
• 持久化存储：通过挂载/data目录保存服务器数据（世界、配置等）
• 灵活配置：支持通过环境变量自定义JVM参数、服务器描述、世界名称等
• 操作员管理：可通过环境变量快速添加Minecraft服务器操作员

使用要求

• 存储：需将/data目录挂载至持久化磁盘（保存服务器数据）
• 网络：映射25565/tcp端口（Minecraft默认服务器端口）
• 许可协议：必须设置环境变量EULA="true"以接受Mojang的EULA（用户需自行承担接受EULA的责任，容器默认EULA为false）

使用方法与配置说明

Docker Run命令示例

bash
docker run -d \
  --name atm7-server \
  -p 25565:25565/tcp \
  -v /path/to/persistent/data:/data \
  -e EULA="true" \
  -e JVM_OPTS="-Xms3072m -Xmx6144m" \
  -e MOTD="我的ATM7服务器" \
  -e LEVEL="my_world" \
  -e OPS="Player1,Player2" \
  goobaroo/allthemods7:latest

Docker Compose配置示例

yaml
version: '3'
services:
  atm7-server:
    image: goobaroo/allthemods7:latest
    container_name: atm7-server
    ports:
      - "25565:25565/tcp"
    volumes:
      - /path/to/persistent/data:/data
    environment:
      - EULA="true"
      - JVM_OPTS="-Xms3072m -Xmx6144m"  # 自定义JVM内存设置
      - MOTD="ATM7模组服务器 - 欢迎加入"  # 服务器列表显示的描述
      - LEVEL="survival_world"  # 世界名称
      - OPS="AdminPlayer,ModeratorPlayer"  # 服务器操作员列表
    restart: unless-stopped

环境变量配置

故障排除

EULA未接受

问题：服务器无法启动，日志提示EULA未接受。
解决：确保启动容器时设置环境变量EULA="true"以接受Mojang的最终用户许可协议。

文件权限问题

问题：在非Unraid系统上出现文件读写权限错误。
原因：容器内运行用户的UID为99，GID为100，可能与宿主机权限不匹配。
解决：调整宿主机/data目录权限，确保UID 99和GID 100有读写权限。

安装/升级失败

问题：服务器安装或升级过程中断或失败。
解决：删除/data目录中已下载的服务器文件，重启容器以重新触发安装/升级流程。

源码与镜像来源

• GitHub仓库：[***]
• Docker镜像：[***]