HUSTOJ

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

常见问题请先查阅

FAQ

目录

模板演示

版权说明

致谢

更新日志

支持捐助、加入社区

免费题库

求助 报错

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

自带的6种模板演示

bs3原版

sweet主题

syzoj主题 added by@renbaoshuo

bshark主题 added by @yemaster

mdui主题 added by@renbaoshuo

修改 db_info.inc.php[默认位置/home/judge/src/web/include] 中 $OJ_TEMPLATE 的值，即可使用上述模板。

版权说明

HUSTOJ is an GPL Free Software.

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

感谢下述及其他被使用到的开源代码项目贡献者

• masteroj uoj loj syzoj zoj qduoj openJudger
• linux apache nginx php mysql mariadb memcached
• bootstrap kindeditor ACEeditor blockly codemirror katex phpfilemanager mdui
• sim gcc clang openjdk freepascal mono docker SyntaxHighlighter

排名不分先后本列表欢迎补充

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

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

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

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

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

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

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

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

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

Star us, please!

更新日志

安装说明

视频教程

Ubuntu 18.04 安装 (https://www.bilibili.com/video/BV1Mp4y1C7Xx)

注意事项

根据你选择的发行版不同，从下面三个脚本里选一个来用。

不要相信百度来的长篇大论的所谓教程，那些都是好几年前的老皇历了，会导致不判题，不显示，不好升级等等问题。

尤其别装 Apache ，如果已经安装，请先停用或卸载，以免80端口冲突。

不要 使用 LNMP LAMP Cpanel 或其他面板程序提供的 Mysql Nginx Apache PHP 环境，安装脚本已经包含所有必须环境的安装。

腾讯云用户请 换软件源 ，增加 multiverse 。

阿里云用户请百度 阿里云 80端口

基于 Ubuntu 22.04 安装

仅支持原生Ubuntu系统，不支持WSL和docker中的Ubuntu系统

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

基于 Ubuntu 20.04 安装

各类公有云首选, 最容易，成功率最高，近期部署数量最多，开发者原型机

仅支持原生Ubuntu系统，不支持WSL和docker中的Ubuntu系统

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

脚本运行完成直接浏览器输入ip地址即可访问，如不能打开请检查访问策略、防火墙设置是否打开80端口。

提醒：阿里云的 Ubuntu 20.04 预装了 apparmor ，小概率可能会造成 systemd 和 umount 进程卡CPU 100% 可能的解决方案1:安装docker(运行judge_client目录下的docker.sh)并启用OJ_USE_DOCKER=1 或2:卸载阿里云盾。**

基于 Ubuntu 18.04 安装 即将脱离维护期，不推荐

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

校园网安装

近期 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+宝塔 安装

先看宝塔系统安装HUSTOJ指南v0.2.docx

wget http://dl.hustoj.com/install-ubuntu-bt.sh
sudo bash install-ubuntu-bt.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 20+ 安装

国内桌面用户 Deepin 20+ (内置QQ、微信、WPS方便出题人本地测试，最新20测试通过)

wget http://dl.hustoj.com/install-deepin20+.sh
sudo bash install-deepin20+.sh

基于 UOS 20+ 安装

国内桌面用户 UOS 20+ (内置QQ、微信、WPS方便出题人本地测试，最新20测试通过)

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

基于 CentOS 安装 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的环境变量配置。

基于其他发行版安装

其他的发行版，如Debian10+(Debian10/11) 树莓派的 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' 显示没有阿里云盾相关进程即为卸载成功。

装后须知

Python重度用户注意查阅

常见问题自动应答微信公众号: 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/ 目录下, 命名格式为 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端管理后台，执行一次更新数据库。

• hustoj开源版的所有历史版本，只要没有对数据库结构进行改动，都可以无损升级到最新版本，包括10年以上历史的早期版本。
• 如果老系统更新有疑问，随时加官方群咨询群主。

修复

自己不小心改坏了 web 代码，可以使用 install 目录中的 fixing.sh 进行系统修复。

sudo bash /home/judge/src/install/fixing.sh

支持捐助、加入社区

使用上需要帮助，请加用户交流 QQ 群 23361372 ，验证问题答案：开源软件。

或加TG群。

群共享有题库、安装盘、文档 ，群内可以讨论、答疑 。 新加群，请改群名片，5分钟后可以发言。 请尊重开源软件开发者的辛苦劳动，出言不逊者将被踢出。

您可以用这几种方式支援本项目：

1、领取并使用支付宝红包

2、在 TK题库 充值下载题目

3、右上角点击Star，给本项目加星

4、保留您安装使用的系统中页脚的公众号和红包二维码

5、在您的论文中引用本项目的网址

6、向其他老师同学推荐本项目

系统演示

前台演示 龙芯部署

后台功能

硬件需求

x86 arm mips 架构处理器， 1G以上内存，10G外部存储。

阿里云，腾讯云，华为云，最小学生机均可稳定运行。

更严谨的请求数 QPS 测试,请参考 @muzea 的 HUSTOJ web 跑分小工具 。

免费题库

访问项目FPS下载免费例程。

访问TK题库免费专区

FQ访问谷歌代码存档版，下载老版本 FPS 共享题库。

推荐云服务商

搬-瓦+工 UCloud年度大促 快杰云主机推广

推荐开源IDE

小熊猫