Minecraft Linux Fabric 服务器搭建教程

（4）安装辅助工具（可选但推荐）

• screen：用于后台运行服务器（关闭终端不中断服务）。
• wget：用于命令行下载文件。

# Ubuntu/Debian
sudo apt install screen wget -y
# CentOS/Rocky Linux
sudo dnf install screen wget -y

二、创建独立服务器目录（避免文件混乱）

建议创建单独的目录存放服务器文件，方便管理和备份：

# 创建目录（可自定义路径，示例为用户目录下的 minecraft-fabric-server）
mkdir -p ~/minecraft-fabric-server
# 进入目录
cd ~/minecraft-fabric-server

三、下载 Fabric 核心文件

1. 下载 Fabric Server Launcher（核心启动器）

访问官网 https://fabricmc.net/use/server/，按以下步骤获取启动器：

方法 1：命令行直接下载（推荐）

• 打开官网后，选择对应你的 Minecraft 版本（例如 1.20.4），点击 'Download Server Jar'，复制下载链接。
  • 说明：-O fabric-server-launcher.jar 是指定下载后的文件名，避免默认乱码。

在服务器目录中执行 wget + 复制的链接，示例（链接需替换为官网最新版）：

wget https://meta.fabricmc.net/v2/versions/loader/1.20.4/0.15.11/1.19.4/server/jar -O fabric-server-launcher.jar

方法 2：本地下载后上传

• 本地浏览器打开官网，下载 fabric-server-launcher.jar，通过 scp 或 FTP 工具上传到服务器的 ~/minecraft-fabric-server 目录。

示例（本地 Windows 命令行，需安装 OpenSSH）：

scp C:\下载\fabric-server-launcher.jar 用户名@服务器 IP:~/minecraft-fabric-server/

2. 下载 Fabric API（必需，多数模组依赖）

• 打开 Fabric API 下载页：https://www.curseforge.com/minecraft/mc-mods/fabric-api
• 选择与 Minecraft 版本 + Fabric 启动器版本 匹配的 Fabric API（例如 1.20.4 对应的最新版），下载 .jar 文件。

将下载的 fabric-api-xxx.jar 上传到服务器的 ~/minecraft-fabric-server/mods 目录（需先创建 mods 文件夹）：

# 创建 mods 目录
mkdir -p ~/minecraft-fabric-server/mods
# 上传示例（本地 → 服务器，替换文件路径和服务器信息）
scp C:\下载\fabric-api-1.20.4-0.91.1+1.20.4.jar 用户名@服务器 IP:~/minecraft-fabric-server/mods/

四、初始化服务器配置

1. 生成基础配置文件

在服务器目录执行以下命令，第一次运行之后就会生成 server.properties、eula.txt 等核心配置文件：

java -jar fabric-server-launcher.jar

• 执行后会提示 You need to agree to the EULA in order to run the server. Go to eula.txt for more info.，表示需要同意用户协议，此时配置文件已生成，进程会退出。

2. 同意 EULA（用户协议）

必须修改 eula.txt 文件，将 eula=false 改为 eula=true，否则服务器无法启动：

方法 1：文本编辑器修改（vim）

vim eula.txt

• 按 i 进入编辑模式，将 eula=false 改为 eula=true。
• 按 Esc，输入 :wq 保存并退出。

方法 2：命令行快速修改

sed -i 's/eula=false/eula=true/g' eula.txt

方法 3：使用 ssh 客户端的文本编辑功能（如 MobaXterm）

• 直接在 MobaXterm 的文件浏览器中找到 eula.txt，双击打开，修改后保存即可。

3. 配置服务器核心参数（server.properties）

编辑 server.properties 文件，自定义服务器设置（关键参数如下，其余可默认）：

vim server.properties

• 核心参数说明（修改后按 Esc + :wq 保存）：

五、编写启动脚本（方便管理）

创建启动脚本 start.sh，避免每次输入长命令，同时设置内存参数：

1. 创建脚本

vim start.sh

2. 写入脚本内容（根据内存调整参数）

#!/bin/bash
# 内存设置：-Xms1G（最小内存），-Xmx4G（最大内存），根据服务器内存调整
java -Xms1G -Xmx4G -jar fabric-server-launcher.jar nogui

• 说明：
  • nogui：关闭图形界面（Linux 服务器必需，无 GUI 环境）。
  • 内存建议：最大内存不超过服务器物理内存的 70%（例如 8GB 内存设为 -Xmx5G）。

3. 赋予脚本执行权限

chmod +x start.sh

六、开放服务器端口（防火墙配置）

1. Ubuntu/Debian（ufw 防火墙）

# 开放 25565 端口（TCP 协议，Minecraft 核心端口）
sudo ufw allow 25565/tcp
# 重启防火墙生效
sudo ufw reload
# 查看防火墙状态（确认端口已开放）
sudo ufw status

2. CentOS/Rocky Linux（firewalld 防火墙）

# 永久开放 25565 端口
sudo firewall-cmd --permanent --add-port=25565/tcp
# 重启防火墙生效
sudo firewall-cmd --reload
# 查看开放的端口
sudo firewall-cmd --list-ports

3. 云服务器额外配置（如阿里云、腾讯云）

• 登录云服务器控制台，进入「安全组」配置，添加入站规则：
  • 端口范围：25565
  • 协议：TCP
  • 授权对象：[0.0.0.0/0]（允许所有 IP 访问，或指定玩家 IP 段）

七、启动服务器并后台运行

1. 使用 screen 后台运行（推荐）

• 启动成功提示：当出现 Done (xxxms)! For help, type "help" 时，服务器已正常运行。
• 后台保持运行：按 Ctrl + A 再按 D，退出 screen 会话（服务器继续后台运行，不会因关闭终端停止）。

进入服务器目录，执行启动脚本：

cd ~/minecraft-fabric-server
./start.sh

新建 screen 会话（命名为 mc-server，方便后续连接）：

screen -S mc-server

2. 其他后台运行方式（备选）

• 日志会输出到 server.log 文件，查看日志：tail -f server.log

若未安装 screen，可使用 nohup 命令：

nohup ./start.sh > server.log 2>&1 &

八、模组安装与管理

1. 安装模组

• 从 CurseForge、Modrinth 等平台下载 与 Minecraft 版本 + Fabric 兼容 的模组（后缀为 .jar）。
• 将模组文件上传到服务器的 ~/minecraft-fabric-server/mods 目录。

重启服务器使模组生效：

# 先连接 screen 会话（如果用 screen）
screen -r mc-server
# 输入 stop 命令停止服务器
stop
# 重新启动
./start.sh

2. 模组注意事项

• 所有模组必须支持当前 Fabric 版本和 Minecraft 版本，否则会导致服务器崩溃。
• 部分模组需要额外依赖（如 Fabric API 已安装，其他依赖需单独下载）。
• 安装多个模组时，建议先测试单个模组是否正常运行，再批量添加（避免冲突）。

九、服务器管理与维护

1. 连接服务器控制台

若会话被占用，强制连接：

screen -D -r mc-server

若使用 screen 后台运行，重新连接会话：

screen -r mc-server

2. 常用服务器命令（在控制台输入）

3. 存档备份（重要）

方法 1：手动备份

# 进入服务器目录
cd ~/minecraft-fabric-server
# 停止服务器（避免备份时存档损坏）
screen -r mc-server
# 连接后输入 stop
# 打包存档文件夹（world 是默认存档名，若修改过需对应调整）
tar -zcvf minecraft-backup-$(date +%Y%m%d).tar.gz world/

方法 2：定时自动备份（推荐）

创建备份脚本 backup.sh：

#!/bin/bash
BACKUP_DIR=~/minecraft-backup
SERVER_DIR=~/minecraft-fabric-server
# 创建备份目录
mkdir -p $BACKUP_DIR
# 停止服务器
screen -S mc-server -X stuff "save-all\nstop\n"
sleep 10
# 等待 10 秒确保服务器关闭
# 备份存档
tar -zcvf $BACKUP_DIR/backup-$(date +%Y%m%d%H%M).tar.gz $SERVER_DIR/world/
# 重启服务器
cd $SERVER_DIR && ./start.sh &

• 赋予执行权限：chmod +x backup.sh

设置定时任务（每天凌晨 2 点备份，需安装 cron）：

# 编辑定时任务
crontab -e
# 加入以下内容（每天 2:00 执行备份）
0 2 * * * ~/backup.sh

4. 服务器更新

（1）更新 Fabric 启动器

• 访问官网 https://fabricmc.net/use/server/，下载对应 Minecraft 版本的最新启动器，替换服务器目录的 fabric-server-launcher.jar。

（2）更新 Fabric API

• 从 CurseForge 下载最新版 Fabric API，替换 mods 目录中的旧版本，重启服务器。

十、常见问题排查

1. 启动失败，提示 Java 版本错误

• 检查 Java 版本：java -version，确保是 Java 17。

若安装了多个 Java 版本，切换默认版本：

sudo update-alternatives --config java

选择 Java 17 的路径。

2. 玩家无法连接服务器

• 检查端口是否开放：netstat -tuln | grep 25565，确认端口处于监听状态。
• 检查 server.properties 中 online-mode 是否为 false（非正版玩家）。
• 云服务器需确认安全组规则已开放 25565 端口。

3. 服务器崩溃（模组冲突）

• 查看日志文件 latest.log（在服务器目录），找到报错的模组名称。
• 移除冲突的模组，或更新到兼容版本。
• 若无法定位，可暂时清空 mods 目录，只保留 Fabric API，测试服务器是否正常启动，再逐个添加模组。

4. 内存不足导致卡顿或崩溃

• 调整启动脚本的 -Xmx 参数（增大最大内存），但不超过服务器物理内存的 70%。
• 减少同时在线玩家数或移除占用内存大的模组。

总结

通过以上步骤，你已成功在 Linux 服务器上搭建了 Fabric 核心的 Minecraft 服务器。核心要点：确保 Java 版本正确、开放端口、同意 EULA、使用后台运行工具保证服务不中断，同时定期备份存档避免数据丢失。若需添加更多功能（如插件、自定义地图），可在稳定运行后逐步扩展。