前言
大多数玩家联机用的是局域网或内网穿透方案,虽然方便,但缺点也很明显:必须安装相同的 Mod、延迟高、人多就卡。如果你想和朋友稳定流畅地一起玩,自己搭建一个 Minecraft 服务器是更好的选择。
本教程将手把手带你使用 MCSManager(以下简称 MCSM)——一款开源、支持分布式部署、能管理 Minecraft 和 Steam 游戏服务器的 Web 控制面板,从零搭建属于你自己的 Minecraft 服务器。即使你完全没有 Linux 基础,跟着步骤走,也能在一小时内开服成功。
官方文档:https://docs.mcsmanager.com/zh_cn
一、MCSManager 是什么
MCSManager 是一个开源的游戏服务器管理面板。你可以把它理解为”游戏服务器的宝塔面板”——通过浏览器可视化界面,就能完成服务器的创建、配置、启停、文件管理等所有操作,不需要手敲复杂的命令行。
它的核心功能包括:
- 集中管理多台物理服务器:一个面板控制所有节点,如果你有多台机器,可以统一管理。
- 动态创建游戏服务端:在任意节点上快速部署 Minecraft、Steam 游戏服务器,支持 Java 版和基岩版。
- 多用户权限系统:安全地把服务器管理权限分享给朋友,每个人只能操作自己被授权的实例。
- Docker 容器化支持:每个游戏实例运行在独立的容器中,环境隔离,Java 版本随意切换,互不干扰。
- 文件在线管理:直接在网页上上传、编辑、删除服务器文件,修改配置文件不用再登录 SSH。
- 终端在线查看:实时查看服务器控制台输出,监控运行状态,排查问题更方便。
二、环境准备
2.1 硬件配置建议
Minecraft 服务器对 CPU 主频要求较高(因为游戏逻辑主要跑在单线程上),对内存的需求取决于玩家数量和模组数量。以下是根据实际经验给出的参考配置:
| 场景 | CPU | 内存 | 带宽 | 参考价格(年付) |
|---|---|---|---|---|
| 2-5 人原版生存 | 2 核 | 4GB | 3Mbps | 约 200-400 元 |
| 5-10 人模组服 | 4 核 | 8GB | 5Mbps | 约 500-800 元 |
| 10-20 人中型服 | 4-8 核 | 12-16GB | 8Mbps+ | 约 1000-2000 元 |
提示:云服务器推荐选择国内大厂(阿里云、腾讯云)的轻量应用服务器,性价比高,网络稳定。如果朋友都在国内,服务器选国内机房延迟更低。
2.2 软件要求
- 操作系统:Linux(推荐 Ubuntu 20.04/22.04 或 CentOS 7/8)
- Docker 环境(强烈推荐):用于容器化运行 Java 和游戏服务端,环境隔离更方便
关于 JDK:如果使用 Docker 部署 MCSM,不需要手动安装 JDK——Docker 镜像里已经包含了。如果通过脚本安装 MCSM,则需要在面板里配置 JDK 镜像(后文会讲)。
三、部署 MCSManager
这里推荐先用 1Panel 面板来管理服务器(安装过程中会自动装好 Docker),再通过 Docker 部署 MCSM。如果你已经有 Docker 环境,可以直接跳到 3.2 节。
3.1 安装 1Panel(可选,推荐)
1Panel 是一个现代化的 Linux 服务器运维管理面板,比宝塔更轻量,对 Docker 支持更好。
使用 SSH 连接服务器,执行以下命令:
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh
安装完成后,终端会显示 1Panel 的访问地址、用户名和密码,请记下这些信息。
3.2 通过 Docker 部署 MCSManager
如果你已经有 Docker 但不想装 1Panel,可以直接用 Docker 部署 MCSM:
# 创建数据目录
mkdir -p ~/mcsm/data
# 拉取并启动 MCSManager
docker run -d \
--name mcsm \
--restart unless-stopped \
-p 23333:23333 \
-p 24444:24444 \
-v ~/mcsm/data:/opt/mcsmanager \
mcsmanager/mcsmanager:latest
如果想用 1Panel 管理,可以在 1Panel 的 应用商店 中搜索 MCSManager,一键安装。
3.3 一键脚本安装(备选)
如果你不想用 Docker,也可以用官方提供的一键安装脚本(需要 root 权限):
sudo su -c "wget -qO- https://script.mcsmanager.com/setup_cn.sh | bash"
安装完成后,脚本会自动注册系统服务,MCSM 会随系统开机自启。
3.4 放行防火墙端口
不论你使用哪种部署方式,都需要在云服务商安全组和系统防火墙中放行以下端口:
| 端口 | 用途 | 协议 |
|---|---|---|
| 23333 | MCSManager Web 管理面板 | TCP |
| 24444 | MCSManager 守护进程通信(节点与面板之间的内部通信) | TCP |
| 25565 | Minecraft Java 版游戏端口(玩家连接用) | TCP/UDP |
云服务商安全组设置:登录阿里云/腾讯云控制台 → 找到你的服务器 → 安全组 → 添加入方向规则,逐条添加上面三个端口。
Ubuntu 系统防火墙(如果开启了 ufw):
sudo ufw allow 23333/tcp
sudo ufw allow 24444/tcp
sudo ufw allow 25565/tcp
sudo ufw allow 25565/udp
3.5 初始设置
- 浏览器访问
http://你的服务器IP:23333,进入 MCSManager 面板。 - 首次打开会提示创建管理员账号和密码。用户名建议用英文(如
admin),密码至少 8 位。设置好后点击注册并登录。 - 登录后会弹出新手引导教程,可以直接跳过,进入主界面。
主界面左侧是导航菜单,包括概况(Dashboard)、应用实例(你的游戏服务器)、节点管理(管理物理节点)、文件管理(在线编辑配置文件)、终端(查看服务器控制台)等。
四、配置 JDK 环境镜像
MCSManager 使用 Docker 容器来运行游戏服务端,每个容器需要一个 Java 运行环境。你需要先准备一个 JDK 镜像。
什么是 JDK 镜像:可以理解为一个”预装了 Java 的迷你操作系统”。MCSM 用它来创建隔离的容器,每个 Minecraft 服务器跑在独立的容器里,互不影响。不同版本的 Minecraft 需要不同版本的 Java——例如 1.16.5 及以下需要 Java 8,1.17 需要 Java 16,1.18+ 需要 Java 17,1.20.5+ 需要 Java 21。
操作步骤:
- 在 MCSManager 左侧菜单中,点击 节点管理。
- 如果你的面板只有一个节点(通常是 localhost 或本机),直接点击它进入节点详情。
- 点击顶部的 镜像管理 标签页。
- 点击 新增镜像 按钮。
- 在弹出窗口中,你可以看到一些预设的 JDK 版本。勾选你需要的版本(比如 OpenJDK 17 和 OpenJDK 21),点击 构建。
- 如果列表中没有你需要的版本,点击 使用 Dockerfile 自定义创建。在弹出的编辑器中,将 Dockerfile 内容中的版本号(如
17)改为你需要的版本(如21),然后点击构建。 - 等待构建完成(约 1-3 分钟),镜像列表中会显示构建好的镜像,名称类似
mcsm-custom:17或mcsm-custom:21。
五、部署你的第一个 Minecraft 服务器
以下以 Minecraft 1.20.1 + Forge 为例,其他版本和加载器的流程基本相同。
5.1 下载服务端核心
首先需要下载对应版本的服务端核心文件(一个 .jar 文件)。注意:服务端和客户端是不同的文件,你需要下载的是 Server 版本。
| 加载器类型 | 下载地址 | 适用场景 |
|---|---|---|
| Forge | files.minecraftforge.net | 经典模组加载器,模组生态最丰富 |
| NeoForge | neoforged.net | Forge 的分支,1.20.1+ 版本的首选 |
| Fabric | fabricmc.net | 轻量级加载器,性能优秀,适合性能敏感的服务器 |
| Paper | papermc.io | 插件服核心,不支持 Forge 模组,适合原版 + 插件 |
下载完成后,你会得到一个类似 forge-1.20.1-47.3.0-installer.jar 的文件。
5.2 创建应用实例
- 在 MCSManager 左侧菜单中,点击 应用实例。
- 点击右上角的 新增应用 按钮。
- 在弹出的向导中,选择 Minecraft Java 版游戏服务器,点击 继续。
- 选择 上传单个服务端软件。
- 填写实例名称(如”MC-1.20.1-生存服”,建议写清楚版本和用途,方便以后管理)。
- 在启动命令框中,临时填入以下命令(这是首次安装用的命令):
java -server -Dfile.encoding=UTF-8 -Duser.language=zh -Duser.country=CN -jar ${ProgramName} -installServer
参数解释:
-server:以服务端模式运行-Dfile.encoding=UTF-8:使用 UTF-8 编码,防止中文乱码-Duser.language=zh:设置语言为中文-jar ${ProgramName}:运行上传的核心文件-installServer:安装模式,会自动生成必要的配置文件
- 点击 上传文件,选择你下载的
.jar核心文件。 - 上传完成后,点击 创建。
5.3 启用 Docker 容器化
创建完成后,需要把实例放进 Docker 容器中运行:
- 在实例列表中,点击你刚创建的实例名称,进入实例详情。
- 点击 应用实例设置 标签页。
- 找到 容器化 部分,点击 启用 Docker 容器 的开关。
- 在 Docker 镜像 下拉框中,选择你之前构建的 JDK 镜像(1.20.1 需要 Java 17,选择
mcsm-custom:17)。 - 网络模式 改为 host(这样容器才能直接使用服务器的端口,玩家才能连接进来)。
- 点击 保存。
5.4 首次运行与安装
- 回到实例详情页,点击顶部绿色的 开启 按钮。
- 点击 终端 标签页,你会看到服务器开始运行的日志。
- 首次安装会自动解压和生成文件,完成后实例会自动停止。这是正常现象,不用担心。
5.5 修改启动命令
首次安装完成后,根目录下会生成可直接运行的启动文件。你需要修改启动命令:
- 点击 文件管理 标签页,查看根目录下的文件。
- 如果生成了
run.sh文件,启动命令改为:bash run.sh - 如果只生成了类似
forge-1.20.1-47.3.0.jar的文件,启动命令改为:
java -Dfile.encoding=UTF-8 -jar forge-1.20.1-47.3.0.jar nogui
nogui参数表示不打开服务器图形界面(服务器上本来也没有图形界面,加这个参数可以节省内存)。请将forge-1.20.1-47.3.0.jar替换为你实际的文件名。
- 点击 应用实例设置,修改启动命令后保存。
5.6 同意 EULA 协议
Mojang 要求所有 Minecraft 服务器必须同意最终用户许可协议(EULA)才能运行:
- 再次点击 开启 按钮,观察终端输出。
- 你会看到类似
You need to agree to the EULA in order to run the server的提示,然后实例自动停止。 - 点击 文件管理,在根目录找到
eula.txt文件,点击编辑。 - 将
eula=false改为eula=true,保存。 - 再次点击 开启。
这次你应该能看到绿色的 Done 或 For help, type "help" 信息,说明服务器已成功启动!
5.7 非正版玩家设置
如果你和朋友使用的是非正版启动器(如 PCL2、HMCL、BakaXL 等),需要关闭正版验证:
- 在 文件管理 中找到
server.properties,点击编辑。 - 找到
online-mode=true,改为online-mode=false。 - 保存后,点击 重启 按钮使配置生效。
注意:关闭正版验证后,理论上任何人都可以用任意用户名进入你的服务器。建议配合登录插件或白名单来保护服务器安全。
六、客户端连接服务器
6.1 准备工作
- 在本地电脑上安装一个 Minecraft 启动器(推荐 PCL2 或 HMCL)。
- 在启动器中下载与服务器完全相同的 Minecraft 版本和模组加载器(版本必须一致,否则无法连接)。
- 如果服务器安装了模组,客户端也需要安装相同的模组。
6.2 连接服务器
- 打开 Minecraft,进入 多人游戏。
- 点击 添加服务器(或 直接连接)。
- 服务器地址填写:
你的服务器IP:25565(如果端口没改,不需要加端口号)。 - 点击 完成,双击服务器图标加入。
如果一切顺利,你现在应该已经站在自己的 Minecraft 服务器里了!
6.3 IPv4 端口绑定问题
如果你的服务器只有 IPv4 地址,启动时可能会看到类似 Failed to bind to port 25565 的错误。解决方法:
- 在文件管理中打开
server.properties。 - 找到
server-ip=这一行,将其设置为:server-ip=0.0.0.0 - 保存并重启实例。
0.0.0.0 表示”监听本机所有网络接口”,这样无论服务器使用什么 IP,都能正常接收玩家连接。
七、进阶配置
7.1 安装 Mod(模组)
如果你想给服务器添加 Mod(例如更多生物、新维度、科技模组等),按以下步骤操作:
- 在 MC 百科 或 Modrinth 上找到想要的 Mod。
- 注意查看 Mod 的安装说明:有些 Mod 需要双端安装(客户端和服务端都要装),有些只需要客户端安装(如小地图、性能优化类),有些只需要服务端安装。
- 服务端 Mod 文件通常也是
.jar格式,把它上传到文件管理根目录下的mods文件夹。 - 如果
mods文件夹不存在,手动创建一个。 - 重启实例,Mod 即可生效。
7.2 安装整合包
如果你想玩别人已经整合好的大型模组包(如 All the Mods、RLCraft 等):
- 找到该整合包的服务端版本(通常是一个
.zip文件,文件名包含server字样)。 - 在 MCSManager 中创建一个新的应用实例。
- 选择 上传压缩包 而不是单个文件。
- 上传整合包服务端的
.zip文件。 - 压缩包解压后,查看根目录的启动文件(通常是
start.sh、run.sh或server.jar),据此修改启动命令。 - 本地需要安装相同版本的客户端整合包才能加入游戏。
7.3 安装插件(Paper 核心)
如果你不需要 Mod,只需要插件功能(如领地保护、经济系统、皮肤显示、登录验证等),推荐使用 Paper 核心。
Paper 是什么?Paper 是 Spigot 的优化分支,在保留完整插件支持的同时,大幅提升了服务器性能。目前大多数插件服都在使用 Paper 或其衍生核心。
安装步骤:
- 在 MCSM 中创建新实例,上传从 papermc.io 下载的 Paper 核心文件(如
paper-1.20.4-497.jar)。 - 首次启动命令设为:
java -jar paper-1.20.4-497.jar - 首次运行会自动生成
plugins文件夹并停止。 - 启动命令改为:
java -jar paper-1.20.4-497.jar nogui - 将下载好的插件
.jar文件上传到plugins文件夹。 - 重启实例,插件即生效。
推荐插件:
- SkinsRestorer:非正版服皮肤显示,让离线玩家也能看到皮肤
- LuckPerms:权限管理插件,精细控制玩家的操作权限
- EssentialsX:基础功能套件(传送、经济、聊天格式等)
- CoreProtect:方块记录/回档插件,防熊孩子必备
八、服务端核心选择指南
Minecraft 的服务端核心种类繁多,新手很容易挑花眼。这里做一个全面的梳理,帮你快速选对核心。
8.1 仅需插件(无 Mod)
| 核心 | 性能 | 插件生态 | 维护状态 | 一句话总结 |
|---|---|---|---|---|
| Paper | ★★★★★ | Bukkit/Spigot | 活跃 | 生产环境首选,极致性能优化 |
| Purpur | ★★★★☆ | Bukkit/Spigot | 活跃 | Paper 的超集,大量特性可自由开关 |
| Pufferfish | ★★★★☆ | Bukkit/Spigot | 活跃 | 高并发优化,适合大型服务器 |
| Spigot | ★★★☆☆ | Bukkit/Spigot | 活跃 | 经典稳定,生态最老,性能一般 |
| Tuinity | ★★★★☆ | Bukkit/Spigot | 已并入 Paper | 多线程优化,已停更 |
8.2 插件 + Forge Mod(混合端)
混合端让你在同一个服务器上同时使用插件和 Forge 模组,但稳定性通常不如纯插件服或纯模组服。
| 核心 | 支持版本 | 维护状态 | 说明 |
|---|---|---|---|
| Mohist | 1.16–1.21 | 活跃 | 最主流的插件+Forge 混合端,兼容性好 |
| Arclight | 1.19–1.21 | 活跃 | 轻量级混合端,1.20+ 推荐 |
| CatServer | 1.12.2–1.16.5 | 已停更 | 国内早期混合端,仅适合老版本 |
8.3 快速选择建议
- 原版生存 + 几个插件 → Paper 或 Purpur
- Forge 模组服 + 还需要插件 → Mohist(1.16-1.21)或 Arclight(1.20+)
- Fabric 模组服 + 还需要插件 → 不推荐混合端,建议直接使用 Fabric 服务端
- 高版本纯净服追求极致性能 → Paper + 优化插件
下载入口:
九、常用管理命令
在 MCSManager 的 终端 页面中,可以直接输入以下命令来管理服务器(输入命令时不需要加 / 前缀):
# 给玩家管理员权限(第一次需要在终端执行)
op 玩家ID
# 移除玩家管理员权限
deop 玩家ID
# 开启死亡不掉落
gamerule keepInventory true
# 查看在线玩家列表
list
# 添加白名单(开启白名单后,只有白名单内的玩家可以进入)
whitelist add 玩家ID
# 查看白名单列表
whitelist list
# 关闭白名单验证
whitelist off
# 封禁玩家
ban 玩家ID
# 解封玩家
pardon 玩家ID
# 传送到某个玩家身边
tp 目标玩家ID
# 将某人传送到你身边
tp 目标玩家ID 你的ID
# 保存世界
save-all
# 关闭服务器
stop
十、常见问题排查
Q1:朋友连不上服务器
- 检查云服务商安全组是否放行了 25565 端口(TCP 和 UDP 都要放行)。
- 检查系统防火墙是否放行了 25565 端口。
- 确认
server.properties中的server-ip是否为空或设置为0.0.0.0。 - 确认 MCSManager 实例的网络模式是否设置为 host。
Q2:服务器卡顿
- 增加服务器内存(云服务器升级配置)。
- 减少同时加载的区块数(修改
server.properties中的view-distance,建议 6-8)。 - 安装性能优化 Mod(如 Lithium、Phosphor、FerriteCore)。
- 考虑换用 Paper 核心(性能比原版好很多)。
Q3:启动报错 Java 版本不匹配
检查你使用的 JDK 镜像版本是否与 Minecraft 版本匹配:
- Minecraft 1.16.5 及以下 → Java 8
- Minecraft 1.17 → Java 16
- Minecraft 1.18-1.20.4 → Java 17
- Minecraft 1.20.5+ → Java 21
Q4:修改配置后不生效
修改 server.properties 或 mods 文件夹后,需要重启实例(不是重载),配置才会生效。
十一、总结
恭喜!你已经从零开始,成功搭建了自己的 Minecraft 服务器。回顾整个流程:
- 准备环境:云服务器 + Docker + 放行端口。
- 部署 MCSManager:Docker 或一键脚本,几分钟搞定。
- 配置 JDK 镜像:选择适合你 MC 版本的 Java 版本。
- 上传服务端核心:选择 Forge/NeoForge/Fabric/Paper 等。
- 完成初始化:修改启动命令、同意 EULA、配置 Docker 容器。
- 连接游玩:客户端用
IP:25565连接。
MCSManager 让开服变得像搭积木一样简单。有了这个面板,后续管理 Mod、插件、备份、多开服务器都会非常方便。祝你开服顺利,和朋友一起玩得开心!








暂无评论内容