alecrux/minecraft-server

Minecraft Server Docker镜像使用指南

镜像概述

本镜像提供了便捷的Minecraft服务器运行环境，支持数据持久化存储、插件扩展和远程管理功能，帮助用户快速搭建稳定的游戏服务器。

核心功能

1. 数据持久化：通过本地目录挂载保存服务器配置、世界数据和插件文件；
2. 插件支持：可添加Bukkit等生态插件增强服务器玩法；
3. 便捷管理：提供容器命令执行、日志查看和rcon远程管理工具；
4. 灵活部署：支持新建服务器或导入已有服务器数据。

使用场景

1. 个人搭建私人服务器与好友联机游戏；
2. 小团队测试游戏插件或服务器配置；
3. 快速部署临时游戏服务器用于活动或测试。

配置说明

安装新服务器

bash
mkdir ./minecraft-data
docker run --name minecraft-server -v ./minecraft-data/:/minecraft-data/ -p 25565:25565 -d docker.xuanyuan.run/alecrux/minecraft-server:latest

之后可将插件放入./minecraft-data/plugins/目录（插件可从Bukkit平台获取）。

导入已有服务器数据

将./minecraft-data替换为已有服务器数据的本地路径即可：

bash
docker run --name minecraft-server -v /path/to/your/server/data:/minecraft-data/ -p 25565:25565 -d docker.xuanyuan.run/alecrux/minecraft-server:latest

故障排除

1. 连接容器执行命令：

bash
docker exec -it minecraft-server /bin/bash

2. 查看服务器日志：

bash
docker logs minecraft-server

3. 使用rcon远程管理（以授予玩家Steve管理员权限为例）：

bash
# 启用rcon并设置密码
sed -i 's/enable-rcon=false/enable-rcon=true/' minecraft-data/server.properties
sed -i 's/rcon.password=/rcon.password=mystrongpassword/' minecraft-data/server.properties
# 重启服务器生效
docker stop minecraft-server && docker start minecraft-server
# 执行rcon命令
docker exec -it minecraft-server /home/minecraft/rcon/rcon -a 127.0.0.1:25575 -p mystrongpassword "op Steve"