1.1 架构说明#

MCSManager 由两个核心服务组成：

• Web 服务：提供用户管理与网页访问功能，默认端口 23333
• 守护进程（Daemon）：提供进程管理和容器管理服务，负责实际的服务器运行

两者缺一不可，安装时默认会同时部署这两个服务。

2.1 系统要求#

2.2 安装 Java 环境#

Minecraft 不同版本对 Java 版本有不同要求：

• 1.17 以下版本：需要 Java 8
• 1.17 及以上版本：需要 Java 16/17/21

本文以 Minecraft 1.19 版本为例，安装 Java 17：

1
# 更新软件包列表
2
sudo apt update
3

4
# 安装 Java 17
5
sudo apt install openjdk-17-jre-headless -y
6

7
# 验证安装
8
java -version

如果需要安装其他版本：

1
# Java 8
2
sudo apt install openjdk-8-jdk -y
3

4
# Java 11
5
sudo apt install openjdk-11-jdk -y
6

7
# Java 17（推荐）
8
sudo apt install openjdk-17-jdk -y

2.3 开放端口#

MCSManager 需要开放以下端口：

在云服务器安全组和系统防火墙中放行这些端口：

1
# 如果使用 ufw 防火墙
2
sudo ufw allow 23333/tcp
3
sudo ufw allow 24444/tcp
4
sudo ufw allow 25565/tcp

3.1 一键安装脚本#

MCSManager 官方提供了一键安装脚本，支持 Ubuntu/CentOS/Debian/Arch 等主流系统：

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

安装过程会自动完成以下操作：

• 安装 Node.js 运行环境（如未安装）
• 下载 Web 和 Daemon 程序文件
• 自动配置系统服务

3.2 启动面板服务#

安装完成后，使用以下命令启动服务：

1
# 启动面板服务（同时启动 Web 和 Daemon）
2
sudo systemctl start mcsm-{daemon,web}.service
3

4
# 设置开机自启
5
sudo systemctl enable mcsm-{daemon,web}.service
6

7
# 查看服务状态
8
sudo systemctl status mcsm-web.service
9
sudo systemctl status mcsm-daemon.service

3.3 服务管理命令#

3.4 访问面板#

安装完成后，通过浏览器访问 http://你的服务器IP:23333，首次访问需要创建一个账号（用户名和密码由你设定）。

⚠️ 注意：默认账号密码 root/123456 是早期版本的习惯，新版本已改为首次访问时自行创建。

4.1 快速开服（一键安装）#

MCSManager 内置了一键开服功能，支持常见版本的服务端快速安装：

1. 登录面板后，点击 快速开始
2. 选择 一键开服
3. 选择 Minecraft 版本（如 1.19.2）
4. 输入服务器名称，点击 安装
5. 等待安装完成，点击 前往实例控制台

4.2 手动创建实例（高级用户）#

如果需要使用自定义服务端（如 Paper、Fabric、Forge）：

1. 点击 应用实例 → 新建实例
2. 选择 Java 版 Minecraft 服务端
3. 选择创建方式：
   • 上传单个服务端软件：上传单个 .jar 文件
   • 上传服务端压缩包：上传包含完整服务端的压缩包
4. 设置实例名称，上传服务端文件
5. 系统自动创建实例

4.3 同意 EULA 协议#

Minecraft 服务端首次启动时需要同意 EULA 协议：

1. 在实例控制台点击 开启实例
2. 看到报错后，点击 文件管理
3. 找到并打开 eula.txt 文件
4. 将 eula=false 改为 eula=true
5. 点击保存，然后重新启动实例

4.4 关闭正版验证（非正版玩家）#

如果玩家使用非正版 Minecraft 启动器，需要关闭正版验证：

1. 停止实例
2. 点击 文件管理
3. 找到并打开 server.properties 文件
4. 将 online-mode=true 改为 online-mode=false
5. 保存文件，重新启动实例

4.5 启动成功#

实例启动成功后，控制台会显示类似以下信息：

1
Done (30.123s)! For help, type "help"

此时服务器已成功运行，默认端口为 25565。局域网内玩家可通过 服务器IP:25565 加入游戏。

5.1 文件管理#

MCSManager 提供可视化的文件管理器，支持：

• 在线编辑配置文件（如 server.properties）
• 上传/下载文件
• 创建/删除文件夹
• 解压压缩包

通过文件管理，你可以轻松上传插件、模组或替换世界存档。

5.2 添加模组（Mods）#

如果你使用 Fabric 或 Forge 服务端，可以添加模组：

1. 停止实例
2. 进入 文件管理 → 进入服务端目录
3. 创建 mods 文件夹（如不存在）
4. 上传模组文件到 mods 文件夹
5. 确保 fabric-api 或 forge 核心模组已安装
6. 重启实例

5.3 更换世界地图#

如果需要使用本地存档：

1. 停止实例
2. 在文件管理中删除原有的 world 文件夹
3. 上传本地存档文件夹（需命名为 world）
4. 设置正确的文件夹权限：

   1
   sudo chown -R mcsm:mcsm /opt/mcsmanager/daemon/data/InstanceData/实例ID/world

5. 重启实例

5.4 多用户管理#

MCSManager 支持创建子账号并分配不同的服务器权限，适合多人协作管理。

6.1 安装 cpolar#

1
# 一键安装 cpolar
2
curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash
3

4
# 添加系统服务
5
sudo systemctl enable cpolar
6

7
# 启动服务
8
sudo systemctl start cpolar

6.2 配置 TCP 隧道#

1. 访问 http://你的服务器IP:9200 进入 cpolar Web 管理界面
2. 登录 cpolar 账号（需注册）
3. 点击 隧道管理 → 创建隧道
4. 配置参数：
   • 隧道名称：mcserver
   • 协议：tcp
   • 本地地址：25565（Minecraft 默认端口）
   • 域名类型：随机域名（或选择固定域名）
   • 地区：选择 China Top
5. 点击 创建

6.3 获取公网地址#

创建成功后，在 在线隧道列表 中查看生成的公网地址（如 12.34.56.78:12345），将地址发给朋友即可远程联机。

6.4 配置固定地址（可选）#

随机地址每 24 小时会变化，如需固定地址，可升级 cpolar 付费套餐后在官网预留固定 TCP 地址。