HUSTOJ

流行的OJ系统，跨平台、易安装、有题库。

重要提醒：阿里云的 Ubuntu 20.04 预装了 apparmor ，可能会造成 systemd 和 umount 进程卡CPU 100%，目前未找到解决方法，建议 卸载阿里云盾。

版权说明

HUSTOJ is an GPL Free Software.

HUSTOJ 是采用 GPL 的自由软件。(仅限原创部分代码，其中使用了其他开源项目的组件，请遵循原组件的协议。)

注意：基于本项目源码从事科研、论文、系统开发，请在文中或系统中表明来自于本项目的内容和创意。

论文请引用参考文献 基于开放式云平台的开源在线评测系统设计与实现

如果打算进行二次开发， Wiki 和这份 文档 可能有帮助。

PS: GPL保证你可以合法忽略以上注意事项但不能保证你不受鄙视，呵呵。

常见问题自动应答微信公众号:hustoj

关注后回复： 新装系统、升级、目录等关键词，系统会自动回复相关帮助。

有问题请先查阅 FAQ常见问答 和 Wiki使用技巧 或使用搜索引擎。

如果这个项目对你有用，请：

• 挥动鼠标，右上角给个 Star !
• 保留网站页脚的二维码
• 访问 tk题库 ，充值下载题目
• 向同学同事推荐这个项目
• 每天扫一扫本页底部的支付宝红包
• 在您的论文参考文献中写出本项目的网址

Star us, please!

推荐云服务商

UCloud年度大促 快杰云主机推广

目录

更新日志

安装说明

注意事项

校园网安装

基于 Ubuntu 20.04 安装 各类公有云首选, 各类软件最新，有问题提交issues，第一时间处理

基于 Ubuntu 18.04 安装 本地、内网部署首选，实际部署数量最多，稳定可靠

Ubuntu 更换软件源

基于Deepin深度15安装

基于CentOS安装

基于Docker安装

基于其他发行版安装

LiveCD下载安装

卸载阿里云盾

装后须知

备份

迁移

更新升级

修复

支持捐助、加入社区

二次开发

系统演示

硬件需求

免费题库

求助 报错

如果您喜欢在线聊天，希望问题获得及时反馈，不介意付费获得服务，请加官方QQ群 23361372 ：点我加群

更新日志

安装说明

视频教程

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 安装

重要提醒：阿里云的 Ubuntu 20.04 预装了 apparmor ，可能会造成 systemd 和 umount 进程卡CPU 100%，目前未找到解决方法，建议 卸载阿里云盾。

wget http://dl.hustoj.com/install-ubuntu20.04.sh
sudo bash install-ubuntu20.04.sh

基于 Ubuntu 20.04 通过 Gitee 安装

重要提醒：阿里云的 Ubuntu 20.04 预装了 apparmor ，可能会造成 systemd 和 umount 进程卡CPU 100%，目前未找到解决方法，建议 卸载阿里云盾。

腾讯云用户请点我查看换软件源方法

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作为用户名注册一个用户，自动成为管理员。

大部分功能和选项的开关和参数调整都在配置文件中，安装后几个重要配置文件的位置如下：

如果用户量比较大，报 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/ 目录下。

百度学习crontab的用法后，可以使用 sudo crontab -e 定制自动备份计划，部分安装脚本中包含了自动备份，但可能需要运行上面的语句一次来激活。

迁移

如果你需要进行跨系统迁移（如从 Ubuntu 迁移到 CentOS ），可以尝试使用下面的脚本进行备份

sudo bash /home/judge/src/install/backup+.sh

备份后的归档在 /home/judge/backup ，命名格式为 hustoj_%Y%m%d.tar.bz2

将你需要迁移的归档复制到目标系统的/home/judge/backup目录下，执行下面的脚本进行恢复

sudo bash /home/judge/src/install/restore.sh <hustoj_%Y%m%d.tar.bz2>

脚本的第一个参数为恢复的目标归档，如果没有参数则默认为按名字排序后字典序最大的归档

更新升级

脚本安装的用户，可以使用 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 共享题库。