hustoj搭建教程

装前相关

修改root密码

sudo passwd root
（输入root密码两次）

切换root账号

su root
（输入root密码）

安装

这里只以Ubuntu16.04为例（官方推荐系统，稳定+运行流畅），其他安装方式请查阅：github

基于Ubuntu16.04安装

首先安装ubuntu16.04（推荐使用,php7速度杠杠的），然后用下面脚本快速安装OJ：

wget https://raw.githubusercontent.com/zhblue/hustoj/master/trunk/install/install-ubuntu16+.sh
sudo bash install-ubuntu16+.sh

安装过程可能会提示设置sql数据库密码，按照提示操作即可

提示

安装需要root权限，安装过程快慢取决于机器配置以及网络质量，请不要中断安装过程，因为中断之后重新运行脚本会出很多不必要的BUG（或者你也可以把脚本分批执行）。

搭建成功的标志

在浏览器输入localhost（就是本机IP）如果呈现如下图所示内容，则搭建成功，否则需要重新运行：sudo bash install-ubuntu16+.sh

OJ调整(这里一定要看，需要设置数据库的信息)

修改相应的配置文件

db_info.inc.php
/home/judge/src/web/include

static  $DB_HOST="localhost";  数据库的服务器地址  
static  $DB_NAME="jol";        数据库名  
static  $DB_USER="root";       数据库用户名  
static  $DB_PASS="root";       数据库密码  
        // connect db   
static  $OJ_NAME="HUSTOJ";      OJ的名字，将取代页面标题等位
置HUSTOJ字样。  
static  $OJ_HOME="./";          OJ的首页地址  
static  $OJ_ADMIN="root@localhost"; 管理员email  
static  $OJ_DATA="/home/judge/data"; 测试数据所在目录，实际位置。  
static  $OJ_BBS="discuss";//"bbs" 论坛的形式，discuss为自带的简单论坛，bbs为外挂论坛，参考bbs.php代码。  
static  $OJ_ONLINE=false; 是否使用在线监控，需要消耗一定的内存和计算，因此如果并发大建议关闭  
static  $OJ_LANG="en";  默认的语言，中文为cn  
static  $OJ_SIM=true;   是否显示相似度检测的结果。  
static  $OJ_DICT=true;  是否启用在线英字典  
static  $OJ_LANGMASK=1008; //1mC 2mCPP 4mPascal 8mJava 16mRuby 32mBash 1008 for security reason to mask all other language 用掩码表示的OJ接受的提交语言，可以被比赛设定覆盖。  
static  $OJ_EDITE_AREA=true;// 是否启用高亮语法显示的提交界面，可以在线编程，无须IDE。  
static  $OJ_AUTO_SHARE=false;//true: 自动分享代码，启用的话，做出一道题就可以在该题的Status中看其他人的答案。  
static  $OJ_CSS="hoj.css"; 默认的css,可以选择dark.css和gcode.css,具有有限的界面制定效果。  
static  $OJ_SAE=false; //是否是在新浪的云平台运行web部分  
static  $OJ_VCODE=true; 是否启用图形登录、注册验证码。  
static  $OJ_APPENDCODE=false; 是否启用自动添加代码，启用的话，提交时会参考$OJ_DATA对应目录里是否有append.c一类的文件，有的话会把其中代码附加到对应语言的答案之后，巧妙使用可以指定main函数而要求学生编写main部分调用的函数。  
static  $OJ_MEMCACHE=false;是否使用memcache作为页面缓存，如果不启用则用/cache目录  
static  $OJ_MEMSERVER="127.0.0.1"; memcached的服务器地址  
static  $OJ_MEMPORT=11211;  memcached的端口  

judge.conf

/home/judge/etc

OJ_HOST_NAME=127.0.0.1 如果用mysql连接读取数据库，数据库的主机地址  
OJ_USER_NAME=root 数据库帐号  
OJ_PASSWORD=root 数据库密码  
OJ_DB_NAME=jol 数据库名称  
OJ_PORT_NUMBER=3306 数据库端口  
OJ_RUNNING=4 judged会启动judge_client判题，这里规定最多同时运行几个judge_client  
OJ_SLEEP_TIME=5 judged通过轮询数据库发现新任务，轮询间隔的休息时间，单位秒  
OJ_TOTAL=1 老式并发处理中总的judged数量  
OJ_MOD=0 老式并发处理中，本judged负责处理solution_id按照TOTAL取模后余数为几的任务。  
OJ_JAVA_TIME_BONUS=2 Java等虚拟机语言获得的额外运行时间。  
OJ_JAVA_MEMORY_BONUS=512 Java等虚拟机语言获得的额外内存。  
OJ_SIM_ENABLE=0 是否使用sim进行代码相似度的检测  
OJ_HTTP_JUDGE=0 是否使用HTTP方式连接数据库，如果启用，则前面的HOST_NAME等设置忽略。  
OJ_HTTP_BASEURL=http://127.0.0.1/JudgeOnline 使用HTTP方式连接数据库的基础地址，就是OJ的首页地址。  
OJ_HTTP_USERNAME=admin 使用HTTP方式所用的用户帐号（HTTP_JUDGE权限），该帐号登录时不能启用VCODE图形验证码，但可以登录成功后启用。  
OJ_HTTP_PASSWORD=admin 密码  
OJ_OI_MODE=0 是否启用OI模式，即无论是否出错都继续判剩余的数据，在ACM比赛中一旦出错就停止运行。  
OJ_SHM_RUN=0 是否使用/dev/shm的共享内存虚拟磁盘来运行答案，如果启用能提高判题速度，但需要较多内存。  
OJ_USE_MAX_TIME=1 是否使用所有测试数据中最大的运行时间作为最后运行时间，如果不启用则以所有测试数据的总时间作为超时判断依据。 

去除网站中的广告

/home/judge/src/web/template/bs3其中的js.phpjs.phpjs.php

sudo vi js.php

找到其中的

$("body").append("<div class=center > <img src='http://hustoj.com/wx.jpg' width='120px'><img src='http://hustoj.com/alipay.png' width='120px'><br> 欢迎关注微信公众号onlinejudge</div>");

修改（注释）为

/*
$("body").append("<div class=center > <img src='http://hustoj.com/wx.jpg' width='120px'><img src='http://hustoj.com/alipay.png' width='120px'><br> 欢迎关注微信公众号onlinejudge</div>");
*/

关于Vim的使用

• 按i进入编辑模式
• 按Esc进入命令模式
• 命令模式下按:wq!保存退出
  使用vim的过程中，如果上下左右变成ABCD了可以重装Vim解决

装后相关

管理员注册

安装完成，用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/
百度学习crontab的用法后，可以使用

sudo crontab -e

定制自动备份计划，部分安装脚本中包含了自动备份，但可能需要运行上面的语句一次来激活。

迁移

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

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

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

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

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

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

升级

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

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

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

修复

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

题库

题目的管理就不说了，OJ前端集成了相关操作

题目是fps/xml格式的，github整理了很多题目查看器。
推荐去TK题库下载（部分收费），支持本项目作者。