《开源精选》是我们分享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 gitee/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
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账号到后台查看服务状态以及到ip/admin/conf修改服务配置!
注意：网站的注册及用户账号相关操作需要邮件系统，所以请在系统配置中配置自己的SMTP邮件服务。
如果已经在启动在 .env 文件配置了邮件服务即不用再次修改。
Host: smtp.qq
Port: 465
Username: qq邮箱账号
Password: 开启SMTP服务后生成的随机授权码
二、分布式部署
主服务器（运行nacos，backend, frontend,redis）的服务器防火墙请开 8848，3306，873端口号
从服务器（运行judgeserver）的服务器防火墙请开8088端口号
1. 选择好需要安装的位置，运行下面的命令：
git clone gitee/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
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
配置修改保存后，当前路径下启动该服务
docker-compose up -d
提示：需要开启多台判题机，就如当前第4步的操作一样，在每台服务器上执行以上的操作即可。
5. 两个服务都启动完成，在浏览器输入主服务ip或域名进行访问，登录root账号到后台查看服务状态。