dottedquad/tekkit

镜像概述

本镜像基于Michael Crosby的Docker教程（含高级Docker卷教程及相关Dockerfiles），提供Minecraft、Tekkit、Hexxit服务器及Overviewer在线地图的容器化运行方案，帮助管理员快速部署和管理游戏服务器，同时支持在线地图展示与更新。

核心功能

1. 支持Minecraft、Tekkit、Hexxit多版本服务器容器化运行
2. 集成Overviewer在线地图生成工具，实时展示游戏世界
3. 提供容器自动保存机制，降低崩溃数据丢失风险
4. 通过定时任务实现地图定时更新，保持数据最新
5. 支持日志查看、容器导出/导入，方便服务器维护

使用场景

• Minecraft服务器管理员快速部署多版本游戏服务器
• 需要在线地图展示的玩家社区或游戏服务器
• 学习Docker容器化技术在游戏服务器中的应用

配置说明

前置要求

1. 已安装Docker环境
2. 具备基础Docker和Linux操作知识

构建镜像

bash
# 构建Tekkit镜像
cd tekkit && sudo docker build -t 'tekkit' .

# 构建Hexxit镜像
cd ../hexxit && sudo docker build -t 'hexxit' .

# 构建地图服务器镜像
cd ../mapserver && sudo docker build -t 'mapserver' .

# 构建Overviewer镜像
cd ../overviewer && sudo docker build -t 'overviewer' .

运行容器

Tekkit服务器（含初始地图生成）

bash
# 启动Tekkit服务器（主端口25565）
TEKKIT=$(sudo docker run -p 25565:25565 -d --name='tekkit_v1' tekkit)
# 启动地图服务器（端口8000）
MAPSERVER=$(sudo docker run -p 8000:8000 -d --name='tekkit_v1_map' mapserver)
# 初始地图生成（首次运行耗时较长）
sudo docker run --volumes-from tekkit_v1 --volumes-from tekkit_v1_map --name='tekkit_mapgen' overviewer;

Hexxit服务器（含初始地图生成）

bash
# 启动Hexxit服务器（备用端口25566）
HEXXIT=$(sudo docker run -p 25566:25565 -d --name='hexxit_v1' hexxit)
# 启动地图服务器（备用端口8001）
MAPSERVER=$(sudo docker run -p 8001:8000 -d --name='hexxit_v1_map' mapserver)
# 初始地图生成
sudo docker run --volumes-from hexxit_v1 --volumes-from hexxit_v1_map --name='hexxit_mapgen' overviewer;

定时任务设置

地图定时更新（每10分钟一次）

bash
crontab -e
# 添加以下内容
*/10 * * * * sudo docker run --volumes-from tekkit_v1 --volumes-from tekkit_v1_map --name='tekkit_mapgen' overviewer;
*/10 * * * * sudo docker run --volumes-from hexxit_v1 --volumes-from hexxit_v1_map --name='hexxit_mapgen' overviewer;

容器自动保存（每5分钟一次）

bash
crontab -e
# 添加以下内容
*/5 * * * * DOCKER_TAG=tekkit && sudo docker commit -m "$(date +%F_%Hh%Mm%Ss) autosave" tekkit_v1 $DOCKER_TAG:autosave
*/5 * * * * DOCKER_TAG=hexxit && sudo docker commit -m "$(date +%F_%Hh%Mm%Ss) autosave" hexxit_v1 $DOCKER_TAG:autosave

日志查看

• 实时日志：sudo docker attach tekkit_v1（Ctrl+Z断开）
• 全部日志：sudo docker logs tekkit_v1

容器导出

bash
sudo docker export tekkit_v1 > ~/tekkit_server_container.tgz

导入旧地图

在Dockerfile中用ADD命令将旧地图文件添加到/minecraft/world目录，重新构建镜像后重启容器即可。

bash
# Dockerfile示例（添加旧地图）
ADD ./old_world /minecraft/world