PlayEdu可通过Docker Compose一键部署全栈服务：准备Linux服务器→安装Docker与Compose v2→编写含MySQL/Redis/MinIO/PlayEdu的docker-compose.yml→执行docker-compose up -d启动，30秒内完成初始化并开放后台管理（9808端口）。
准备一台干净的 Linux 服务器
推荐 Ubuntu 22.04 或 CentOS 7/8，最低配置 2 核 CPU + 4GB 内存 + 40GB 磁盘。确保系统已关闭 SELinux（setenforce 0）和防火墙（systemctl disable --now firewalld），避免网络策略干扰容器通信。
安装 Docker 与 Docker Compose v2
不要用系统源里老旧的 docker-compose（v1），必须安装官方 v2+ 版本：
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- Ubuntu：运行 sudo apt update && sudo apt install docker.io，再手动下载 docker-compose-linux-x86_64 到 /usr/local/bin/docker-compose 并加执行权限
- CentOS：用阿里云镜像源安装 Docker CE，再通过 curl 下载 v2.23.0+ 的二进制包
- 验证：执行 docker --version 和 docker-compose version，确认输出含 “Docker Compose version v2.x”
用 docker-compose.yml 定义全栈服务
将 PlayEdu 应用、MySQL、Redis、MinIO 四个服务写在一个 YAML 文件里，关键点包括：
- 网络互通：所有服务默认在同一 bridge 网络，用服务名（如 mysql、redis）互相访问，无需 IP
- 持久化挂载：MySQL 数据目录（./mysql）、Redis 持久文件（./redis）、MinIO 存储路径（./minio）都映射到宿主机，防止容器重启丢数据
- 环境变量驱动配置：PlayEdu 容器通过 DB_HOST=mysql、REDIS_HOST=redis、MINIO_ENDPOINT=http://minio:9000 等变量自动连接依赖，不用改代码
一键拉起并完成初始化
在存放 docker-compose.yml 的目录下执行：
- docker-compose up -d：后台启动全部服务（首次会自动拉取镜像）
- 等待 1–2 分钟，用 docker-compose ps 查看状态，确保所有服务为 Up
- 浏览器打开 http://你的服务器IP:9808（后台管理端口），用默认账号 admin@playedu.xyz / playedu 登录
- 进入「系统配置 → MinIO 存储」，填入 MinIO 的 AccessKey（minioadmin）和 SecretKey（minioadmin），保存后即启用私有化文件存储
