跳到内容
Minecraft

安装 Minecraft 服务器

本指南在 Windows 或 Ubuntu/Debian Linux VPS 上安装 Minecraft Java 版服务器(Vanilla 或 Paper),开放 25565 端口并设置自动启动。大约需要 20–40 分钟;关键在于内存(少量玩家建议至少 4 GB,装插件需更多)以及与游戏版本匹配的 Java 版本。

最后更新:2026/10/9

本指南在 Windows 或 Ubuntu/Debian Linux VPS 上安装 Minecraft Java 版服务器(Vanilla 或 Paper),开放 25565 端口并设置自动启动。大约需要 20–40 分钟;关键在于内存(少量玩家建议至少 4 GB,装插件需更多)以及与游戏版本匹配的 Java 版本。

分步安装

  1. 选择服务端:Vanilla(Mojang 官方)或 Paper(支持插件,性能更好)。

  2. 安装您的 Minecraft 版本所需的 Java。

  3. 创建专用文件夹并放入服务端 .jar。

  4. 用 java -Xms -Xmx -jar … --nogui 首次启动;服务器会提示接受 EULA 后停止。

  5. 把 eula.txt 改为 eula=true 后重启:世界生成并创建 server.properties。

  6. 本地测试:多人游戏 > 添加服务器 > localhost。

  7. 用本站工具配置 server.properties(online-mode、white-list、motd、max-players 等)。

  8. 在本机、服务商和路由器防火墙中开放 25565/TCP 端口。

  9. 创建 systemd 服务(Linux)实现开机自启与崩溃恢复。

  10. 安排备份与重启,并在 game-rank.com 添加您的服务器。

1. 前提条件

需求随玩家数和插件差异很大;下列内存数字仅供参考,PaperMC 文档建议应用其参数时配置 6–10 GB,与玩家数量无关。

  • Java:据 PaperMC,当前 Paper 需要 Java 25 或更高;1.20–1.21.11 使用 Java 21,1.17–1.19 使用 Java 17。请在 PaperMC 的 Getting started 页面核对您的版本。
  • 系统:Windows 10/11、Windows Server 或 Linux(本指南使用 Ubuntu/Debian);CPU:单核性能最重要(游戏主要是单线程)。
  • 内存(参考):少量玩家且无插件 2–4 GB;社区服 6–10 GB 以上(参见 Aikar's flags)。为系统保留 1–1.5 GB。磁盘:SSD,数 GB 加世界大小。
  • 账号:托管无需许可证密钥,但 online-mode=true 时玩家必须拥有 Minecraft Java 版。您需要接受 Minecraft EULA。

2. 本地安装(Windows)

从 minecraft.net(服务端下载页)下载 Vanilla jar,或从 papermc.io/downloads 下载 Paper,放入如 C:\minecraft 的空文件夹。按下面内容创建 start.bat(调整 jar 名称和内存,或用本站“launch-flags”工具生成),运行后在 eula.txt 中设置 eula=true 再次运行。使用地址 localhost 连接。

@echo off
cd /d C:\minecraft
java -Xms4G -Xmx4G -jar paper.jar --nogui
pause

3. 在 Linux VPS 上安装(Ubuntu/Debian)

创建专用的非 root 用户,安装 Java(openjdk 软件包需与所需版本一致;发行版没有对应版本时,使用 Adoptium 等 JDK 供应商的软件源),然后从 papermc.io/downloads 复制所需构建的链接下载 jar。请将 <JAR 链接> 替换为该链接。

sudo adduser --system --group --home /opt/minecraft minecraft
sudo apt update && sudo apt install -y openjdk-21-jre-headless curl
sudo -u minecraft mkdir -p /opt/minecraft
sudo -u minecraft curl -L -o /opt/minecraft/paper.jar "<JAR_URL>"
# Generate start.sh with the launch-flags tool, then:
sudo chmod +x /opt/minecraft/start.sh
cd /opt/minecraft && sudo -u minecraft ./start.sh   # first run, then set eula=true in eula.txt

4. 需要开放的端口

默认值取自 Minecraft Wiki(server.properties)。修改端口请编辑 server-port、query.port、rcon.port;修改后请开放新端口。

  • 25565/TCP — 玩家连接(server-port)。需要开放。
  • 25565/UDP — “query” 查询(enable-query 默认 false;query.port 为 UDP 端口)。仅在启用时开放。
  • 25575/TCP — RCON(enable-rcon 默认 false)。切勿暴露到互联网,仅限本地或 VPN 内使用。
  • 服务商防火墙(OVH、Hetzner、Scaleway 等的“安全组”/网络防火墙):除系统防火墙外,也要在此放行 25565/TCP。
  • 本地托管:在路由器上把 25565/TCP 转发到电脑的内网 IP(NAT)。测试:在外部网络(移动数据)中于 Minecraft 添加公网 IP,或运行“nc -vz IP 25565”。
# Linux (ufw)
sudo ufw allow 25565/tcp
sudo ufw status

# Windows (PowerShell administrateur / admin)
# netsh advfirewall firewall add rule name="Minecraft Java" dir=in action=allow protocol=TCP localport=25565

5. 自动启动(systemd 服务)

将此文件保存为 /etc/systemd/system/minecraft.service,然后执行:sudo systemctl daemon-reload && sudo systemctl enable --now minecraft。停止时 systemd 发送 SIGTERM,Java 服务端会捕获并正常保存世界。请关闭 start.sh 的重启循环(由 Restart=on-failure 负责)。需要交互式控制台时请改用 screen/tmux 或 RCON;Windows 上用“启动时”计划任务运行 start.bat 即可。替代方案:使用本站 docker-compose 工具的 Docker。

[Unit]
Description=Minecraft Java server
After=network-online.target
Wants=network-online.target

[Service]
User=minecraft
WorkingDirectory=/opt/minecraft
ExecStart=/opt/minecraft/start.sh
Restart=on-failure
RestartSec=10
TimeoutStopSec=120

[Install]
WantedBy=multi-user.target

6. 更新、备份与重启

更新:停止服务器、备份、将 .jar 替换为新版本(同名或修改 start.sh)后重启,并确认 Java 版本仍然兼容。使用 Paper 时,大版本升级前请阅读发行说明。下面的脚本在服务器停止状态下归档世界(比热拷贝更安全);可用 cron 安排,例如每晚 4 点,并清理旧归档。

#!/bin/bash
# /opt/minecraft/backup.sh (run as root via cron: 0 4 * * * /opt/minecraft/backup.sh)
set -e
systemctl stop minecraft
mkdir -p /opt/minecraft-backups
tar -czf /opt/minecraft-backups/world-$(date +%F).tar.gz -C /opt/minecraft world world_nether world_the_end
systemctl start minecraft
find /opt/minecraft-backups -name 'world-*.tar.gz' -mtime +14 -delete

7. 提交并推广您的服务器

服务器可从外网访问后,请到 game-rank.com/jeux/minecraft(这些工具所有者的网站)添加,方便玩家找到。请提供稳定地址(域名或固定 IP),端口非 25565 时一并填写。

8. 故障排查

  • “You need to agree to the EULA”:在 eula.txt 中设置 eula=true 后重启。
  • UnsupportedClassVersionError / “class file version”:Java 版本对该 jar 过旧。请安装所需版本(见前提条件),并用“java -version”确认。
  • “Failed to bind to port”:25565 端口已被占用(其他服务器或旧进程)。请结束该进程或修改 server-port。
  • 本地玩家能进、外网玩家进不来:缺少系统或服务商防火墙规则,或未做端口转发;还要确认是否处于 CGNAT(运营商路由器无公网 IP)之下,此时请改用 VPS。
  • “Can't keep up!”与卡顿:服务器过载。请使用 Paper,应用 Aikar's flags,降低 view-distance 和 simulation-distance,并用 spark 分析器观察 TPS。

常见问题

选 Vanilla 还是 Paper?
Vanilla 是 Mojang 官方软件;Paper 是支持插件并优化性能的社区服务端,是社区服务器的常见选择。两者使用相同的 server.properties。
基岩版玩家能加入吗?
不能直接加入:Java 版与基岩版协议不同。存在社区方案(非官方,需另行研究);否则请另外搭建基岩版专用服务器(见本站 Bedrock 指南)。
需要保持 online-mode=true 吗?
是,除非位于配置正确的代理(Velocity/BungeeCord)之后。设为 false 会关闭账号验证,任何人都能冒用他人名称,包括管理员。
我的服务器能承载多少玩家?
主要取决于单核 CPU、视距、插件和世界大小。没有官方数字:请逐步增加并观察 TPS(20 为理想)与内存。

Minecraft 服务器工具

server.properties 编辑器 工具截图Minecraft免登录
配置 Minecraft Java 服务器:玩家、世界、性能、白名单和 RCON。
配置Java 版打开
文档
Minecraft
Minecraft免登录
为 Paper、Purpur、Fabric 或 Vanilla 生成 start.sh:内存、Aikar's flags、--nogui、自动重启和 GC 日志。
启动性能打开
文档
Minecraft
Minecraft免登录
创建带实时预览的两行彩色 MOTD:§ 代码、十六进制颜色、server.properties 行和 MiniMessage。
MOTD颜色打开
文档
Minecraft
Minecraft需要登录
编辑 Bukkit、Spigot 和 Paper 的 YAML 文件,提供常用键说明、默认值及缩进错误检测。
YAML配置打开
文档
Minecraft
Minecraft免登录
根据用户名列表生成 whitelist.json 和 ops.json,离线 UUID 在本地计算,无需联网或调用 Mojang。
玩家管理打开
文档
Minecraft
Minecraft免登录
计算 Minecraft 世界边界的半径、区块数、区域数、预生成时间、磁盘空间和已加载区块。
世界性能打开
文档
Minecraft
Minecraft免登录
为 itzg/minecraft-server 镜像生成 docker-compose.yml:服务端类型、版本、内存、玩家、RCON、OP 和白名单。
Docker部署打开
文档