# hustoj

**Repository Path**: leaganpt_admin/hustoj

## Basic Information

- **Project Name**: hustoj
- **Description**: hustoj -- 流行的OJ系统，跨平台、易安装、有题库
- **Primary Language**: PHP
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 82
- **Created**: 2020-04-04
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HUSTOJ

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

## 版权说明

HUSTOJ is an [GPL](https://github.com/zhblue/hustoj/blob/master/trunk/web/gpl-2.0.txt) Free Software.

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

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

论文请引用参考文献 [基于开放式云平台的开源在线评测系统设计与实现](http://kns.cnki.net/KCMS/detail/detail.aspx?dbcode=CJFQ&dbname=CJFD2012&filename=JSJA2012S3088) 

如果打算进行二次开发， [Wiki](https://github.com/zhblue/hustoj/tree/master/wiki) 和这份 [文档](https://github.com/zhblue/hustoj/blob/master/wiki/hustoj%E6%96%87%E6%A1%A3%E5%A4%A7%E5%85%A8.pdf)可能有帮助。

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

常见问题自动应答微信公众号:`hustoj`          <img src="http://hustoj.com/wx.jpg" height="180" />

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

有问题请先查阅 **[FAQ常见问答](https://github.com/zhblue/hustoj/blob/master/wiki/FAQ.md)** 和 **[Wiki使用技巧](https://github.com/zhblue/hustoj/tree/master/wiki)** 或使用搜索引擎。 

新版 `wiki` （不全，整理中，非官方）：<https://wiki.hustoj.baoshuo.ren>


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

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

[热烈祝贺 CCPC2019 顺利举办！](http://rank.ccpc.io/)

Star us, please!


## 目录

[更新日志](#更新日志)

[安装说明](#安装说明)

[注意事项](#注意事项)

[校园网安装](#校园网安装)

[基于 Ubuntu 20.04 安装（Preview）](#基于-ubuntu-2004-安装)

[基于 Ubuntu 18.04 安装](#基于-ubuntu-1804-安装-腾讯云用户请换软件源)

[基于Deepin深度15安装](#基于-deepin-15-安装)

[基于CentOS安装](#基于-centos-安装)

[基于Docker安装](#基于-docker-安装)

[基于其他发行版安装](#基于其他发行版安装)

[LiveCD下载安装](#livecd下载安装)

[装后须知](#装后须知)

[备份](#备份)

[迁移](#迁移)

[升级](#升级)

[支持捐助、加入社区](#支持捐助加入社区)

[二次开发](https://github.com/zhblue/hustoj/blob/master/wiki/SecondaryDevelopment.md)

[系统演示](#系统演示)

[硬件需求](#硬件需求)

[免费题库](#免费题库)

[求助 报错](https://github.com/zhblue/hustoj/issues/new/choose)

如果您喜欢在线聊天，希望问题获得及时反馈，不介意付费获得服务，请加官方QQ群 `23361372` ：[点我加群](https://shang.qq.com/wpa/qunwpa?idkey=d52c3b12ddaffb43420d308d39118fafe5313e271769277a5ac49a6fae63cf7a)

## 更新日志

### 2020年

日期   | 类型 | 更新内容
----- | :--: | :-------
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集成代码](https://github.com/zhblue/hustoj/blob/master/wiki/MoodleIntegration.md)，实现HUSTOJ给moodle系统作业自动判分。
01-20 | 更新 | 删除 `noip` 模式比赛的多余提交记录，允许自定义 `noip` 关键词，增加 `privilege` 表 `user_id` 索引。

### 2019年

日期  | 类型 | 更新内容
----- | :--: | :-------
12-19 | 更新 | 增加了 `judge.conf` 中的注释，提供了备案号变量 `$OJ_BEIAN` ，对系统判题时间分辨率进行了更新优化，提高灵活度。
11-23 | 喜讯 | `hustoj` 在首届深度软件开发大赛中获得三等奖。
11-21 | 补丁 | 修复比赛中点击 `Edit` 按钮后可以选择出题人禁用的语言提交【感谢湘潭大学谢老师的报告】。
11-20 | 更新 | 在运行结果对比输出（`OJ_SHOW_DIFF`）中提示每个数据点的结果(AC/WA/TLE...)。
11-16 | 优化 | [@muzea](https://github.com/muzea) 开发了从 GitHub 到 [Gitee](https://gitee.com/zhblue/hustoj) 的同步机制，并部署了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集成便携版](https://github.com/Azure99/WinHustOJ/releases) [浙传网盘](https://pan.cuz.edu.cn:8443/share/b02149ee631b2776e93590b461)
05-17 | 修订 | 改善ajax，减少并发量，降低web压力，提高judge轮询效率。
05-15 | 修订 | 修复了部分TLE误判为RE的情况，主要是在Ubuntu18/19 Deepin15.9/15.10 以上的版本，估计与gcc/g++有关。
05-07 | 更新 | [@muzea](https://github.com/muzea) 提供了 Debian 安装包打包(`*.deb`)， <https://github.com/zhblue/hustoj/releases>
04-13 | 更新 | 支持 SQL 判题，基于 `SQLite3` ，支持龙芯3A3000（致谢江苏航天龙梦信息技术有限公司提供龙芯主机！）。
03-14 | 更新 | 主线支持  树莓派(arm)  <b>龙芯(loongson-2f)</b>  i386 x86_64 

## 安装说明

### 注意事项

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

**不要相信百度来的长篇大论的所谓教程，那些都是好几年前的老皇历了，会导致不判题，不显示，不好升级等等问题。**
	
尤其**别装** `Apache` ，如果已经安装，请先停用或卸载，以免80端口冲突。

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

**腾讯云用户请 [换软件源](https://developer.aliyun.com/mirror/ubuntu)** ，增加 `multiverse` 。

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

### 校园网安装

近期 `Github` 的 SVN 访问缓慢，可以到 `release` 中下载 `tar.gz` 版本，然后用 `install` 目录下的 `*-bytgz.sh` 脚本安装。

但是注意这样安装的实例，将来升级时只能手工升级。

以 `Ubuntu 18.04` 为例：下载好 `Releases` 中的 `Source code(tar.gz)`，然后准备好 `install-ubuntu18-bytgz.sh`

```bash
sudo bash install-ubuntu18-bytgz.sh 19.06.04.tar.gz
```

### 基于 Ubuntu 20.04 安装

```bash
wget https://github.com/zhblue/hustoj/raw/master/trunk/install/install-ubuntu20.04.sh
sudo bash install-ubuntu20.04.sh
```

### 基于 Ubuntu 18.04 通过 Gitee 安装 / 腾讯云用户请[换软件源](https://developer.aliyun.com/mirror/ubuntu)

```bash
wget https://gitee.com/zhblue/hustoj/raw/master/trunk/install/install-ubuntu18-gitee.sh
sudo bash install-ubuntu18-gitee.sh
```

### 基于 Ubuntu 18.04 安装  / 腾讯云用户请[换软件源](https://developer.aliyun.com/mirror/ubuntu)
### 各类公有云首选, 最容易，成功率最高，实际部署数量最多，开发者原型机 ###

```bash
wget https://github.com/zhblue/hustoj/raw/master/trunk/install/install-ubuntu18.04.sh
sudo bash install-ubuntu18.04.sh
```
    
    
### 基于 Deepin 15+ 安装

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

```bash
wget https://github.com/zhblue/hustoj/raw/master/trunk/install/install-deepin15.9.sh
sudo bash install-deepin15.9.sh
```
    
### 基于 CentOS 安装

假如你不得已非要用centos7 （有的语言可能不支持，但是某些机架式服务器的Raid卡Ubuntu不认只能装CentOS），可以用下面脚本快速安装OJ：  

```bash
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系统自动构建）

```shell
docker run -d           \
    --name hustoj       \
    -p 8080:80          \
    -v ~/volume:/volume \
    registry.gitlab.com/mgdream/hustoj
```

由于 Web端/数据库/判题机 全部被打包在同一个镜像，无法扩展，不推荐使用此镜像做分布式判题，另外请不要在 Docker 中使用 SHM 文件系统，会由于内存空间不足无法挂载沙箱环境而导致莫名其妙的运行错误

部署后使用浏览器访问 <http://localhost:8080>

### 基于其他发行版安装

其他的发行版，如树莓派的 `raspbian8/9` , `ubuntu14.04`的安装脚本在 `install` 目录可以找到，但是不完善，安装后需要部分手工修复调整。

<https://www.youtube.com/watch?v=hRap7ettUWc>

树莓派用户请用 `rpi` 分支源码（实验性质）手工搭建 `web` ，并编译安装 `core` 目录下的 `judged` 和 `judge_client` 。

[更多安装方法](https://github.com/zhblue/hustoj/blob/master/trunk/install/README)


### LiveCD下载安装

Linux不熟悉的用户推荐使用:

HUSTOJ_LiveCD(发送"livecd"到微信公众号 `onlinejudge` ，获得百度云下载链接)

HUSTOJ_Windows（仅支持XP,QQ群23361372共享文件）进行安装。

使用说明见iso中README,也可以参考[LiveCD简介](https://github.com/zhblue/hustoj/tree/master/wiki/HUSTOJ_LiveCD.md)  

Linux新手请看[鸟哥的私房菜](http://cn.linux.vbird.org/linux_basic/linux_basic.php)

建好系统需要题目，请访问[TK题库](http://tk.hustoj.com/) 和 [freeeproblemset项目](https://github.com/zhblue/freeproblemset)


## 装后须知

常见问题自动应答微信公众号: `hustoj`
<img src="http://hustoj.com/wx.jpg" height="180">

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

有问题请先查阅
**[FAQ常见问答](https://github.com/zhblue/hustoj/blob/master/wiki/FAQ.md)** 和 **[Wiki使用技巧](https://github.com/zhblue/hustoj/tree/master/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` 中的设置：

```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 ），可以尝试使用下面的脚本进行备份

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

备份后的归档在 `/home/judge/backup` ，命名格式为`%Y-%m-%d-%H-%M-%S`

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

```shell
sudo bash /home/judge/src/install/restore+.sh
```

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

## 升级

脚本安装的用户，可以使用 `install` 目录中的 `update-hustoj` 进行升级。

```
sudo bash /home/judge/src/install/update-hustoj
```

升级脚本执行后，可能需要登陆web端管理后台，执行一次更新数据库。

## 修复

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


## 支持捐助、加入社区


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

或加[TG](https://t.me/hustoj2019)群。

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

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

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

<img src="http://tk.hustoj.com/upload/image/20180621/20180621190059_62537.png" width="140px" />

2、在 [TK题库](http://tk.hustoj.com) 充值下载题目

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

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

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

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

## 系统演示

[前台演示](http://hustoj.com/oj/)
[龙芯部署](http://loongson.hustoj.com/)

## 后台功能

<img src="https://raw.githubusercontent.com/zhblue/hustoj/master/wiki/menu.png" />

## 硬件需求

<img src="https://raw.githubusercontent.com/zhblue/hustoj/master/wiki/hardware.png" />

更严谨的请求数 QPS 测试,请参考 @muzea 的 [HUSTOJ web 跑分小工具](https://github.com/muzea/hustoj-benchmark) 。

## 免费题库

访问项目[FPS](https://github.com/zhblue/freeproblemset/tree/master/fps-examples)下载免费例程。

访问[TK题库免费专区](http://tk.hustoj.com/problemset.php?search=free)

FQ访问[谷歌代码存档版](http://code.google.com/p/freeproblemset)，下载老版本 FPS 共享题库。