一、系统环境准备

1. 开放核心端口：通过服务器面板开启 25565 端口（MC 服务器默认端口），后续工具安装后需补充开放 80、443、81 端口，确保面板及服务正常访问。
2. 系统更新与优化：SSH 登陆服务器后，依次执行以下命令完成系统更新与残留清理，保障后续软件安装兼容性。sudo apt update && sudo apt upgrade -y # 系统更新
sudo apt update && sudo apt autoremove # 清理残留依赖（重启后执行）注：执行完第一条更新命令后，建议重启服务器，确保系统组件更新生效。

二、MC 服务器运行环境分析

• MC 服务器为 Java 程序，官方推荐使用 Java 21 版本运行，默认 Debian 12 仓库无此版本，需通过 Adoptium 第三方仓库安装，便于后续升级维护。
• 优先安装 Docker 实现容器化部署，可隔离 MC 服务器、管理面板、反向代理等组件，减少环境冲突，同时简化后续运维操作。

三、MC 服务环境安装

（一）安装 Docker

1. 清理旧版本（全新系统可省略）：移除系统自带的旧版 Docker 相关组件，避免版本冲突。 sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-doc podman-docker containerd runc | cut -f1)
2. 安装依赖工具：安装添加第三方源、安全下载所需的基础组件。 sudo apt install ca-certificates curl
3. 配置 Docker 密钥：创建密钥目录并安装官方密钥，确保软件源安全性。 sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
4. 添加 Docker 官方软件源：配置稳定版软件源，保证 Docker 版本最新且可靠。 tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF
5. 安装 Docker 及组件：更新源后安装完整 Docker 套件，含容器运行时、构建工具等。 sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
6. 配置 Docker 服务：启动服务并设置开机自启，确保服务器重启后 Docker 自动运行。 sudo systemctl start docker # 启动Docker服务
sudo systemctl status docker # 检查服务状态（显示active为正常）
sudo systemctl enable docker # 配置开机自启

（二）安装 Java 21

四、服务器工具安装

（一）安装 MCSManager 面板（Docker 版）

1. 创建工作目录并进入： sudo mkdir -p /opt/docker/MCSM && cd /opt/docker/MCSM
2. 创建 docker-compose.yml 配置文件：执行 vim docker-compose.yml，粘贴以下内容（YAML 格式对缩进敏感，建议用 2 个空格缩进）： # MCSManager 桥接网络模式配置
services:
web:
image: githubyumao/mcsmanager-web:latest
container_name: mcsm_web
ports:
- "23333:23333" # 面板访问端口，宿主机与容器端口一致
volumes:
- /etc/localtime:/etc/localtime:ro # 同步宿主机时间
- ./data/web/data:/opt/mcsmanager/web/data # 面板数据持久化
- ./data/web/logs:/opt/mcsmanager/web/logs # 面板日志持久化
restart: unless-stopped
networks:
- mcsm-network

daemon:
image: githubyumao/mcsmanager-daemon:latest
container_name: mcsm_daemon
ports:
- "24444:24444" # 守护进程通信端口
environment:
- INSTANCE_DATA_PATH=./daemon/data/InstanceData # 实例数据存储路径
volumes:
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
- ./data/daemon/data:/opt/mcsmanager/daemon/data
- ./data/daemon/logs:/opt/mcsmanager/daemon/logs
- /var/run/docker.sock:/var/run/docker.sock # 授权管理Docker容器
restart: unless-stopped
networks:
- mcsm-network

# 自定义桥接网络，优化组件间通信
networks:
mcsm-network:
driver: bridge
3. 启动/停止容器命令： docker compose up -d # 后台启动容器（首次启动会自动拉取镜像）
docker compose down # 停止并移除容器（维护时使用）

（二）安装 Nginx 反向代理（Docker 版）

1. 创建工作目录并进入： mkdir -p /opt/docker/nginx && cd /opt/docker/nginx
2. 创建 docker-compose.yml 配置文件：执行 vim docker-compose.yml，粘贴以下内容： services:
app:
image: 'jc21/nginx-proxy-manager:latest'
restart: unless-stopped
ports:
- '80:80' # HTTP端口（用于域名验证、HTTP跳转HTTPS）
- '443:443' # HTTPS端口（加密访问）
- '81:81' # 反向代理管理后台端口
volumes:
- ./data:/data # 配置数据持久化
- ./letsencrypt:/etc/letsencrypt # SSL证书存储目录
3. 启动/停止容器命令： docker compose up -d # 后台启动
docker compose down # 停止并移除

五、关键注意事项

1. 端口开放验证：务必确认服务器防火墙/安全组已开放 80、443、81、23333、24444、25565 端口，少开放一个会导致对应服务无法访问。
2. 面板与反向代理配置：MCSManager 面板添加 MC 实例、Nginx 配置 SSL 证书及域名映射，需参考各自官方文档，操作时注意保存配置。
3. 境内服务器合规要求：若服务器架设在国内，使用域名访问前必须完成工信部域名备案及公安部网站备案，否则属于违规操作。
4. 命令语法说明：原文档“docker compos”为笔误，已统一修正为官方标准命令“docker compose”，所有命令可直接复制执行。