HUSTOJ
流行的OJ系统，跨平台、易安装、有题库。
文档地址
https://github.com/zhblue/hustoj
版权说明
HUSTOJ is an GPL Free Software.
HUSTOJ 是采用 GPL 的*软件。(仅限原创部分代码，其中使用了其他开源项目的组件，请遵循原组件的协议。)
注意：基于本项目源码从事科研、论文、系统开发，请在文中或系统中表明来自于本项目的内容和创意。
论文请引用参考文献 基于开放式云平台的开源在线评测系统设计与实现
如果打算进行二次开发， Wiki 和这份 文档 可能有帮助。
PS: GPL保证你可以合法忽略以上注意事项但不能保证你不受鄙视，呵呵。
常见问题自动应答微信公众号:hustoj
关注后回复： 新装系统、升级、目录等关键词，系统会自动回复相关帮助。
有问题请先查阅 FAQ常见问答 和 Wiki使用技巧 或使用搜索引擎。
如果这个项目对你有用，请：
- 挥动鼠标，右上角给个
Star! - 保留网站页脚的二维码
- 访问 tk题库 ，充值下载题目
- 向同学同事推荐这个项目
- 每天扫一扫本页底部的支付宝红包
- 在您的论文参考文献中写出本项目的网址
Star us, please!
推荐云服务商
目录
基于 Ubuntu 20.04 安装 各类公有云首选, 各类软件最新，有问题提交issues，第一时间处理
基于 Ubuntu 18.04 安装 本地、内网部署首选，实际部署数量最多，稳定可靠
如果您喜欢在线聊天，希望问题获得及时反馈，不介意付费获得服务，请加官方QQ群 23361372 ：点我加群
更新日志
2021年| 日期 | 类型 | 更新内容 |
|---|---|---|
| 04-08 | 更新 | 增加可选的docker作为judge_client外部容器，以增强安全性。 |
| 03-26 | 更新 | 增加权限类型VIP,拥有VIP权限的账户，可以参加所有标题含[VIP]标记的私有比赛。 |
| 03-08 | 补丁 | 修复在Ubuntu20.04上运行sqlite3 |
| 02-06 | 更新 | 新的模板 mdui 基本可用，如需启用新模板，只需修改 /home/judge/src/web/include/db_info.inc.php ，设置 $OJ_TEMPLATE="mdui"; 即可。如需内网使用，请在 /home/judge/src/web/include/db_info.inc.php 末尾添加 $MDUI_OFFLINE=true; 即可。 (Author: @renbaoshuo) |
| 01-01 | 更新 | 新的模板 syzoj 基本可用，如需启用新模板，只需修改 /home/judge/src/web/include/db_info.inc.php ，设置 $OJ_TEMPLATE="syzoj"; 即可。 (Author: @renbaoshuo) |
| 日期 | 类型 | 更新内容 |
|---|---|---|
| 12-30 | 更新 | 新版 wiki 已经迁移至本仓库，可通过 https://zhblue.github.io/hustoj/ 访问。 |
| 12-29 | 更新 | 导入导出FPS(xml)时，增加文件名，默认排序。 |
| 12-28 | 更新 | 增加手工指定测试数据分值的特性，文件名test01[60].in 代表1号数据60分。 |
| 12-27 | 补丁 | 修补龙芯上因为系统调用而提前超时的问题。 |
| 12-21 | 补丁 | 修补手工添加题目失败的问题。 |
| 12-07 | 更新 | HTTP判题机可以通过账号的problem_start/problem_end限制其领取任务的题目号范围，配合judge.conf中的HTTP_DOWNLOAD=0可以让不方便更新判题数据的判题机发挥部分功效。 |
| 11-30 | 更新 | 优化s树莓派4安装脚本，修补漏洞、合并关于下载排名文件的更新。 |
| 11-29 | 更新 | 优化输入数据提供方式，提高整体判题效率。 |
| 11-28 | 补丁 | 修复18.04以上系统里C++编译错误，对C/C++输出中文尝试支持。 |
| 11-22 | 补丁 | 修复部分RuntimeError, 更合理的限时控制。 |
| 09-23 | 更新 | 针对Github国内访问缓慢，安装脚本SVN超时的情况进行了安装脚本优化，解决了18.04/20.04安装失败的问题。 |
| 09-20 | 补丁 | 修复私有比赛题目不正确列出的问题。 |
| 08-08 | 补丁 | 增加了环境"PYTHONIOENCODING=utf-8"，修复Python3环境下不能输出中文字符的问题。 |
| 07-13 | 更新 | 允许长时间维持登录状态,管理员可自定义维持时间. 开启方式:修改 /home/judge/src/web/include/db_info.inc.php,设置 OJ_COOKIE_LOGIN=true;,自定义OJ_KEEP_TIME为自最后一次登陆起最长允许保持登录的时间 |
| 07-12 | 更新 | 允许在WA掉的时候，ShOW_DIFF打开的情况下，下载出错的一组测试数，zip方式打包.in/.out文件 |
| 02-10 | 更新 | 新的模板 bshark 基本可用，如需启用新模板，只需修改 /home/judge/src/web/include/db_info.inc.php ，设置 $OJ_TEMPLATE="bshark";
|
| 01-31 | 更新 | @melongist 增加了很多页面美化。 |
| 01-27 | 更新 | 题目限时增强为浮点型，3位小数精度，即标称毫秒(ms)。 |
| 01-26 | 更新 | 允许为每个Web添加多个UDP通知对象，每个判题服务器允许使用不同的UDP端口监听消息。阿里云+腾讯云测试通过。 |
| 01-23 | 更新 | 修订了Moodle集成代码，实现HUSTOJ给moodle系统作业自动判分。 |
| 01-20 | 更新 | 删除 noip 模式比赛的多余提交记录，允许自定义 noip 关键词，增加 privilege 表 user_id 索引。 |
| 日期 | 类型 | 更新内容 |
|---|---|---|
| 12-19 | 更新 | 增加了 judge.conf 中的注释，提供了备案号变量 $OJ_BEIAN ，对系统判题时间分辨率进行了更新优化，提高灵活度。 |
| 11-23 | 喜讯 |
hustoj 在首届深度软件开发大赛中获得三等奖。 |
| 11-21 | 补丁 | 修复比赛中点击 Edit 按钮后可以选择出题人禁用的语言提交【感谢湘潭大学谢老师的报告】。 |
| 11-20 | 更新 | 在运行结果对比输出（OJ_SHOW_DIFF）中提示每个数据点的结果(AC/WA/TLE…)。 |
| 11-16 | 优化 | @muzea 开发了从 GitHub 到 Gitee 的同步机制，并部署了CI。 |
| 11-13 | 更新 | 在运行时错误(RuntimeError)中显示数据点文件名(infile) |
| 10-30 | 更新 | 提供 $OJ_OI_MODE 开关。 |
| 10-29 | 更新 | 加强了 OI 模式下的限制，控制 Web 行为。 |
| 10-03 | 更新 | 修订测试 deepin 15.11 安装脚本 |
| 10-03 | 补丁 | 注册页面验证 csrf
|
| 09-23 | 补丁 | 修复昵称比赛中不更新问题，以及提醒官方群用户及时更新处理504超时问题。 |
| 09-21 | 补丁 | 修复部分安装脚本不能执行第二次的问题 |
| 08-06 | 更新 | 支持用UDP数据包触发判题轮询，实现Web本地judge秒判。 |
| 07-26 | 更新 | 支持华为鲲鹏服务器，aarch64，感谢深度科技公司和华为云提供鲲鹏服务器。 |
| 07-06 | 更新 | 对于标题带有 NOIP 字样的比赛，比赛结束后才能看到结果。 |
| 07-04 | 更新 | 设置 $OJ_MARK="mark" 显示得分，$OJ_MARK="percent" 显示错误率(WA)或通过率（AC），设置 $OJ_MARK="" 只显示最终结果。 |
| 06-24 | 文档 | 对项目首页进行分块标注，调整顺序和内容，增加目录。 |
| 06-12 | 更新 | 添加 Fortran 语言、Matlab(Octave)，修订：比赛结束后编辑时丢失提交统计数据、修复部分RE。 |
| 05-18 | 修订 | 16.04以上版本FB显示异常。 基于OpenJudger的Windows集成便携版 浙传网盘 |
| 05-17 | 修订 | 改善ajax，减少并发量，降低web压力，提高judge轮询效率。 |
| 05-15 | 修订 | 修复了部分TLE误判为RE的情况，主要是在Ubuntu18/19 Deepin15.9/15.10 以上的版本，估计与gcc/g++有关。 |
| 05-07 | 更新 |
@muzea 提供了 Debian 安装包打包(*.deb)， https://github.com/zhblue/hustoj/releases
|
| 04-13 | 更新 | 支持 SQL 判题，基于 SQLite3 ，支持龙芯3A3000（致谢江苏航天龙梦信息技术有限公司提供龙芯主机！）。 |
| 03-14 | 更新 | 主线支持 树莓派(arm) 龙芯(loongson-2f) i386 x86_64 |
安装说明
视频教程
Ubuntu 18.04 安装 (https://www.bilibili.com/video/BV1Mp4y1C7Xx)
注意事项
根据你选择的发行版不同，从下面三个脚本里选一个来用。
不要相信百度来的长篇大论的所谓教程，那些都是好几年前的老皇历了，会导致不判题，不显示，不好升级等等问题。
尤其别装 Apache ，如果已经安装，请先停用或卸载，以免80端口冲突。
不要 使用 宝塔 LNMP LAMP Cpanel 或其他面板程序提供的 Mysql Nginx Apache PHP 环境，安装脚本已经包含所有必须环境的安装。
腾讯云用户请 换软件源 ，增加 multiverse 。
阿里云用户请百度 阿里云 80端口
校园网安装
近期 Github 的 SVN 访问缓慢，可以到 Releases 中下载 tar.gz 版本，然后用 install 目录下的 *-bytgz.sh 脚本安装。
但是注意这样安装的实例，将来升级时只能手工升级。
以 Ubuntu 18.04 为例：下载好 Releases 中的 Source code(tar.gz)，然后准备好 install-ubuntu18-bytgz.sh
sudo bash install-ubuntu18-bytgz.sh 19.06.04.tar.gz
基于 Ubuntu 20.04 安装
wget http://dl.hustoj.com/install-ubuntu20.04.sh
sudo bash install-ubuntu20.04.sh
提醒：阿里云的 Ubuntu 20.04 预装了 apparmor ，小概率可能会造成 systemd 和 umount 进程卡CPU 100%
可能的解决方案1:安装docker(运行judge_client目录下的docker.sh)并启用OJ_USE_DOCKER=1
或2:卸载阿里云盾。**
基于 Ubuntu 20.04 通过 Gitee 安装
wget https://gitee.com/zhblue/hustoj/raw/master/trunk/install/install-ubuntu20-gitee.sh
sudo bash install-ubuntu20-gitee.sh
基于 Ubuntu 18.04 通过 Gitee 安装
wget https://gitee.com/zhblue/hustoj/raw/master/trunk/install/install-ubuntu18-gitee.sh
sudo bash install-ubuntu18-gitee.sh
基于 Ubuntu 18.04 安装
各类公有云首选, 最容易，成功率最高，实际部署数量最多，开发者原型机
wget http://dl.hustoj.com/install-ubuntu18.04.sh
sudo bash install-ubuntu18.04.sh
Ubuntu 更换软件源
下列两个脚本可以二选一，对于使用腾讯云镜像和Ubuntu 原版镜像的用户，推荐使用脚本二。
- 脚本一
wget http://dl.hustoj.com/sources.list.sh
sudo bash sources.list.sh
- 脚本二
wget http://dl.hustoj.com/update-sources-ubuntu.sh
sudo bash update-sources-ubuntu.sh
基于 Deepin 15+ 安装
国内桌面用户 Deepin 15.9+ (内置QQ、微信、WPS方便出题人本地测试，最新15.11测试通过)
wget http://dl.hustoj.com/install-deepin15.9.sh
sudo bash install-deepin15.9.sh
基于 CentOS 安装
假如你不得已非要用centos7 （有的语言可能不支持，但是某些机架式服务器的Raid卡Ubuntu不认只能装CentOS），可以用下面脚本快速安装OJ：
wget https://raw.githubusercontent.com/zhblue/hustoj/master/trunk/install/install-centos7.sh
sudo bash install-centos7.sh
REDHAT / CentOS 用户请浏览
https://github.com/zhblue/hustoj/blob/master/wiki/CentOSx86_64.md
https://github.com/zhblue/hustoj/blob/master/wiki/CentOS.md
基于 Docker 安装
基于 Docker 安装，可用于快速体验 HUSTOJ 的全部功能，可能存在未知的魔法问题，请慎重考虑用于生产环境！！！
使用构建好的 Docker 镜像（GitLab CI/CD系统自动构建）
docker run -d \
--name hustoj \
-p 8080:80 \
-v ~/volume:/volume \
registry.gitlab.com/mgdream/hustoj
由于 Web端/数据库/判题机 全部被打包在同一个镜像，无法扩展，不推荐使用此镜像做分布式判题，另外请不要在 Docker 中使用 SHM 文件系统，会由于内存空间不足无法挂载沙箱环境而导致莫名其妙的运行错误
部署后使用浏览器访问 http://localhost:8080
基于Docker安装（分布式）
Docker分布式改造基本完成，目前支持web/mysql/judge基础镜像，支持使用环境变量进行配置。
目前judge镜像仍处于不稳定状态，有能力的用户对docker/judge进行完善。
在本地执行前需要先创建Docker网络docker network create hustoj，使用下面的命令来运行对应的服务。
- MySQL服务
docker run -d \
--network hustoj \
--name hustoj.mysql \
-e MYSQL_USER=<mysql_username> \
-e MYSQL_PASSWORD=<mysql_password> \
-v mysql:/var/lib/mysql \
registry.gitlab.com/mgdream/hustoj:mysql
基础镜像为mysql:5.7，所有的环境变量都继承自mysql:5.7官方镜像，默认提供数据库为jol。
- Web服务
docker run -d \
--network hustoj
--name hustoj.web \
-e DB_HOST=<mysql_server> \
-e DB_NAME=<mysql_database> \
-e DB_USER=<mysql_username> \
-e DB_PASS=<mysql_password> \
-v data:/home/judge/data \
-p 80:80 \
registry.gitlab.com/mgdream/hustoj:web
基础镜像为ubuntu:18.04，使用php版本为php7.2，所有的环境变量都继承自db_info.inc.php文件，后续会完善php与nginx的环境变量配置。
基于其他发行版安装
其他的发行版，如树莓派的 raspbian8/9 , ubuntu14.04的安装脚本在 install 目录可以找到，但是不完善，安装后需要部分手工修复调整。
https://www.youtube.com/watch?v=hRap7ettUWc
树莓派用户请用 rpi 分支源码（实验性质）手工搭建 web ，并编译安装 core 目录下的 judged 和 judge_client 。
LiveCD下载安装
Linux不熟悉的用户推荐使用:
HUSTOJ_LiveCD(发送"livecd"到微信公众号 onlinejudge ，获得百度云下载链接)
HUSTOJ_Windows（仅支持XP,QQ群23361372共享文件）进行安装。
使用说明见iso中README,也可以参考LiveCD简介
Linux新手请看鸟哥的私房菜
建好系统需要题目，请访问TK题库 和 freeeproblemset项目
卸载阿里云盾
逐条执行下列代码删除阿里云盾：
# 卸载云盾
wget http://update.aegis.aliyun.com/download/uninstall.sh
chmod +x uninstall.sh
./uninstall.sh
wget http://update.aegis.aliyun.com/download/quartz_uninstall.sh
chmod +x quartz_uninstall.sh
./quartz_uninstall.sh
# 删除残留
pkill aliyun-service
rm -rf /etc/init.d/agentwatch /usr/sbin/aliyun-service
rm -rf /usr/local/aegis*
重启后若执行 ps -aux | grep -E 'aliyun|AliYunDun' 显示没有阿里云盾相关进程即为卸载成功。
装后须知
常见问题自动应答微信公众号: hustoj
关注后回复： 新装系统、升级、目录等关键词，系统会自动回复相关帮助。
有问题请先查阅
FAQ常见问答 和 Wiki使用技巧 或使用搜索引擎。
安装完成，用admin作为用户名注册一个用户，自动成为管理员。
大部分功能和选项的开关和参数调整都在配置文件中，安装后几个重要配置文件的位置如下：
| 路径 | 内容 |
|---|---|
/home/judge/etc/judge.conf |
判题 judged judge_client
|
/home/judge/src/web/include/db_info.inc.php |
Web |
/etc/php5/fpm/php.ini 或 /etc/php7.0/fpm/php.ini 或 /etc/php.ini (in Centos7) |
php |
/etc/nginx/sites-enabled/default 或 /etc/nginx/nginx.conf (in Centos7) |
nginx |
如果用户量比较大，报 50x 错误，可能需要修改 /etc/nginx/nginx.conf 中的设置：
worker_processes 8; #其中数字8可以取CPU核心数的整数倍。
events {
worker_connections 2048;
multi_accept on;
}
如果遇到比赛人数多，比赛排名 xls 文件无法下载，请修改 /etc/nginx/sites-enabled/default ，在 fastcgi_pass 一行的后面增加
fastcgi_buffer_size 128k;
fastcgi_buffers 32 32k;
保存后，重启 nginx
备份
脚本安装的用户，可以使用 install 目录中的 bak.sh进行备份。
sudo bash /home/judge/src/install/bak.sh
备份后的数据在 /var/backups/ 目录下, 命名格式为 hustoj_%Y%m%d.tar.bz2。
百度学习crontab的用法后，可以使用 sudo crontab -e 定制自动备份计划，部分安装脚本中包含了自动备份，但可能需要运行上面的语句一次来激活。
迁移到CentOS
如果你需要进行跨系统迁移（如从 Ubuntu 迁移到 CentOS ），可以尝试使用下面的脚本backup+.sh进行备份, 对应的*.tar.gz，备份的文件需要用restore+.sh还原。
sudo bash /home/judge/src/install/backup+.sh #备份后的归档在 `/home/judge/backup` 命名格式为 +%Y-%m-%d-%H-%M-%S.tar.gz
迁移
首先在新服务器上做全新安装和测试，没有问题后，再迁移数据。
将你需要迁移的归档复制到目标系统的/home/judge/backup目录下，执行下面的脚本进行恢复
cd /home/judge/backup
sudo bash /home/judge/src/install/restore.sh hustoj_%Y%m%d.tar.bz2
脚本的第一个参数为恢复的目标归档，如果没有参数则默认为按名字排序后字典序最大的归档
*如果是backup+.sh备份的.tar.gz文件，用restore+.sh还原。
cd /home/judge/backup
sudo bash /home/judge/src/install/restore+.sh +%Y-%m-%d-%H-%M-%S.tar.gz
更新升级
脚本安装的用户，可以使用 install 目录中的 update-hustoj 进行更新升级。
sudo bash /home/judge/src/install/update-hustoj
升级脚本执行后，可能需要登陆web端管理后台，执行一次更新数据库。
修复
自己不小心改坏了 web 代码，可以使用 install 目录中的 fixing.sh 进行系统修复。
sudo bash /home/judge/src/install/fixing.sh
支持捐助、加入社区
使用上需要帮助，请加用户交流 QQ 群 23361372 ，验证问题答案：开源软件。
或加TG群。
群共享有题库、安装盘、文档 ，群内可以讨论、答疑 。
新加群，请改群名片，5分钟后可以发言。
请尊重开源软件开发者的辛苦劳动，出言不逊者将被踢出。
您可以用这几种方式支援本项目：
1、领取并使用支付宝红包
2、在 TK题库 充值下载题目
3、右上角点击Star，给本项目加星
4、保留您安装使用的系统中页脚的公众号和红包二维码
5、在您的论文中引用本项目的网址
6、向其他老师同学推荐本项目
系统演示
后台功能
硬件需求
更严谨的请求数 QPS 测试,请参考 @muzea 的 HUSTOJ web 跑分小工具 。
免费题库
访问项目FPS下载免费例程。
访问TK题库免费专区
FQ访问谷歌代码存档版，下载老版本 FPS 共享题库。