目录
- 准备工作
- 选择服务器操作系统
- 硬件要求
- 软件要求
- 连接到你的服务器
- 安装 Java 运行时环境
- 检查系统自带的 Java
- 安装 OpenJDK (推荐)
- 下载并启动 Minecraft 服务器
- 创建服务器目录
- 下载服务器软件
- 第一次启动与同意 EULA
- 启动服务器
- 基本服务器配置
server.properties文件详解whitelist.json(白名单) 配置ops.json(管理员) 配置
- 使用 Screen/Tmux 实现后台运行
- 安装 Screen
- 使用 Screen 管理服务器
- 安装和管理插件
- 什么是插件？
- 安装插件管理器 (Paper-clip)
- 安装和管理插件
- 创建启动脚本 (Systemd)
- 创建服务文件
- 启用和管理服务
- 常见问题与故障排除
- 服务器启动失败或卡住
- 内存不足错误
- 玩家无法连接
- 如何备份世界数据
- 进阶推荐
- 选择更好的服务器软件
- 使用反向代理
- 自动备份脚本
准备工作
选择服务器操作系统
对于大多数用户，Ubuntu Server 22.04 LTS 是一个绝佳的选择，它拥有庞大的社区支持、文档丰富，并且非常稳定，本教程将以 Ubuntu 为例，但大部分命令也适用于其他 Debian/Ubuntu 系列发行版（如 Debian）。
硬件要求
这取决于你计划服务器的规模：
| 服务器类型 | 玩家数量 | CPU | RAM (内存) | 硬盘空间 | 备注 |
|---|---|---|---|---|---|
| 小型/个人 | 1-5 | 1 核心 | 1-2 GB | 1 GB | 适合朋友或家人一起玩 |
| 中型/社区 | 5-20 | 2-4 核心 | 4-8 GB | 10+ GB | 需要安装一些插件 |
| 大型/公共 | 20+ | 4+ 核心 | 8+ GB | 50+ GB | 需要高性能硬件和优化 |
提示: 硬盘速度（特别是 SSD）对服务器性能有很大影响,尤其是在生成新世界时。
软件要求
- 一台可以 24/7 开机的 Linux 服务器（可以是 VPS、云服务器或自建主机）。
- 服务器的公网 IP 地址。
- 在服务器上拥有
sudo权限的非 root 用户。
连接到你的服务器
使用 SSH (Secure Shell) 连接到你的服务器，在 Windows 上，可以使用 PowerShell 或 PuTTY；在 macOS 或 Linux 上,可以直接使用内置的终端。
# 格式: ssh username@your_server_ip ssh user@123.45.67.89
输入密码后,你就成功登录到你的服务器命令行了。
安装 Java 运行时环境
Minecraft 服务器是 Java 程序，必须安装 Java 才能运行。
检查系统自带的 Java
有时系统会预装 OpenJDK，但版本可能不匹配或配置不完善,我们先检查一下：
java -version
如果输出版本信息，说明已安装，但为了确保最佳性能和兼容性，我们推荐手动安装最新的 LTS 版本。
安装 OpenJDK (推荐)
我们安装 OpenJDK 17，这是目前 Minecraft 1.17+ 版本的官方推荐版本。
-
更新软件包列表:
sudo apt update
-
安装 OpenJDK 17:
sudo apt install openjdk-17-jdk -y
-
验证安装:
java -version
你应该会看到类似
openjdk version "17.0.x"的输出。
下载并启动 Minecraft 服务器
创建服务器目录
为了保持文件整洁，我们在 /home 下创建一个专门的服务器文件夹。
mkdir ~/minecraft_server cd ~/minecraft_server
下载服务器软件
我们使用 Paper 服务器软件，它是原版 Spigot 的高性能分支，性能优异,并且支持大量插件。
- 访问 Paper 官网：https://papermc.io/downloads
- 找到最新的 "Latest Builds" 版本，复制其下载链接（
20.2的最新版本）。 - 在服务器上使用
wget下载：# 将下面的 URL 替换为你从官网复制的最新链接 wget https://api.papermc.io/v2/projects/paper/versions/1.20.2/builds/556/downloads/paper-1.20.2-556.jar
下载完成后，你会得到一个类似
paper-1.20.2-556.jar的文件。
第一次启动与同意 EULA
当你第一次运行服务器 JAR 文件时，它会生成必要的配置文件，并在控制台打印出错误信息,告诉你必须同意最终用户许可协议。
-
启动服务器:
java -Xms1G -Xmx1G -jar paper-1.20.2-556.jar nogui
-Xms1G: 设置初始堆内存大小为 1GB。-Xmx1G: 设置最大堆内存大小为 1GB。请根据你的服务器内存调整此值，4GB 内存的服务器可以设置为-Xmx3G(留一部分给系统)。nogui: 禁用内置的图形界面,因为我们是在服务器上运行。
-
同意 EULA: 服务器会立即停止，并在当前目录下生成一个
eula.txt文件，用nano编辑器打开它：nano eula.txt
将文件中的
eula=false修改为eula=true，然后按Ctrl + X，按Y保存，最后按Enter确认。
启动服务器
再次运行启动命令,服务器就会开始加载世界。
java -Xms1G -Xmx1G -jar paper-1.20.2-556.jar nogui
看到 Done 字样后，服务器就成功启动了！现在你的朋友可以通过你的公网 IP 和默认端口 25565 连接了。
基本服务器配置
服务器文件都存放在 ~/minecraft_server 目录下。
server.properties 文件详解
这是服务器的主要配置文件，你可以用 nano 打开它进行修改：
nano server.properties
一些常用选项：
server-name: 服务器在列表中显示的名称。motd: 服务器在列表中显示的描述信息。gamemode: 游戏模式 (survival,creative,adventure,spectator)。difficulty: 难度 (peaceful,easy,normal,hard)。white-list: 是否开启白名单 (true/false)。pvp: 是否允许玩家对战 (true/false)。max-players: 最大玩家数量。server-ip: 绑定 IP 地址，留空则默认为0.0.0(监听所有)。server-port: 服务器端口，默认25565。
whitelist.json (白名单) 配置
为了防止陌生人进入,强烈建议开启白名单。
- 在
server.properties中设置white-list=true。 - 重启服务器后，使用命令
/whitelist add <玩家名>来添加玩家，你可以在游戏内输入,也可以在服务器控制台输入。 - 玩家首次加入时，其 Minecraft 账户名会被自动添加到
whitelist.json文件中。
**ops.json (管理员) 配置`
这个文件列出了
