基于分布式、前后端分离的高性能在线评测系统

《开源精选》是我们分享 Github、Gitee 等开源社区中优质项目的栏目，包括技术、学习、实用与各种有趣的内容。本期推荐的是一个基于 SpringCloud 与 Vue 前后端分离的在线测评平台 OJ——Hcode Online Judge。

Hcode Online Judge (HOJ) : 基于前后端分离，分布式架构的在线测评平台（hoj），前端使用 vue，后端主要使用 SpringBoot，Redis，MySQL，nacos 等技术，支持 HDU、POJ、Codeforces（包括 GYM）的 vjudge 判题，同时适配手机端、电脑端浏览，拥有讨论区与站内消息系统，支持私有训练、公开训练（题单），还有完善的判题模式（普通测评、特殊测评、交互测评）和完善的比赛功能（打星队伍、关注队伍、外榜）。

特性

• 分布式：支持多台判题服务弹性增减
• 高效化：采用前后端分离，开发迅速，使用高性能可复用判题沙盒
• 定制化：网站高度集中配置，支持定制化修改
• 安全化：判题使用 cgroup 隔离用户程序，网站权限控制完善
• 多样化：独有自身判题服务，同时支持其它知名 OJ 题目的提交判题

页面截图

以下截图页面均支持中英文国际化，点击底部的转换即可全网站转换，包括后台管理，同时浏览器会记住本次选择的语言。

首页页面

首页英文

站内消息系统

题目列表页

题目详情页

训练列表页

训练题目列表页

比赛列表页

比赛排行榜

快速部署

环境准备：docker 与 docker-compose

单机部署

1. 选择好需要安装的位置，运行下面的命令：

git clone https://gitee.com/himitzh0730/hoj-deploy.git && cd hoj-deploy

2. 进入文件夹，使用 docker-compose 启动各容器服务：

cd standAlone

standAlone 文件夹文件有以下：

├── docker-compose.yml
├── .env

主要配置请修改 .env 文件，内容如下：

注意：各服务 ip 最好不改动，保持处于172.20.0.0/16网段的 docker network

# hoj全部数据存储的文件夹位置（默认当前路径生成hoj文件夹）
HOJ_DATA_DIRECTORY=./hoj

# redis的配置
REDIS_HOST=172.20.0.2
REDIS_PORT=6379
REDIS_PASSWORD=hoj123456

# mysql的配置
MYSQL_HOST=172.20.0.3
# 如果判题服务是分布式，请提供当前mysql所在服务器的公网ip
MYSQL_PUBLIC_HOST=172.20.0.3
MYSQL_PORT=3306
MYSQL_ROOT_PASSWORD=hoj123456

# nacos的配置
NACOS_HOST=172.20.0.4
NACOS_PORT=8848
NACOS_USERNAME=root
NACOS_PASSWORD=hoj123456

# backend后端服务的配置
BACKEND_HOST=172.20.0.5
BACKEND_PORT=6688
# token加密秘钥 默认则生成32位随机密钥
JWT_TOKEN_SECRET=default
# token过期时间默认为24小时 86400s
JWT_TOKEN_EXPIRE=86400
# token默认12小时可自动刷新
JWT_TOKEN_FRESH_EXPIRE=43200
# 调用判题服务器的token 默认则生成32位随机密钥
JUDGE_TOKEN=default
# 请使用邮件服务的域名或ip
EMAIL_SERVER_HOST=smtp.qq.com
EMAIL_SERVER_PORT=465
EMAIL_USERNAME=your_email_username
EMAIL_PASSWORD=your_email_password
# 开启虚拟判题请提供对应oj的账号密码 格式为 
# username1,username2,...
# password1,password2,...
HDU_ACCOUNT_USERNAME_LIST=
HDU_ACCOUNT_PASSWORD_LIST=
CF_ACCOUNT_USERNAME_LIST=
CF_ACCOUNT_PASSWORD_LIST=
POJ_ACCOUNT_USERNAME_LIST=
POJ_ACCOUNT_PASSWORD_LIST=

# judgeserver的配置
JUDGE_SERVER_IP=172.20.0.7
JUDGE_SERVER_PORT=8088
JUDGE_SERVER_NAME=judger-alone
# -1表示可接收最大判题任务数为cpu核心数+1
 MAX_TASK_NUM=-1
# 当前判题服务器是否开启远程虚拟判题功能
REMOTE_JUDGE_OPEN=true
# -1表示可接收最大远程判题任务数为cpu核心数*2+1
REMOTE_JUDGE_MAX_TASK_NUM=-1
# 默认沙盒并行判题程序数为cpu核心数
PARALLEL_TASK=default

# docker network的配置
SUBNET=172.20.0.0/16

提示：如果服务器的内存在4G 或4G 以上，请去掉 JVM 限制才能大大提高并发量，操作如下：

vim docker-compose.yml

注释或去掉图中选中的行：

• hoj-backend 模块
• hoj-judgeserver 模块

如果不改动，则以默认参数启动（测试可以不改，但正式部署请修改默认配置的密码！）

docker-compose up -d

根据网速情况，大约十到二十分钟拉取镜像，全程无需人工干预，拉取完毕后，自动启动容器服务，大概需要一至两分钟的初始化。

等待命令执行完毕后，查看容器状态：

docker ps -a

当看到所有的容器的状态status都为 UP 或 healthy 就代表 OJ 已经启动成功。

以下默认参数说明：

• 默认超级管理员账号与密码：root / hoj123456
• 默认 redis 密码：hoj123456（正式部署请修改）
• 默认 mysql 账号与密码：root / hoj123456（正式部署请修改）
• 默认 nacos 管理员账号与密码：root / hoj123456（正式部署请修改）
• 默认不开启 https，开启需修改文件同时提供证书文件
• 判题并发数默认：cpu 核心数+1
• 默认开启 vj 判题，需要手动修改添加账号与密码，如果不添加不能vj判题！
• vj 判题并发数默认：cpu 核心数*2+1

登录root账号到后台查看服务状态以及到 http://ip/admin/conf 改服务配置!

注意：网站的注册及用户账号相关操作需要邮件系统，所以请在系统配置中配置自己的 SMTP 邮件服务。

如果已经在启动在 .env文件配置了邮件服务即不用再次修改。

Host: smtp.qq.com
Port: 465
Username: qq邮箱账号
Password: 开启SMTP服务后生成的随机授权码

分布式部署

主服务器（运行 nacos，backend, frontend,redis）的服务器防火墙请开 8848，3306，873端口号

从服务器（运行 judgeserver）的服务器防火墙请开8088端口号

1. 选择好需要安装的位置，运行下面的命令：

git clone https://gitee.com/himitzh0730/hoj-deploy.git && cd hoj-deploy

2. 进入文件夹：

cd distributed

distributed 文件夹有以下：

├── judgeserver
├── main

3. 首先部署主服务，即是数据后台服务（DataBackup）

cd main

该文件夹下有：

├── docker-compose.yml
├── .env

修改 .env 文件中的配置

vim .env

注意：各服务 ip 最好不改动，保持处于172.20.0.0/16网段的 docker network

# hoj全部数据存储的文件夹位置（默认当前路径生成hoj文件夹）
HOJ_DATA_DIRECTORY=./hoj

# redis的配置
REDIS_HOST=172.20.0.2
REDIS_PORT=6379
REDIS_PASSWORD=hoj123456

# mysql的配置
MYSQL_HOST=172.20.0.3
# 请提供当前mysql所在服务器的公网ip
MYSQL_PUBLIC_HOST=172.20.0.3
MYSQL_PORT=3306
MYSQL_ROOT_PASSWORD=hoj123456

# nacos的配置
NACOS_HOST=172.20.0.4
NACOS_PORT=8848
NACOS_USERNAME=root
NACOS_PASSWORD=hoj123456

# backend后端服务的配置
BACKEND_HOST=172.20.0.5
BACKEND_PORT=6688
# token加密秘钥 默认则生成32位随机密钥
JWT_TOKEN_SECRET=default
# token过期时间默认为24小时 86400s
JWT_TOKEN_EXPIRE=86400
# token默认12小时可自动刷新
JWT_TOKEN_FRESH_EXPIRE=43200
# 调用判题服务器的token 默认则生成32位随机密钥
JUDGE_TOKEN=default
# 请使用邮件服务的域名或ip
EMAIL_SERVER_HOST=smtp.qq.com
EMAIL_SERVER_PORT=465
EMAIL_USERNAME=your_email_username
EMAIL_PASSWORD=your_email_password
# 开启虚拟判题请提供对应oj的账号密码 格式为 
# username1,username2,...
# password1,password2,...
HDU_ACCOUNT_USERNAME_LIST=username1,username2
HDU_ACCOUNT_PASSWORD_LIST=password1,password2
CF_ACCOUNT_USERNAME_LIST=
CF_ACCOUNT_PASSWORD_LIST=
POJ_ACCOUNT_USERNAME_LIST=
POJ_ACCOUNT_PASSWORD_LIST=

# 评测数据同步的配置
# 请修改数据同步密码
RSYNC_PASSWORD=hoj123456

# docker network的配置
SUBNET=172.20.0.0/16

配置修改保存后，当前路径下启动该服务

docker-compose up -d

根据网速情况，大约十分钟即可安装完毕，全程无需人工干预。

等待命令执行完毕后，查看容器状态

docker ps -a

当看到所有的容器的状态status都为 UP 或 healthy 就代表 OJ 已经启动成功。

4. 接着，在另一台服务器上，依旧 git clone 该文件夹下来，然后进入 judgeserver 文件夹，修改.env 的配置

# hoj全部数据存储的文件夹位置（默认当前路径生成judge文件夹）
HOJ_JUDGESERVER_DATA_DIRECTORY=./judge

# nacos的配置
# 修改为nacos所在服务的ip
NACOS_HOST=NACOS_HOST
# 修改为nacos启动端口号，默认为8848
NACOS_PORT=8848
# 修改为nacos的管理员账号
NACOS_USERNAME=root
# 修改为nacos的管理员密码
NACOS_PASSWORD=hoj123456

# judgeserver的配置
#修改服务器公网ip
JUDGE_SERVER_IP=172.20.0.7
JUDGE_SERVER_PORT=8088
JUDGE_SERVER_NAME=judger-1
# -1表示可接收最大判题任务数为cpu核心数+1
MAX_TASK_NUM=-1
# 当前判题服务器是否开启远程虚拟判题功能
REMOTE_JUDGE_OPEN=true
# -1表示可接收最大远程判题任务数为cpu核心数*2+1
REMOTE_JUDGE_MAX_TASK_NUM=-1
# 默认沙盒并行判题程序数为cpu核心数
PARALLEL_TASK=default

# rsync评测数据同步的配置
# 写入主服务器ip
RSYNC_MASTER_ADDR=127.0.0.1
# 与主服务器的rsync密码一致
RSYNC_PASSWORD=hoj123456