Linux服务器搭建Minecraft（MC）面板教程零基础带网页管理【详解】-LINUX-PHP中文网

用mcsmanager是目前linux上零基础搭mc面板最稳的选择，一行命令即可安装，支持ubuntu 20.04+等主流系统，自带web界面、sftp文件管理、自动配置与日志诊断，无需docker或编译，且完美适配java版开服全流程。

linux服务器搭建minecraft（mc）面板教程零基础带网页管理【详解】

直接上结论：用 MCSManager 是目前 Linux 上零基础搭 MC 面板最稳的选择，不用编译、不依赖 Docker、命令一行就能装完，CentOS 7 / Ubuntu 20.04+ / Debian 11+ 全支持，但 CentOS 7 不能跑最新版 MCSM（v3.5+），得用 v3.4.x 或降级处理。

为什么选 MCSManager 而不是其他面板

不是所有“带网页的 MC 面板”都适合新手。比如 AMP 强依赖 .NET 运行时，在 CentOS 7 上装 runtime 容易卡在依赖冲突；McProHosting 类商业面板要付费且不开放自托管；NodeJS 写的轻量面板 则常缺文件管理、FTP、多实例隔离等刚需功能。

MCSManager 的实际优势很实在：

安装脚本自动判断系统类型、下载对应二进制、设好 systemd 服务、开防火墙端口
Web 界面里点几下就能新建 Minecraft 实例，自动下载 server.jar、生成 eula.txt、改 server.properties
自带 SFTP（端口 20010–20200 区间），拖文件传 MOD、配置、世界存档完全图形化
所有操作日志可查，崩溃时能直接看到 java 报错堆栈，不是黑盒

安装前必须确认的三件事

很多失败不是脚本问题，而是环境没对齐。尤其新手容易在这三处卡住：

Java 版本必须匹配 MC 版本：1.17+ 要 openjdk-17-jre，1.21.1 要 openjdk-21-jre；java -version 输出里不能有 1.8.0 或 11.0 还硬跑 1.20
云服务器安全组必须放行 23333（面板 Web）、25565（游戏联机）、20010-20200（SFTP）——只开 23333 是进得去面板但传不了文件、开不了服
系统时间必须准：timedatectl status 查时区，若显示 System clock synchronized: no，运行 sudo timedatectl set-ntp true，否则面板登录可能提示 token 过期

安装命令与常见报错应对

官方推荐的一行安装命令是：

Browser Setup (No-Root Linux)

在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...

下载

wget -qO- https://gitee.com/mcsmanager/script/raw/master/setup.sh | bash

但它在某些场景会静默失败，建议拆成两步执行并观察输出：

先下载脚本：wget https://gitee.com/mcsmanager/script/raw/master/setup.sh
再加执行权限并运行：chmod +x setup.sh && sudo ./setup.sh

遇到报错别急着重装，先看这几种典型情况：

curl: command not found → 系统没装 curl，运行 sudo apt install curl（Ubuntu/Debian）或 sudo yum install curl（CentOS）
Failed to start mcsmanager.service: Unit mcsmanager.service not found → 脚本中途退出了，检查 /opt/mcsmanager 是否存在，若为空，删掉重试；若存在但没 service 文件，手动运行 sudo systemctl daemon-reload
安装完打不开 http://你的IP:23333 → 先 sudo ss -tuln | grep 23333 看端口是否监听，没监听就 sudo systemctl start mcsmanager；有监听但外网打不开，一定是云厂商安全组没放行

首次登录后必做的两件事

面板首页会让你设管理员账号，密码长度必须 9–36 位、含大小写字母+数字，输错三次会锁 15 分钟——这是硬限制，不是 bug。

登录后立刻做：

点左上角「实例管理」→「新建实例」→ 选「Minecraft Java Edition」→ 版本选你要的（如 1.18.1），**不要点「Forge」或「Fabric」标签页**——那只是占位符，真装 Forge 得手动上传核心，面板不自动适配启动参数
实例建好后先「停止」，进「文件管理」找到 server.properties，把 online-mode=true 改成 online-mode=false，再保存——否则非正版客户端连不上，且这个字段不会在面板设置页暴露

最后提醒一句：MCSManager 的「FTP」功能本质是内建 SFTP 服务，不是传统 FTP；它不走 21 端口，也不需要额外装 vsftpd，连的时候地址写 sftp://你的IP:20010，用户名密码就是面板管理员账号——这点文档里藏得深，但实操中 80% 的“传不了 MOD”问题都出在这儿。