MCSManager 完整安装配置教程｜一键部署、端口放行、开机自启、HTTPS域名反代、故障排查

MCSManager 完整安装配置教程｜一键部署、端口放行、开机自启、HTTPS域名反代、故障排查

MCSManager（简称 MCSM）是目前国内最稳定、开源免费、无广告、无捆绑的游戏服务端管理面板。

支持多节点管理、多实例开服、在线网页终端、文件管理、自动备份、一键重启、计划任务。

常用于 Minecraft、三角洲行动、各类 Steam 游戏、Linux 程序托管，是个人服务器运维首选面板。

本篇为从零到上线的完整教程，包含环境说明、一键安装、端口放行、本地防火墙、开机自启、日常运维命令、域名 HTTPS 反代、节点修复、常见报错排查、安全加固与卸载方式。

一、支持系统环境

以下系统全部兼容，推荐使用纯净全新服务器：

• Ubuntu 18.04 / 20.04 / 22.04
• Debian 10 / 11 / 12
• CentOS 7 / 8 / 9
• Rocky Linux、AlmaLinux

二、面板默认端口说明

安装完成后固定使用以下端口，请勿随意修改：

• 23333/TCP：网页管理面板
• 24444/TCP+UDP：节点通信、终端、文件上传、心跳检测

三、一键官方安装（国内加速）

全程自动安装 Node.js、运行依赖、Web 面板、守护进程与系统服务。

在服务器终端执行下面这条命令：

sudo su -c "wget -qO- https://script.mcsmanager.com/setup_cn.sh | bash"

安装结束后务必保存：后台登录地址、管理员账号、随机生成的密码。

四、云服务器安全组放行（必做）

进入阿里云 / 腾讯云 / 华为云控制台安全组，放行以下规则：

• TCP：23333
• TCP+UDP：24444

不放行 24444 = 节点永久离线、终端黑屏、无法上传文件、面板无法正常使用

五、服务器本地防火墙放行（必做）

#### CentOS / Rocky 系统

依次执行以下四条命令：

firewall-cmd --permanent --add-port=23333/tcp

firewall-cmd --permanent --add-port=24444/tcp

firewall-cmd --permanent --add-port=24444/udp

firewall-cmd --reload

#### Ubuntu / Debian 系统

依次执行以下三条命令：

ufw allow 23333

ufw allow 24444

ufw reload

六、MCSM 启停、自启与状态查看命令

• 启动面板与节点：systemctl start mcsm-web mcsm-daemon
• 停止全部服务：systemctl stop mcsm-web mcsm-daemon
• 设置开机自启（安装脚本默认已开启）：systemctl enable mcsm-web mcsm-daemon
• 查看面板运行状态：systemctl status mcsm-web
• 查看节点运行状态：systemctl status mcsm-daemon
• 重启全部服务：systemctl restart mcsm-web mcsm-daemon

七、首次登录与初始化设置

1. 浏览器访问 http://你的IP:23333
2. 使用安装输出中的账号密码登录
3. 进入个人资料，立即修改为高强度密码
4. 开启登录验证码
5. 进入节点管理，确认本地节点为绿色在线状态

八、常见新手问题排查

网页打不开

检查安全组 23333 是否放行，检查服务器本地防火墙是否拦截。

节点红色离线

99% 是 24444 端口未放行，或服务器防火墙拦截，或服务器时间异常导致心跳失败。

终端黑屏、无法输入命令

未配置 HTTPS 节点地址，或 Nginx 反代缺少 Upgrade 协议头。

文件上传失败

节点通信异常，或 node 域名未正确配置 HTTPS。

九、高级配置：HTTPS 域名无端口访问（推荐）

裸端口直接暴露公网不安全，容易被全网扫描器盯上，推荐使用双域名 SSL 加密部署。

#### 所需域名

• 面板域名：mcsm.你的域名.com
• 节点域名：node.mcsm.你的域名.com

#### 前置条件

1. 两个域名均已添加 A 记录解析到服务器公网 IP
2. 服务器已安装 Nginx
3. 两个域名均已申请并配置好 SSL 证书

十、面板域名的 Nginx 配置

新建配置文件，把下面整段内容写进去：

server {

listen 443 ssl http2;

server_name mcsm.你的域名.com;

ssl_certificate /etc/nginx/ssl/fullchain.pem;

ssl_certificate_key /etc/nginx/ssl/privkey.pem;

location / {

proxy_pass http://127.0.0.1:23333;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection "upgrade";

client_max_body_size 0;

proxy_buffering off;

}

}

十一、节点域名的 Nginx 配置

新建配置文件，写入下面整段内容：

server {

listen 443 ssl http2;

server_name node.mcsm.你的域名.com;

ssl_certificate /etc/nginx/ssl/fullchain.pem;

ssl_certificate_key /etc/nginx/ssl/privkey.pem;

location / {

proxy_pass http://127.0.0.1:24444;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection "upgrade";

client_max_body_size 0;

proxy_buffering off;

}

}

十二、重载 Nginx 生效

先检查配置语法，再重启服务：

nginx -t

systemctl restart nginx

十三、面板内修改节点地址（最关键一步）

进入节点管理，编辑节点，把连接地址改为：

https://node.mcsm.你的域名.com

保存后节点立即变绿，终端与文件上传功能恢复正常。

这一步是绝大多数人踩坑的地方，不修改节点地址，控制台和文件功能都会异常。

十四、安全加固建议

• 关闭 root 账号远程 SSH 密码登录
• 安装 Fail2ban，防止 SSH 暴力破解
• 定期备份目录 /opt/mcsmanager
• 禁止公网直接暴露 23333 / 24444 裸端口
• 后台开启登录验证码
• 定期更换后台密码

十五、完整卸载方法

依次执行以下四条命令：

systemctl stop mcsm-web mcsm-daemon

rm -rf /opt/mcsmanager

rm -rf /etc/systemd/system/mcsm*

systemctl daemon-reload

十六、总结

MCSManager 是轻量、高效、零广告的全能游戏面板。

完整部署流程：一键安装 → 放行端口 → 防火墙放行 → 初始化账号 → 配置 HTTPS 双域名 → 修改节点地址。

按本教程部署可稳定运行，不掉线、无报错，终端与文件功能正常。

本文分类：Linux 运维教程｜适合开服玩家、站长、程序托管用户