当前位置：首页 > news >正文

从零到部署：手把手教你用Docker容器化HUSTOJ，避免环境配置的坑

news 2026/7/22 13:29:31

从零到部署：手把手教你用Docker容器化HUSTOJ，避免环境配置的坑

在算法教学或编程竞赛训练中，一个稳定可靠的在线判题系统（OJ）能极大提升学习效率。传统部署方式常因PHP、MySQL等组件的版本冲突导致"环境玄学"问题，而Docker容器化技术正是解决这一痛点的利器。本文将带您用Docker Compose编排完整的HUSTOJ环境，实现一次构建、随处运行的理想部署体验。

1. 为什么选择Docker部署HUSTOJ？

1.1 传统部署的三大痛点

依赖地狱：Ubuntu 20.04默认的PHP 7.4与HUSTOJ所需的PHP 5.6存在兼容性问题
环境污渍：直接安装会污染系统环境，导致后续难以维护或升级
迁移困难：系统重装时需要重新配置所有组件，耗时耗力

1.2 容器化方案的优势

# 传统部署 vs Docker部署对比 +---------------------+-----------------------------+--------------------------------+ | 评估维度 | 传统部署 | Docker容器化部署 | +---------------------+-----------------------------+--------------------------------+ | 环境隔离 | 系统全局安装 | 独立容器空间 | | 依赖管理 | 手动解决冲突 | 镜像预配置好依赖 | | 部署速度 | 30分钟~2小时 | 5分钟启动 | | 系统影响 | 修改系统配置 | 不改变宿主机环境 | +---------------------+-----------------------------+--------------------------------+

提示：即使是没有Docker经验的教育工作者，通过本方案也能在10分钟内完成部署

2. 部署前的环境准备

2.1 硬件与系统要求

最低配置：1核CPU/1GB内存/20GB存储（支持同时在线约50人）
推荐配置：2核CPU/4GB内存/50GB存储（支持同时在线200+人）
操作系统：Ubuntu 20.04 LTS或CentOS 7+

2.2 安装Docker引擎

# Ubuntu安装命令 sudo apt-get update sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io # 验证安装 sudo docker run hello-world

2.3 安装Docker Compose

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose

3. 编写Docker Compose编排文件

3.1 项目目录结构

hustoj-docker/ ├── docker-compose.yml ├── mysql/ │ └── conf.d/ │ └── custom.cnf ├── web/ │ ├── html/ # HUSTOJ前端代码 │ └── php.ini # PHP自定义配置 └── judge/ └── etc/ # 判题机配置

3.2 docker-compose.yml核心配置

version: '3' services: mysql: image: mysql:5.7 container_name: hustoj-mysql environment: MYSQL_ROOT_PASSWORD: oj_root_password MYSQL_DATABASE: jol MYSQL_USER: oj_user MYSQL_PASSWORD: oj_password volumes: - ./mysql/data:/var/lib/mysql - ./mysql/conf.d:/etc/mysql/conf.d ports: - "3306:3306" restart: always web: image: php:5.6-apache container_name: hustoj-web depends_on: - mysql volumes: - ./web/html:/var/www/html - ./web/php.ini:/usr/local/etc/php/conf.d/custom.ini ports: - "8080:80" links: - mysql restart: always judge: image: ubuntu:20.04 container_name: hustoj-judge privileged: true volumes: - ./judge/etc:/etc - /var/run/docker.sock:/var/run/docker.sock depends_on: - web restart: always

注意：MySQL 5.7是HUSTOJ兼容性最好的版本，切勿使用8.0+版本

4. 系统初始化与常见问题解决

4.1 初始化HUSTOJ数据库

# 进入web容器执行初始化 docker exec -it hustoj-web bash cd /var/www/html/install/ php install.php

4.2 典型错误排查指南

问题1：PHP连接MySQL失败

解决方案：

检查web/html/include/db_info.inc.php配置
确保MySQL容器名称为hustoj-mysql
验证网络连通性：

docker exec hustoj-web ping hustoj-mysql

问题2：判题机无法编译代码

解决方案：

安装判题依赖：

docker exec hustoj-judge apt-get update docker exec hustoj-judge apt-get install -y gcc g++ openjdk-8-jdk python2.7

配置判题用户：

docker exec hustoj-judge useradd -m -u 1536 judge

4.3 性能优化参数

# web/php.ini 关键配置 max_execution_time = 300 memory_limit = 256M upload_max_filesize = 64M post_max_size = 64M

5. 生产环境进阶配置

5.1 数据持久化方案

数据库备份：

# 每日凌晨备份 docker exec hustoj-mysql sh -c 'exec mysqldump --all-databases -uroot -p"$MYSQL_ROOT_PASSWORD"' > backup.sql

题目数据同步：

rsync -avz ./web/html/data/ backup-server:/oj-backup/

5.2 负载均衡架构

graph TD A[用户] --> B[Nginx负载均衡] B --> C[Web容器1] B --> D[Web容器2] C --> E[MySQL集群] D --> E E --> F[共享存储]

5.3 监控与告警配置

基础监控命令：

# 查看容器资源使用 docker stats hustoj-web hustoj-mysql hustoj-judge # 查看日志 docker logs --tail 100 hustoj-web

Prometheus监控指标：

# docker-compose.yml追加配置 monitor: image: prom/prometheus ports: - "9090:9090" volumes: - ./prometheus.yml:/etc/prometheus/prometheus.yml

6. 教学场景实战技巧

6.1 批量导入题目方法

准备标准题目包结构：

problem_1001/ ├── data.in ├── data.out ├── problem.md └── time_limit

使用自动化脚本：

import os import requests for dir in os.listdir('problems'): data = { 'title': open(f'problems/{dir}/title.txt').read(), 'time_limit': open(f'problems/{dir}/time_limit').read() } files = { 'input': open(f'problems/{dir}/data.in','rb'), 'output': open(f'problems/{dir}/data.out','rb') } requests.post('http://oj.example.com/admin/problem_add.php', data=data, files=files)

6.2 考试模式特殊配置

修改web/html/include/contest.php：

// 修改考试开始前禁止访问题目 $contest_controller = array( 'before_start' => array( 'allow_view_problem' => false, 'allow_submit' => false ) );

数据库隔离设置：

CREATE DATABASE contest_2023; GRANT SELECT ON contest_2023.* TO 'contest_user'@'%';

7. 系统维护与升级

7.1 安全更新策略

镜像更新流程：

docker-compose pull docker-compose down docker-compose up -d

数据迁移检查清单：

MySQL dump文件验证
题目数据校验和检查
用户权限配置备份

7.2 故障恢复演练

模拟数据库崩溃恢复：

# 模拟故障 docker stop hustoj-mysql && docker rm hustoj-mysql # 恢复步骤 docker-compose up -d mysql docker exec -it hustoj-mysql mysql -uroot -p oj_root_password > source backup.sql

在教学实践中发现，将判题机与Web服务分离部署能显著提升系统稳定性。当判题压力大时，可以快速横向扩展judge容器实例，这种弹性正是Docker方案的最大优势。

查看全文

http://www.jsqmd.com/news/840451/