Go to file

Himit_ZH 7921ce1ee9 change contest homepage		2021-12-17 14:09:04 +08:00
docs	update Scheduled task	2021-12-14 13:02:32 +08:00
hoj-springboot	change testlib spj pe to wa	2021-12-16 11:29:34 +08:00
hoj-vue	change contest homepage	2021-12-17 14:09:04 +08:00
judger	update sandbox	2021-11-30 12:42:54 +08:00
sqlAndsetting	隐藏一些数据	2021-12-07 07:53:51 +08:00
LICENSE	判题调度逻辑2.0解决并发问题	2021-04-15 23:31:30 +08:00
README.md	update docs	2021-12-12 19:51:55 +08:00

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的密码

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