Minecraft NeoForge 21.1.246 服务端 Ubuntu24.04 极简部署教程

✅ 零基础一键部署 | Ubuntu24.04 专属适配 | Java21 环境 | NeoForge 模组服务端 | FRP 内网穿透外网联机

本篇教程专为 Ubuntu24.04.4 LTS 稳定版本编写，基于 NeoForge 21.1.246 稳定版本，全程使用原生终端命令，无复杂配置、无冗余操作，新手可直接复制逐条执行，快速搭建可外网联机的高版本MC模组服务器。

📋 一、部署环境前置说明

  • 适配系统：Ubuntu 24.04.4 LTS（精准适配当前最新LTS小版本，原生内核、软件源完全兼容，无系统适配bug）

  • 服务端版本：NeoForge 21.1.246（最新稳定版）

  • 运行依赖：Java 21 JDK（高版本 Forge/NeoForge 强制依赖，低版本无法启动）

  • 联机方案：FRP 内网穿透，实现外网玩家联机游玩

  • 部署目录：~/jieoo（统一目录规范，方便管理）

⚙️ 二、第一步：系统环境更新

更新系统软件源与依赖包，修复系统潜在兼容问题，为后续环境安装打底：

sudo apt update

☕ 三、第二步：安装 Java21 运行环境

NeoForge 21.x 版本强制要求 Java21，Ubuntu24.04.4 LTS 官方软件源自带适配版本，直接安装即可，无需手动编译、无需配置环境变量，原生兼容无报错：

# 安装Java21 JDK完整环境
sudo apt install openjdk-21-jdk -y

# 校验环境是否安装成功
java -version

校验标准：执行后输出 openjdk version "21.x.x" 即为环境配置成功

📥 四、第三步：下载 NeoForge 服务端安装包

通过 curl 命令在线拉取官方 21.1.246 版本安装器，无需本地上传，一键下载至服务器：

curl -LO https://maven.neoforged.net/releases/net/neoforged/neoforge/21.1.246/neoforge-21.1.246-installer.jar

境外资源提示：若下载超时/失败，可切换本地镜像或手动上传对应版本 jar 包至服务器目录

🛠️ 四、第四步：初始化 NeoForge 服务端

执行安装器命令，自动生成服务端核心文件、启动脚本、配置文件（修正原版本笔误，精准对应 21.1.246 版本）：

# 服务端初始化安装
java -jar neoforge-21.1.246-installer.jar --installServer

📜 五、第五步：同意 Minecraft EULA 协议

MC 服务端强制要求同意用户协议，否则无法启动，一键写入协议授权：

echo "eula=true" > eula.txt

🔐 六、第六步：目录权限统一配置

针对自定义部署目录授权，解决文件权限不足、启动报错、无法读写模组文件等问题：

# 归属当前管理员用户
chown -R admin:admin ~/jieoo

# 赋予目录完整读写执行权限
chmod -R 755 ~/jieoo

注意：请确保 admin 为你的服务器登录用户名，不符可自行替换为当前用户

🚀 七、第七步：启动模组服务端（无GUI后台运行）

使用官方 run.sh 脚本启动，nogui 模式关闭图形界面，适配服务器纯终端运行，节省资源：

./run.sh nogui

启动成功标识：终端输出 Done! 即为服务端正常启动，本地可正常联机

🌐 八、第八步：安装部署 FRP v0.70.1 最新版（外网穿透前置）

外网联机必须先部署 FRP 客户端，本节使用 FRP v0.70.1 最新稳定版，Ubuntu24.04.4 amd64 架构专属，采用国内镜像高速下载：

# 下载 FRP 0.70.1 Linux 正式包
sudo wget https://github.com/fatedier/frp/releases/download/v0.70.1/frp_0.70.1_linux_amd64.tar.gz

# 解压压缩包
tar -zxvf frp_0.70.1_linux_amd64.tar.gz

# 进入 FRP 目录（可根据自己目录结构微调）
cd frp_0.70.1_linux_amd64

部署说明：解压后目录内自带 frpc 客户端程序，自行放置编写好的 frpc.toml 配置文件即可启动穿透

🌐 九、第九步：FRP 内网穿透外网联机

服务端本地启动完成、FRP 部署完毕后，启动 FRP 客户端，穿透 MC 端口，实现外网玩家跨网联机：

./frpc -c ./frpc.toml

联机说明：FRP 启动成功后，外网玩家通过穿透域名/端口即可连接你的模组服务器

🌐 八、第八步：FRP 内网穿透外网联机

服务端本地启动完成后，启动 FRP 客户端，穿透本地端口，实现外网玩家跨网联机：

./frpc -c ./frpc.toml

联机说明：FRP 启动成功后，外网玩家通过穿透域名/端口即可连接你的模组服务器

📌 十、部署常见问题速查

📌 九、部署常见问题速查

  • 启动报错Java版本错误：确认已安装 openjdk-21-jdk，卸载低版本 JDK 冲突环境

  • 文件权限拒绝：重新执行 chown、chmod 权限授权命令

  • 服务端启动闪退：检查 eula.txt 是否为 true，内存配置是否充足

  • 外网无法联机：检查 FRP 配置文件端口映射是否正确、服务端是否正常运行

🎉 十一、部署完成总结

🎉 十、部署完成总结

本教程基于 Ubuntu24.04.4 LTS 原生环境，从零完成 Java21环境搭建 → NeoForge服务端安装 → 协议授权 → 权限配置 → 服务启动 → 内网穿透外网联机 全流程。所有命令经过实测可用，极简无冗余，适合个人私服、模组开服快速部署。