marctv/minecraft-papermc-server

Docker Minecraft JAVA PaperMC 服务器 1.20+

适用于1.20、1.19、1.18、1.17版本的Docker Minecraft PaperMC服务器，支持AMD64和ARM64平台。可在Synology、Raspberry Pi 4或任何支持Docker的系统上运行。

快速开始

sh
docker run --rm --name mcserver -e MEMORYSIZE='1G' -v /home/joe/mcserver:/data:rw -p 25565:25565 -i docker.xuanyuan.run/marctv/minecraft-papermc-server:latest

服务器将在/home/joe/mcserver目录中生成所有数据，包括世界和配置文件。请将此路径更改为您的现有文件夹。

Docker Run 命令

shell
docker run -d \
  --name mcserver \
  --restart=unless-stopped \
  -e MEMORYSIZE="1G" \
  -p 25565:25565/tcp \
  -p 25565:25565/udp \
  -v /home/docker/mcserver:/data:rw \
  docker.xuanyuan.run/marctv/minecraft-papermc-server:latest

Docker Compose（Portainer Stacks）

yaml
version: "3"
services:
  minecraft:
    image: docker.xuanyuan.run/marctv/minecraft-papermc-server:latest
    restart: always
    container_name: "mcserver"
    environment:
      MEMORYSIZE: "1G"
      PAPERMC_FLAGS: ""
    volumes:
      - minecraftserver:/data
    ports:
      - "25565:25565"
    # 以下配置允许使用`docker attach minecraft`连接容器
    stdin_open: true
    tty: true
volumes:
  minecraftserver:

如何更新容器？

在Synology DSM上

• 从Docker仓库重新下载镜像。
• 停止容器。
• 清除容器。
• 启动容器。

在终端上

sh
docker pull docker.xuanyuan.run/marctv/minecraft-papermc-server:latest
docker stop mcserver

或者使用工具：https://containrrr.dev/watchtower/

以非root用户运行

您可以通过id username命令获取所需的UID/GID（xxx），然后在docker run命令中添加以下参数：

sh
-e PUID=xxx
-e PGID=xxx

跳过权限更改步骤

如果您有大型自定义Minecraft安装（例如多个生成文件的插件），更改所有权可能需要大量时间。如果您确保文件已拥有通过上述环境变量传递的UID/GID所需的权限，可以添加以下变量跳过此步骤：

sh
-e SKIP_PERM_CHECK=true

Docker Compose 使用命令

如果您偏好使用docker-compose，可使用以下命令：

启动服务器：

sh
docker-compose up

停止服务器：

sh
docker-compose stop

附加到容器并执行服务器命令：

sh
docker attach mcserver
# 然后可以输入命令，如"list"
list
# 查看当前在线玩家，或使用
help
# 查看所有可用命令

如何使用带Docker Compose的Makefile

此外，提供了Makefile以方便启动、停止和附加到容器：

sh
make start     # 等效于 `docker-compose up -d --build`
make stop      # 等效于 `docker-compose stop --rmi all --remove-orphans`
make attach    # 等效于 `docker attach mcserver`
make help      # 打印帮助信息

环境变量

MEMORYSIZE = 1G

容器内存大小，建议不超过您RAM的70%。这是Minecraft服务器在容器内使用的内存，不包括操作系统占用。

TZ = Europe/Berlin

设置容器时区。有效时区值列表可参考***：[***]

PAPERMC_FLAGS = --nojline

可选：设置PaperMC的命令行标志。如果希望启用服务器控制台的颜色和制表符补全，请删除--nojline。

JAVAFLAGS

可选：使用自定义参数覆盖优化的Java配置。可通过此参数设置自己的Xms和Xmx值。

Synology教程

教程（德语）[***]

![观看视频]([***]

[***]

树莓派4安装方法

树莓派4视频教程

![观看视频]([***]

[***]

树莓派4安装步骤

您可以使用专用安装程序安装此Docker容器：https://github.com/mtoensing/RaspberryPiMinecraftDocker 或按照以下步骤操作：

1. 下载 Raspberry Pi Imager [***] 并启动。
2. 在“Raspberry Pi OS (other)”下选择Raspberry Pi OS lite（64位）。
3. 点击Raspberry Pi Imager中的齿轮图标，启用ssh并设置用户名和密码。
4. 将镜像写入高速SD卡。
5. 将树莓派4通过网线连接。
6. 使用Windows的putty或macOS的终端通过ssh连接：

sh
ssh pi@raspberrypi

7. 升级所有软件包

sh
 sudo apt update && sudo apt upgrade
 sudo reboot now

树莓派将重启。

8. 安装Docker

sh
curl -fsSL https://get.docker.com -o get-docker.sh
chmod +x get-docker.sh
./get-docker.sh
sudo apt-get install -y uidmap
dockerd-rootless-setuptool.sh install
sudo usermod -aG docker $USER
sudo systemctl enable docker
newgrp docker

9. 创建服务器文件夹

sh
cd
mkdir mcserver

10. 运行此镜像作为Minecraft服务器

sh
docker run -d \
--restart unless-stopped \
--name mcserver \
-e MEMORYSIZE='1G' \
-e PAPERMC_FLAGS='' \
-v /home/pi/mcserver:/data:rw \
-p 25565:25565 \
-it docker.xuanyuan.run/marctv/minecraft-papermc-server:latest

服务器将在/home/pi/mcserver目录中生成所有数据，包括世界和配置文件。

11. 进入Minecraft服务器命令行

sh
docker attach mcserver

在此处，您可以使用Minecraft服务器命令，如whitelist add [username]。

致谢

GitHub地址：https://github.com/mtoensing/Docker-Minecraft-PaperMC-Server

此服务器在线地址：[***]

基于https://github.com/FelixKlauke/paperspigot-docker%E7%9A%84%E5%B7%A5%E4%BD%9C%EF%BC%8C%E6%84%9F%E8%B0%A2%E6%82%A8%E7%9A%84%E5%B8%AE%E5%8A%A9%EF%BC%81