Skip to main content
[ PIER ]

Minecraft 服务器

一键托管的 Java Edition Minecraft 服务器。

Service #game#server#minecraft#java

基于 itzg/minecraft-server 镜像的 Pier 托管 Minecraft Java Edition 服务器 —— 事实标准的 Minecraft Docker 镜像。首次启动时自动下载所选 Minecraft 版本，支持 vanilla / PaperMC / Spigot / Forge / Fabric / Bukkit 风味，可配置难度 / 游戏模式 / 世界类型，并跨重启持久化世界。

使用 Pier 部署

  1. 1 打开 Pier 控制台，点击 Add service。
  2. 2 从模板列表中选择 Minecraft Server。
  3. 3 选择版本、设置服务名称，Pier 会自动配置容器、存储和端口。
  4. 4 如需 HTTPS，请绑定域名。Traefik 会自动签发 Let's Encrypt 证书。

什么是 Pier 托管的 Minecraft 服务器？

本模板包装维护良好的 itzg/minecraft-server 镜像 —— 社区标准的 Minecraft Docker 镜像 —— 并将常见配置旋钮公开为 Pier env vars。你选择 Minecraft 版本、 服务器风味（vanilla、PaperMC、Forge、Fabric…）、游戏模式和难度，Pier 配置、持久化世界并在崩溃时重启。

仅 Minecraft Java Edition —— 对于 Bedrock（口袋 / 控制台版本），使用 PaperMC 服务器上的 Geyser 插件或单独的 Bedrock 模板。

Pier 如何部署它

默认端口：25565/tcp（标准 Minecraft 端口）。数据卷挂载在 /data —— 世界 文件、server.properties、mod、插件、玩家数据都在那里持久化。

首次启动时镜像自动下载所选 Minecraft 版本服务器 JAR（或 paper/forge/fabric 变体）并使用你的 env-var 配置启动服务器。后续启动重用本地副本。

镜像公开的 env vars 涵盖常见情况（EULA=TRUE 预设、DIFFICULTY、MODE、MOTD、 MAX_PLAYERS、WHITELIST、OPS、MEMORY）。未公开的任何内容可在 /data/server.properties （已挂载）中实时编辑。

何时不要使用本模板

对于 Bedrock Edition（移动/控制台交叉播放）没有 Java 客户端，使用 Bedrock Dedicated Server 模板。对于带漂亮控制面板和一键备份的零运维托管，Realms 或 Apex Hosting 可能更适合休闲用户。对于”我想在我已经拥有的 VPS 上便宜地运行 我自己的 Minecraft 服务器”，本模板是正确的答案。

核心功能

自动版本下载

选择版本（latest、1.21、1.20 等），镜像在首次启动时下载相应的服务器 JAR。升级是 UI 中的版本更改加重启。

Vanilla 和带 mod

默认是 vanilla。通过 TYPE env var 切换到 PaperMC、Spigot、Bukkit、Forge、Fabric、Quilt 或 Magma。Mods/插件放入挂载的 /data/mods 或 /data/plugins。

世界持久化

数据卷挂载在 /data —— 你的世界、玩家、关卡数据、mod 跨重启和版本更改持久化。像任何其他卷一样备份。

白名单 + 操作员配置

标准 server.properties 选项作为 env vars 公开 —— WHITELIST、OPS、MOTD、DIFFICULTY、MODE、MAX_PLAYERS。在 Pier env 设置中实时编辑。

自动 EULA 接受

EULA=TRUE env var 预设，服务器在首次启动时无需手动 eula.txt 编辑即可启动。

Java 17 / Java 21 变体

对旧/新 Minecraft 版本使用 java17 或 java21 镜像标签。默认标签为所选 Minecraft 版本使用适当的 Java。

应用场景

朋友群 / 家庭服务器

小群体的仅白名单服务器。Pier 处理任何添加的 Web 地图插件（Dynmap、BlueMap）的 HTTPS。

带 mod 服务器（Forge / Fabric）

设置 TYPE=FORGE 或 TYPE=FABRIC，挂载 mod，为 modpacks 需要的更大堆设置 MEMORY。

PaperMC 用于性能

TYPE=PAPER 用高性能 Paper 分叉替换 vanilla。插件进入 /data/plugins。

迷你游戏 / 社区服务器

带迷你游戏插件的公共服务器。使用 PaperMC + Citizens + 你选择的插件。

一次性测试服务器

启动服务器，测试 mod 或种子，销毁它。数据卷使恢复便宜。

代码示例

基本 vanilla 1.21 服务器 text 
VERSION = LATEST
TYPE = VANILLA
DIFFICULTY = normal
MODE = survival
MOTD = 我的仅朋友服务器
MAX_PLAYERS = 20
WHITELIST = alice,bob,charlie
OPS = alice
PaperMC 带 4 GB 堆 text 
VERSION = 1.21.3
TYPE = PAPER
MEMORY = 4G
DIFFICULTY = hard
Fabric 带 mod 服务器 text 
VERSION = 1.20.4
TYPE = FABRIC
MEMORY = 6G
# 然后将 mod 放入挂载的 /data/mods 卷
通过 docker exec 的服务器控制台 bash 
docker exec pier-minecraft rcon-cli list
docker exec pier-minecraft rcon-cli op alice
docker exec pier-minecraft rcon-cli save-all

对比

vs Realms (Mojang 托管的 Minecraft) Realms 是 SaaS，简单，成本约 8 美元/月，有 10 人帽和有限的 mod 支持。自托管提供无限玩家、每个插件/mod、你自己的备份，如果你已有 VPS 每月更便宜。
vs Aternos / Apex Hosting Aternos 免费但有广告，会话之间你的服务器睡眠。Apex/Shockbyte 是付费托管的 Minecraft 主机，约 5-20 美元/月。自托管成本相当且更多控制。
vs Bedrock Dedicated Server 本模板仅 Java Edition。对于 Bedrock（移动/控制台交叉播放）使用单独的模板或 Geyser 插件桥接。

常见问题

服务器是公开可达的吗？
Pier 公开端口 25565/tcp。如果你在 NAT 后面，在路由器上端口转发 25565。否则服务器公开列出（或带 WHITELIST 设置的仅白名单）。
如何添加操作员？
在 env 中设置 OPS=alice,bob，或在服务器运行后使用 rcon-cli（docker exec ... rcon-cli op alice）。
它自动运行 mod 吗？
对于 Forge/Fabric，mod 进入 /data/mods（挂载的卷）。一些 modpacks 需要额外的配置文件 —— 按 modpack 指示放入 /data。
内存要求？
Vanilla 4-8 玩家 —— 1 GB 堆足够。插件/modpacks —— 根据复杂度 2-8 GB。在 env 中设置 MEMORY=4G。
如何备份世界？
停止容器，快照 /data 卷，重启。或使用 rcon-cli save-all 并热复制 world/ 文件夹。
崩溃时自动重启？
Pier 设置 restart=unless-stopped —— 容器在崩溃时自动重启。
Web 地图 (Dynmap / BlueMap)？
在 /data/plugins (PaperMC/Spigot) 中安装插件，公开其端口，在 Pier 中附加域名以获得 HTTPS。

相关服务

在你的 VPS 上部署

基于 itzg/minecraft-server 镜像的 Pier 托管 Minecraft Java Edition 服务器 —— 事实标准的 Minecraft Docker 镜像。首次启动时自动下载所选 Minecraft 版本，支持 vanilla / PaperMC / Spigot / Forge / Fabric / Bukkit 风味，可配置难度 / 游戏模式 / 世界类型，并跨重启持久化世界。

部署此服务 →