aa106875c7 | ||
---|---|---|
docs | ||
hoj-springboot | ||
hoj-vue | ||
judger | ||
sqlAndsetting | ||
LICENSE | ||
README.md |
README.md
Hcode Online Judge(HOJ)
一、前言
基于前后端分离,分布式架构的在线测评平台(hoj),前端使用vue,后端主要使用springboot,redis,mysql,nacos等技术,支持HDU、POJ、Codeforces(包括GYM)的vjudge判题,同时适配手机端、电脑端浏览,拥有讨论区与站内消息系统,支持私有训练、公开训练(题单),还有完善的判题模式(普通测评、特殊测评、交互测评)和完善的比赛功能(打星队伍、关注队伍、外榜)。
在线Demo | 在线文档 | Github&Gitee仓库地址 | QQ群 |
---|---|---|---|
https://hdoi.cn | https://www.hcode.top/docs | https://github.com/HimitZH/HOJ https://gitee.com/himitzh0730/hoj | 598587305 |
注意:
- 建议使用Centos8以上或Ubuntu16.04以上的操作系统!!!不然判题机(judgeserver)可能无法正常启动。
- 服务器配置尽可能使用2核4G以上,保证服务的正常启动与运行。
- 尽量不要使用突发性能或共享型的云服务器实例,有可能造成评测时间计量不准确。
- 有任何部署问题或项目bug请发issue或者加QQ群。
- 如果要对本项目进行商业化,请在页面底部的Powered by指向HOJ本仓库地址,顺便点上star收藏本项目对开发者的支持,谢谢。
二、部署
部署文档:基于docker-compose部署
具体请看部署文档,已安装docker和docker-compose的可以执行以下命令快速部署
注意:
1. 正式部署请自行修改配置,不要使用默认配置的密码,例如mysql、redis、nacos的密码
2. 如果已经为了测试而使用默认配置启动来部署,建议删掉当前文件夹,重新执行以下部署流程,修改默认配置
git clone https://gitee.com/himitzh0730/hoj-deploy.git && cd hoj-deploy && cd standAlone
vim .env # 建议执行这一步,对默认配置进行修改。
docker-compose up -d
根据网速情况,大约十到二十分钟即可安装完毕,全程无需人工干预。
docker ps # 查看当前运行的容器状态
-
大概初始化启动需要一至两分钟,当看到所有的容器的状态status都为
UP
和healthy
就代表 OJ 已经启动成功。注意:可能初始化过程中访问网页会出现服务器异常,此为正常现象,因为容器还在初始化中,请耐心等待容器状态为up和healthy,大概需要1~2分钟
-
默认超级管理员账号与密码:root / hoj123456
部署成功后,登录root账号进入后台(
http://ip/admin/conf
)修改邮箱配置,新用户才可以正常注册(因为账号注册与密码等修改操作需要通过邮件发送验证码)邮箱配置可以自行百度,开启使用例如QQ邮箱提供的POP3/SMTP服务:Host: smtp.qq.com Port: 465 Username: qq邮箱账号 Password: 开启SMTP服务后生成的随机授权码
三、更新
请在docker-compose.yml当前文件夹下执行docker-compose pull
拉取最新镜像,然后重新docker-compose up -d
即可。
四、上线日记
时间 | 内容 | 更新者 |
---|---|---|
2020-10-26 | 正式开发 | Himit_ZH |
2021-04-10 | 首次上线测试 | Himit_ZH |
2021-04-15 | 判题调度2.0解决并发问题 | Himit_ZH |
2021-04-16 | 重构解耦JudgeServer判题逻辑,添加部署文档 | Himit_ZH |
2021-04-19 | 加入rsync实现评测数据同步,修复一些已知的BUG | Himit_ZH |
2021-04-24 | 加入题目模板,修改页面页脚 | Himit_ZH |
2021-05-02 | 修复比赛后管理员重判题目导致排行榜失效的问题 | Himit_ZH |
2021-05-09 | 添加公共讨论区,题目讨论区,比赛评论 | Himit_ZH |
2021-05-12 | 添加评论及回复删除,讨论举报,调整显示时间。 | Himit_ZH |
2021-05-16 | 完善权限控制,讨论管理员管理,讨论删除与编辑更新。 | Himit_ZH |
2021-05-22 | 更新docker-compose一键部署,修正部分bug | Himit_ZH |
2021-05-24 | 判题调度乐观锁改为悲观锁 | Himit_ZH |
2021-05-28 | 增加导入导出题目,增加用户页面的最近登录,开发正式结束,进入维护摸鱼 | Himit_ZH |
2021-06-02 | 大更新,完善补充前端页面,修正判题等待超时时间,修补一系列bug | Himit_ZH |
2021-06-07 | 修正特殊判题,增加前台i18n | Himit_ZH |
2021-06-08 | 添加后台i18n,路由懒加载 | Himit_ZH |
2021-06-12 | 完善比赛赛制,具体请看在线文档 | Himit_ZH |
2021-06-14 | 完善后台管理员权限控制,恢复CF的vjudge判题 | Himit_ZH |
2021-06-25 | 丰富前端操作,增加POJ的vjudge判题 | Himit_ZH |
2021-08-14 | 增加spj对使用testlib的支持 | Himit_ZH |
2021-09-21 | 增加比赛打印功能、账号限制功能 | Himit_ZH |
2021-10-05 | 增加站内消息系统——评论、回复、点赞、系统通知的消息,优化前端。 | Himit_ZH |
2021-10-06 | 美化比赛排行榜,增加对FPS题目导入的支持 | Himit_ZH |
2021-12-09 | 美化比赛排行榜,增加外榜、打星队伍、关注队伍的支持 | Himit_ZH |
2022-01-01 | 增加公开训练和公开训练(题单) | Himit_ZH |
2022-01-04 | 增加交互判题、重构judgeserver的三种判题模式(普通、特殊、交互) | Himit_ZH |
五、部分截图
以下截图页面均支持中英文国际化,点击底部的转换即可全网站转换,包括后台管理,同时浏览器会记住本次选择的语言
首页页面
首页英文
站内消息系统
题目列表页
题目详情页
比赛列表页
比赛以西南科技大学某届新生赛截图为例
比赛详情首页
比赛题目列表页
比赛排行榜
- ACM比赛
提交列表页
排行榜
公共讨论区
评论组件
个人首页
个人设置页
管理后台首页
部分手机端显示