mindskip/xzs实战指南：5分钟快速部署教程

还在为复杂的在线考试系统部署而烦恼吗？学之思开源考试系统（mindskip/xzs）提供了多种快速部署方案，让你在5分钟内就能搭建起功能完整的在线考试平台！本文将为你详细介绍最快捷的Docker部署方式，让你轻松上手。

🚀 部署前准备

在开始部署之前，请确保你的系统满足以下基本要求：

组件	要求	说明
操作系统	Linux (推荐)	CentOS 7+/Ubuntu 16.04+
Docker	18.06.0+	容器运行时环境
Docker Compose	1.25.0+	容器编排工具
内存	2GB+	推荐4GB以上
磁盘空间	5GB+	用于存储数据和镜像

环境检查命令

# 检查Docker版本
docker --version

# 检查Docker Compose版本
docker-compose --version

# 检查系统内存
free -h

# 检查磁盘空间
df -h

📦 快速部署步骤

步骤1：获取部署文件

首先需要获取学之思的Docker部署文件。由于当前仓库是PostgreSQL版本，我们需要获取MySQL版本的部署文件：

# 创建部署目录
sudo mkdir -p /usr/local/xzs
cd /usr/local/xzs

# 下载部署文件（这里使用wget示例，实际需要从官方获取）
# 假设已经获取到docker部署目录的所有文件

步骤2：准备数据库脚本

获取SQL脚本文件后，需要进行简单的修改：

-- 在xzs-mysql.sql文件开头添加以下代码
CREATE DATABASE `xzs` CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
USE xzs;

-- 后续是原有的表结构创建语句...

将修改后的SQL文件移动到 docker/sql/ 目录下。

步骤3：安装Docker Compose

如果系统中还没有安装Docker Compose，可以按照以下步骤安装：

# 进入安装目录
cd /usr/local/xzs/install

# 安装docker-compose
sudo mv docker-compose-linux-x86_64 /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

# 验证安装
docker-compose --version

步骤4：启动学之思系统

一切准备就绪后，只需一条命令即可启动整个系统：

# 进入部署目录
cd /usr/local/xzs

# 启动服务（-d参数表示后台运行）
docker-compose up -d

系统启动过程可以通过以下命令监控：

# 查看容器状态
docker-compose ps

# 查看日志
docker-compose logs -f

# 查看特定服务的日志
docker-compose logs java
docker-compose logs mysql

🏗️ 系统架构解析

学之思考试系统采用微服务架构，通过Docker Compose进行容器编排：

graph TD
    A[用户浏览器] --> B[Nginx/前端静态资源]
    B --> C[Java后端服务]
    C --> D[MySQL数据库]
    
    subgraph Docker容器集群
        B --> C
        C --> D
    end
    
    style A fill:#e1f5fe
    style B fill:#f3e5f5
    style C fill:#e8f5e8
    style D fill:#fff3e0

容器服务说明

服务名称	镜像	端口	功能描述
xzs-mysql	mysql:8.0.33	3306	数据库服务，存储所有业务数据
xzs-java	java:1.8.0	8000	后端API服务，处理业务逻辑

🔧 配置文件详解

Docker Compose配置

version: '3.9'
services:
    mysql:
        image: registry.cn-hangzhou.aliyuncs.com/mindskip/mysql:8.0.33
        restart: always
        ports:
            - "127.0.0.1:3306:3306"  # 仅本地访问，增强安全性
        environment:
            MYSQL_ROOT_PASSWORD: "123456"  # 建议生产环境修改
            TZ: "Asia/Shanghai"           # 时区设置
        volumes:
            - "./sql:/docker-entrypoint-initdb.d/"  # SQL初始化脚本
    
    java:
        image: registry.cn-hangzhou.aliyuncs.com/mindskip/java:1.8.0
        network_mode: host  # 使用主机网络模式
        restart: always
        command: 
            /bin/bash -c "java -Duser.timezone=Asia/Shanghai -jar -Dspring.profiles.active=prod /usr/local/xzs/release/xzs-3.9.0.jar"
        volumes:
            - "./release:/usr/local/xzs/release/"  # 应用JAR包
            - "./log:/usr/log/xzs/"               # 日志目录

🌐 访问系统

部署完成后，可以通过以下地址访问系统：

访问地址

系统模块	访问地址	默认账号	说明
学生端	http://服务器IP:8000/student	需注册	学生考试和练习平台
管理员端	http://服务器IP:8000/admin	admin/123456	系统管理后台

健康检查

# 检查服务是否正常启动
curl -I http://localhost:8000

# 检查数据库连接
docker exec -it xzs-mysql mysql -uroot -p123456 -e "SHOW DATABASES;"

# 查看应用日志
tail -f /usr/local/xzs/log/application.log

⚡ 性能优化建议

1. 数据库优化

-- 为常用查询字段添加索引
CREATE INDEX idx_exam_paper_status ON exam_paper(status);
CREATE INDEX idx_question_subject_id ON question(subject_id);
CREATE INDEX idx_user_answer_user_id ON user_answer(user_id);

2. JVM参数调优

# 修改Docker Compose中的Java启动参数
java -Xms512m -Xmx1024m -XX:+UseG1GC -Duser.timezone=Asia/Shanghai -jar -Dspring.profiles.active=prod /usr/local/xzs/release/xzs-3.9.0.jar

3. 网络优化

# 在docker-compose.yml中添加网络配置
networks:
  xzs-network:
    driver: bridge

# 为每个服务指定网络
services:
  mysql:
    networks:
      - xzs-network
  java:
    networks:
      - xzs-network

🔍 常见问题排查

问题1：端口冲突

# 检查端口占用情况
netstat -tlnp | grep :8000
netstat -tlnp | grep :3306

# 如果端口被占用，可以修改docker-compose.yml中的端口映射
ports:
  - "8001:8000"  # 将外部端口改为8001

问题2：数据库连接失败

# 检查MySQL容器状态
docker logs xzs-mysql

# 进入MySQL容器检查
docker exec -it xzs-mysql mysql -uroot -p123456

# 检查数据库是否创建成功
SHOW DATABASES;
USE xzs;
SHOW TABLES;

问题3：应用启动失败

# 查看Java应用日志
docker logs xzs-java

# 或者查看挂载的日志文件
tail -f /usr/local/xzs/log/application.log

📊 监控和维护

系统监控命令

# 查看容器资源使用情况
docker stats

# 查看系统负载
top

# 查看磁盘IO
iostat -x 1

# 查看网络流量
iftop

日常维护操作

# 备份数据库
docker exec xzs-mysql mysqldump -uroot -p123456 xzs > backup_$(date +%Y%m%d).sql

# 重启服务
docker-compose restart

# 停止服务
docker-compose stop

# 删除服务（谨慎操作）
docker-compose down

🎯 部署成功验证

部署完成后，请按照以下清单验证系统功能：

验证项目	检查方法	预期结果
学生端访问	浏览器打开学生端地址	显示登录界面
管理员端访问	浏览器打开管理员端地址	显示管理登录界面
数据库连接	执行健康检查命令	返回数据库信息
用户注册	在学生端注册新用户	注册成功
管理员登录	使用默认账号登录	登录成功进入管理界面

💡 进阶部署方案

对于生产环境，建议采用以下进阶部署方案：

方案1：前后端分离部署

# Nginx配置示例
server {
    listen 80;
    server_name exam.yourdomain.com;
    
    # 前端静态资源
    location / {
        root /usr/local/xzs/web/;
        index index.html;
        try_files $uri $uri/ /index.html;
    }
    
    # API代理
    location /api/ {
        proxy_pass http://localhost:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

方案2：高可用集群部署

graph TB
    A[负载均衡器] --> B[应用节点1]
    A --> C[应用节点2]
    A --> D[应用节点3]
    
    B --> E[MySQL主库]
    C --> E
    D --> E
    
    E --> F[MySQL从库1]
    E --> G[MySQL从库2]
    
    style A fill:#ffebee
    style E fill:#e8f5e8
    style F fill:#f3e5f5
    style G fill:#f3e5f5

🎉 总结

通过本文的5分钟快速部署指南，你已经成功搭建了学之思开源考试系统。这套系统具备以下优势：

• 快速部署：Docker容器化部署，5分钟即可完成
• 功能完整：支持在线考试、题库管理、成绩统计等完整功能
• 多端支持：Web端+微信小程序，覆盖多种设备
• 易于扩展：微服务架构，方便水平扩展

现在你可以开始使用学之思系统来创建考试、管理题库，为你的教学或培训工作提供强大的技术支持！

提示：生产环境部署前，请务必修改默认密码、配置SSL证书、设置防火墙规则，确保系统安全。