常见问答

不小心删除了admin的权限，如何修复？

sudo su
cd /home/judge/src/install
echo "insert into jol.privilege values('admin','administrator','true','N');" | ./mysql.sh

人多的时候，随机出现`"No input file specified"`

编辑/etc/php/7.4/fpm/pool.d/www.conf 修改设定 rlimit_files = 1024 为一个更大的值，如65535。修改后重启php-fpm进程（sudo service php7.4-fpm restart）生效。

明明已经过了10秒,为什么系统还是说我提交过于频繁?

sudo apt-get install tzdata 时区选择北京或上海
修改db_info.inc.php

- 老版本打开末尾关于时区的两行代码
- 新版本把OJ_FRIENDLY_LEVEL调到1

判题核心的原理是怎样的？

参考一下wiki
阅读一下judge_client.cc中的注释。

如何让学生账号在比赛中也能看到和练习一样的详细错误信息？

编辑db_info.inc.php,设置 $OJ_SHOW_DIFF=true;
打开文件reinfo.php 在27行和60行有两处详细注释，根据注释进行调整。

如何获得管理员权限？

操作系统Ubuntu的管理员权限是通过在安装过程中产生的账号运行sudo su切换到root。
OJ的管理员是安装完成后，第一个注册的用户用admin作为用户名注册，自动获得管理权限。
LiveCD的judge用户不能登陆，用户名ubuntu的密码是freeproblemset。

权限表里的记录都是什么含义?

以下权限是手动指派：

"administrator" 管理员，除查看源码外的所有权限。
"problem_editor"：题目编辑者，添加和编辑题目。
"source_browser"：查看审核所有提交的源代码，对比可疑的相似代码。
"contest_creator"：组织创建比赛，编辑比赛。
"http_judge"：HTTP远程判题账号。
"password_setter"：重置普通账户密码。
"printer"：现场赛打印员，注意该账户的school字段用于分配打印任务，如果只有一个打印区则置空。
"balloon"：气球配送员，注意该账户的school字段用于分配气球任务，如果只有一个气球配送区则置空。
"vip"：可以参与所有标题含有VIP字样的私有比赛。
"problem_start"：HTTP远程判题账户的任务起始题号。
"problem_end"：HTTP远程判题账户的任务结束题号。

新赋予的权限需要重新登陆获得！

以下权限是系统自动生成：

p+数字：题目的独立编辑权，管理员可以编辑所有题目，problem_editor只能编辑自己添加的题目。
m+数字: 比赛的独立编辑权，管理员可以编辑所有比赛，contest_creator只能编辑自己添加的比赛。
c+数字：比赛的参与权，私有比赛只有有权限或者知道密码的用户可以参与。

如何使用题单功能？

在新闻内容中编写,格式为:

[plist=题号列表]题单名[/plist]

也可以在题目列表里，勾选题目后，点击NewProblemList按钮（仅限bs3模板使用）。

脚本把OJ装在哪里了？可以卸载么？

脚本安装默认位置在/home/judge，其中src是全部源码，data是测试数据,etc目录是判题端的配置文件，install目录是各种工具脚本。
src/web/upload目录存放着所有上传的图片，包括新闻与题目的图片。
Ubuntu中默认的数据库文件放置在/var/lib/mysql，但是不建议直接备份库文件，而是推荐用install目录中的bak.sh进行备份。
如果想卸载，可以参考src/install/uninstall.sh，注意卸载脚本不考虑服务器上可能存在的其他Web系统，请谨慎使用。
对于正在运行中的生产服务器，任何操作前请做好离线备份。
备份文件一定要解压查看内部是否包含全部数据，关注备份的大小（大系统备份应该有上百兆），有条件找虚拟机实测还原是否成功

题目的限时和内存限制的精度是怎样的？

题目限时允许设定的字面精度是0.001s,但是由于操作系统内核参数的限定，实测的精度通常为4ms。
judge.conf中有个OJ_CPU_COMPENSATION来标注当前系统的CPU速度，安装脚本自动根据BogoMIPS的值来设定。
当BogoMIPS的值为5000时，这个值为1.000，当CPU的速度更快时，这个值为大于1.000的值。
最终系统记录的时间，将按照这个系数进行调整，对于对时间精度要求较高的场合，如正式比赛，或者判题机配置不均衡的情况，可以通过手工调节该参数，让不同的判题机对于相同题目的运行结果趋于一致。

内存限制的精度是1MB，对于本地native的编译型语言c/c++/pascal/freebasic/clang等是考察程序本身的内存申请空间; 对于虚拟机和脚本语言，则包含了虚拟机本身或解释器本身的内存消耗。

测试文件的大小、数量有什么限制？

一般情况下，单个测试文件大小建议不超过10M，测试文件总量10组（.in + .out）。

源码中对测试文件大小有个上限 STD_F_LIM = 32M 定义生效
在OJ_OI_MODE=1的情况下，题目限时是依赖于OJ_TIME_LIMIT_TO_TOTAL的：
当OJ_TIME_LIMIT_TO_TOTAL=1 限时应用于所有数据的总耗时
当OJ_TIME_LIMIT_TO_TOTAL=0，限时应用于每组测试文件。
状态页status.php(solution表)中记录的时间，取决于OJ_USE_MAX_TIME：
当OJ_USE_MAX_TIME=0时，记录的是总耗时。
当OJ_USE_MAX_TIME=1时，记录的是最高耗时。因此，当测试数据组数较多时，推荐设定OJ_USE_MAX_TIME=0，OJ_TIME_LIMIT_TO_TOTAL=1 。

测试文件的文件名命名有什么规则？

一般推荐用英文命名，相同文件名的.in .out文件为一组。
不支持.ans的扩展名，请在上传前用Windows的命令行统一修改ren *.ans *.out。
支持在文件名中使用方括号[]来标注分数。如 test01[20].in / test01[20].out将视为分数是20分,未标注的文件按10分计分，系统最终根据所有文件的总分和运行得分，记录提交的通过率pass_rate放入solution表，用于前台显示。
评测的时候根据所有.in文件的字典序来评测, 因此test10先于test2评测, 后于test02评测。

为什么我的系统卡在编译中

如果修改了数据库密码，请注意除了db_info.inc.php需要修改，还需要修改judge.conf中的数据库密码，并需要重启judged进程。
如果judge.conf中启用了OJ_USE_DOCKER=1，请确保禁用了OJ_SHM_RUN=0，并检查run0等目录是真实的目录而非软连接。
如果如果OJ_USE_DOCKER=0时系统正常，OJ_USE_DOCKER=1时卡住，请检查install目录下的Dockerfile文件内容是否符合需求，并再次运行docker.sh确认运行结果正常。
修改OJ_USER_DOCKER参数，需要重启judged生效，方法是sudo pkill -9 judged && sudo judged

为什么提交代码/在某些特定页面显示“连接已重置“ (connection_reset) ?

请确认”连接已重置“是特定操作(可永远复现)后出现的
请确认OJ还有能正常访问的页面
如果符合以上两条, 那么可能是您所在的区域的网管启用了WAF, 监测到传向OJ的流量中有违禁内容, 所以进行了reset.
解决方法: 联系网管, 让他添加白名单...
参考:一个案例

正式比赛或大规模系统需要注意哪些问题？

正式比赛推荐激活db_info.inc.php中的两个参数。

//static  $OJ_EXAM_CONTEST_ID=1000; // 启用考试状态，填写考试比赛ID
//static  $OJ_ON_SITE_CONTEST_ID=1000; //启用现场赛状态，填写现场赛比赛ID

对于公网上的系统，推荐使用阿里云的RDS作为数据库服务器，然后根据比赛规模分别部署一定数量的判题机和Web服务器，通过域名解析进行Web访问的负载均衡。
Web服务器和判题机都和RDS配置在同一专用网络中，使用mysql直连数据库。
Web服务器都增加Memcached做页面缓存。
可以配置php用Memcached存放session数据。
判题机测试数据提前复制，并配置证书登陆、编写rsync脚本方便覆盖同步。
判题机开启UDP监听(judge.conf:OJ_UDP_ENABLE等参数)，Web服务器配置好UDP任务推送(db_info.inc.php:$OJ_UDP等参数)。
安装配置完成后，可以从任意一台Web服务器导入一个特制的FPS文件，这个文件中可以提前复制粘贴数百份solution。
导入后，可以模拟大量提交，然后观察全部判题队列的运行时间，推算平均判题速度，观察判题机分配是否均匀，判题结果是否一致，耗时内存是否接近。

NOI SCP CCF 新标准使用C++14，如何在hustoj中更改默认的编译参数。

最新版本已经更新默认C++标准为C++14，直接升级即可。对于2021年7月份之后安装的用户，judge.conf中自己增加一个OJ_CPP_STD=-std=c++14即可。

C++ 中的gets函数哪里去了？为何编译报错？

根据 https://zh.cppreference.com/w/cpp/io/c/gets , gets函数已经被移除。可以使用#define gets(S) fgets(S,sizeof(S),stdin) 作为兼容性宏替换。

Python判题好慢好慢，如何加速？

如果你的系统主要为Python服务，可以修改/home/judge/etc/judge.conf 设定 OJ_PYTHON_FREE=1 为了增加安全性，请在/home/judge/src/install目录运行sudo bash docker.sh，然后修改/home/judge/etc/judge.conf 设定 OJ_USE_DOCKER=1 这样设定后，可以提高Python的判题速度，并提供额外的安全防护。推荐使用Ubuntu20.04作为基础系统，这个针对Python优化的方案在其他发行版未经测试。

为什么提交后没有记录？

可能是没有填写验证码，或者昵称过长，或者是数据库结构不是最新版（Web代码和数据库版本不一致）。建议后台-系统管理-系统-更新数据库-Update点击一次。

如何使用HTTP判题模式

1、注册一个新的账户例如judger1，用作判题。 2、用管理员登陆后台，给这个判题账户增加HTTP_JUDGE权限。 3、修改判题机judge.conf，设置好相关字段

   OJ_HTTP_JUDGE=1
   OJ_HTTP_BASEURL=http://OJ系统URL地址/
   OJ_HTTP_USERNAME=judger1
   OJ_HTTP_PASSWORD=judger1password

4、修改db_info.inc.php，禁用$OJ_VCODE验证码。 5、重启判题机

	sudo pkill -9 judged
   sudo judged

另参考 https://github.com/zhblue/hustoj/blob/master/wiki/HTTPJudge.md

是否可以只由管理员来注册账号，自己不能注册

可以，设置db_info.inc.php中的选项， https://github.com/zhblue/hustoj/blob/master/trunk/web/include/db_info.inc.php#L51

static $OJ_REGISTER=true; //true允许注册新用户,false禁止注册
static $OJ_REG_NEED_CONFIRM=true; //true新注册用户需要审核,false无需审核直接登陆

关闭注册后，管理员可以在后台“比赛队账户生成器”，生成指定数量的账户用于分配。 http://xxxx.xxxxx/admin/team_generate.php

如何显示MathJax语法的公式？

修改db_info.inc.php设置

static  $OJ_MATHJAX=true;  // 激活mathjax

需要用户能够正常访问互联网，内网用户需要自行部署mathjax内网镜像，并修改template/bs3/problem.php中相关路径。

如何启用查重机制？

修改/home/judge/etc/judge.conf，设置

OJ_SIM_ENABLE=1

修改/home/judge/src/web/include/db_info.inc.php，设置

$OJ_SIM=true;

抄袭只对不同账号间生效，自己抄袭自己不计。拥有Source_browser权限的账号可以看到具体数值和对比。

不能访问github，国内网，如何通过gitee安装？

没关系，最新的脚本不能访问Github也能按照，只要确保你的软件源是完整可用的。通过下面语句可以测试软件源是否正常。

sudo apt-get update

如果没有产生关于无法访问的报错，就说明是正常的，可以直接运行首页的脚本。如果有报错，请检查dns是否正确，/etc/apt/source.list的内容是否正确。百度您的操作系统名称+版本号+软件源，如：Ubuntu 20.04 软件源，可能会找到修复的方法。

请问如何重启判题机？

sudo pkill -9 judged
sudo judged

XXXXX 这个文件是在哪的

在终端中执行:

   sudo find /home/judge -name "XXXXX"

数据库账号密码是什么，如何登陆mysql?

数据库账号密码存放在两个配置文件中：

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

新版本中，快速登陆mysql的脚本在install目录里，名字为mysql.sh 使用方法

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

后台导入问题失败

1、先用谷歌浏览器直接打开xml文件，看是否有语法错误，如果有，用文本编辑器修订提示的行号。

2、如果超过100M,可以先用EasyFPSViewer拆分成多个小文件，然后再导入。

3、对于HUSTOJ，可以先压缩为zip再上传导入

4、修改/etc/php/7.2/fpm/php.ini, 提高post_max_size、upload_max_filesize 、memory_limit、max_execution_time 的值。修改后执行sudo service php7.2-fpm restart生效。

电脑配置太高，造了很多数据还是没法卡住暴力怎么办？

修改/home/judge/etc/judge.conf

OJ_CPU_COMPENSATION=1.0

增加这个值可以降低CPU的评测速度，安装脚本根据CPU的bogomips值来初始化。最高不超过100，设为100可以将原先1ms的测试数据计成100ms。

为什么题目不见了/如何让比赛里的题目也可以在练习里做？

参考这里

其他主机怎么连接到oj?

这取决于买的阿里云还是校园网服务器，或者虚拟机：阿里云直接用阿里提供的公网ip访问，也可以添加域名解析后用域名访问。校园网，用学校提供的内网ip或二级域名访问。虚拟机，百度“【虚拟机的名字如virtualbox或vmware】+端口映射” ，把80端口转进去，然后用物理机的ip地址访问。

升级后似乎不能提交/判题了？

这多半意味着数据库结构与预期不一致，可以通过以下方法解决：

管理后台更新数据库
参考db.sql中的建表语句，对比修订当前库表结构
处理掉从老版本MySQL里带来，在新版MySQL中不再合法的日期数据，如：'0000-00-00'，然后参考前面的方案解决。

比赛后题目看不见了？

比赛的题目在比赛添加后，直到结束前，是不能在练习中看到和提交的，否则比赛将泄题或罚时被绕过。
私有比赛的题目，在比赛结束后，仍然保留，即使比赛被隐藏也是一样，这是为了防止下一届新生提前获知测试内容。
如果希望私有比赛后，题目公开可做，请将比赛切换为公开。

关于NOIP赛制

设置judge.conf中的OJ_OI_MODE=1 //不在单个数据点WA时停止判题，而是继续判题
设置db_info.inc.php中的 $OJ_MARK="mark"; // 非AC的提交结果显示得分而非错误比率
设置db_info.inc.php中的 $OJ_OI_1_SOLUTION_ONLY=true; //比赛是否采用noip中的仅保留最后一次提交的规则。
添加比赛时，比赛标题中包含"NOIP"这个关键词 // 赛后才能看结果
"NOIP"这个敏感词在db_info.inc.php中可以修改

随机的CE编译错误

检查OJ_RUNNING的设置与run?目录的对应关系，例如:OJ_RUNNING=2，需要run0 run1两个目录，属主judge，权限700。
有的题目CE有的题目AC，适当放宽judge_client.cc中compile函数里的CPU、内存、文件限制。约1234行前后。修改后需在core目录执行sudo bash make.sh

老版本

编译报错找不到mysql.h

如果使用debian或centos，可能默认安装的是mariadb不是mysql，这时请自行搜索安装mariadb的头文件。

debian里大约是

    sudo apt-get install libmariadb-dev

centos里大约是

    sudo yum install MariaDB-devel

Runtime Error:[ERROR] A Not allowed system call: runid:10735 CALLID:20 如何解决？

编辑okcalls64.h或okcalls32.h（取决于您使用的Linux版本uname -a出现x64字样则64位，i686字样则32位），在对应的语言数组里增加内容。如C或C++：

int LANG_CV[256] = { 85, 8,140, SYS_time, SYS_read, SYS_uname, SYS_write, SYS_open,
	SYS_close, SYS_execve, SYS_access, SYS_brk, SYS_munmap, SYS_mprotect,
	SYS_mmap2, SYS_fstat64, SYS_set_thread_area, 252, 0 };

将上述报错中CALLID:后的数字，增加到数组中非末尾的位置，如果这个数字是0，请加在首位。

int LANG_CV[256] = { 20, 85, 8,140, SYS_time, SYS_read, SYS_uname, SYS_write, SYS_open,
	SYS_close, SYS_execve, SYS_access, SYS_brk, SYS_munmap, SYS_mprotect,
	SYS_mmap2, SYS_fstat64, SYS_set_thread_area, 252, 0 };

修改完成，重新在core目录执行sudo ./make.sh 然后重新测试，如果发现再次出现类似错误，请留意CALLID数字变化，重复上述步骤直至问题消失。看不懂请移步知乎看更详细解释。

如何让判题程序忽略行尾的空白字符

在judge_client.cc头部增加宏定义 IGNORE_ESOL 或者修改 Makefile 增加 -DIGNORE_ESOL 参数。

配置文件里的字段什么含义?

点击Configuration

多组数据怎么上传？

加好题目后在题目列表找TestData，点击上传。主文件名一样的*.in *.out，如test1.in test1.out

通过.tar.gz源码安装的应该怎么升级？

到安装文件目录找到hustoj-read-only目录 sudo svn up hustoj-read-only cd hustoj-read-only/core sudo ./make.sh sudo svn up /var/www/JudgeOnline

遇到问题，回答mc

为何页面总是需要刷新才能显示？

如果您使用的是ie6浏览器，请禁用服务器上的deflate模块，在ubuntu下的命令是

sudo rm /etc/apache2/mods-enabled/deflate.* sudo /etc/init.d/apache2 restart

CentOS 用户

点击CentOS

使用HUSTOJ要花多少钱？

不要钱，我们是GPL的。

管理员如何添加，如何管理？

查看安装说明[README],管理员登录后有Admin菜单。

为什么我提交的答案始终在pending？

判题程序judged需要用root帐号启动，请重启服务器或手动执行sudo judged。如果无效，请检查/home/judge/etc/judge.conf中的数据库账号配置,参考[Configuration]，修正后再次重启服务器或执行sudo pkill -9 judged等待一会儿再执行sudo judged

为什么添加题目时出现warning,题目目录下数据没有自动生成？

您需要修改测试数据目录,给予php-fpm操作数据目录的权限。Ubuntu下php-fpm运行的用户身份是www-data

chgrp www-data -R /home/judge/data 
chmod g+rw -R /home/judge/data

为什么我添加的题目普通用户看不到？

题目默认为删除状态，只有管理员能访问，当管理员确认题目没有问题后，可以点击ProblemList中红色的Reserved,切换为绿色的Available启用题目。

为何我的C/C++都能用，唯独Java总是CE/RE？

　　目前只支持sun原版jdk和openjdk，其他jdk暂不能保证支持。如果你用的是64位系统，你可能需要自己调整一下源代码。请联系我。

我是管理员，为什么不能查看别人的源码？

请给自己增加source_browser权限。issue1

如何更新到最新版本？

svn up /var/www/JudgeOnline
或重新运行install.sh
升级并编译内核make.sh
然后用管理员登陆，后台执行update_database(更新数据库)。

如何从POJ的免费版迁移？

参考[POJ2HUSTOJ]

我有问题怎么办？

到issues去提问，new issue

如何获得管理员帐号？

注册一个叫admin的用户，自动获得权限。

如何进入后台？

以管理员身份登录，点击Admin/管理进入后台。

如何添加题目？

进入后台，点击左侧NewProblem。

如何添加测试数据？

添加题目时，可以在test input/test output添加一组测试数据，大规模的数据（10kb+）和更多的数据，可以在添加完题目后，通过ftp/sftp,上传到题目对应目录，通常是 /home/judge/data/题号。命名规则是输入数据以.in结尾，输出数据以.out结尾，主文件名相同。

如何编辑题目？

后台中点击ProblemList,找到需要编辑的题目，点击Edit。编辑时不能修改测试数据，测试数据请使用ftp工具修改。

如何启用题目？

题目添加后，默认是停用状态，以防比赛提前漏题，后台中点击ProblemList，找到题目，点击Reserved 切换为Available启用题目，或者组织比赛，比赛中的题目将自动启用。

如何组织比赛？

在题目列表ProblemList中选择使用的题目，在PID一栏打钩，点击CheckToNewContest按钮，进入到比赛添加页面，输入比赛名称，设定比赛时间，语言类型，访问权限提交即可。
也可以使用管理菜单中的NewContest,需要手动输入题目编号，用英文逗号分隔。

如何修改、删除比赛？

点击比赛列表ContestList，选择Edit或Delete。

如何修改公告信息？

点击SetMessage。修改无效请检查admin/msg.txt是否对php账号(www-data)可写

如何修改用户密码？

点击ChangPassWD

如何重新判题？

点击Rejudge,输入题号或运行编号。

如何增加用户权限？

Addprivilege/添加权限, administrator为管理员，source_browser为代码审查，contest_creator为比赛组织者。通常给使用系统的老师分配代码审查和比赛组织者权限即可。

如何导入、导出题目？

使用ImportProblem，上传FPS文件。
使用ExportProblem，输入起始编号，结束编号，或题号列表，如果输入了列表，起始结束将不起作用。

如何更新数据库结构？

系统升级中，有对数据库的修改，这些修改不能通过SVN实现自动更新，如果发现升级web/core代码后系统报错，可以执行update database操作，进行数据库升级。因为脚本中有测试代码，所以重复执行不会造成影响。

如何下载新题目？

访问FreeProblemSet,查看Downloads列表。

为何fckeditor上传的图片在题目中无法显示？

如果web安装位置不在/JudgeOnline，需要手工修改

/fckeditor/editor/filemanager/connectors/php/config.php37行 $Config['UserFilesPath'] = '/JudgeOnline/upload/'.date("Ym")."/" ;

将JudgeOnline修改为对应的OJ web路径,如oj。

Why the added problem don't show up to non-admin users?

problem is deleted when first added, admin need to Resume them in the "Problem List"

I install hustoj on CentOS, why it doesn't work?

disable your SELinux and check /etc/php.ini for short_open_tag = On

Why Java can't work?

Try SUN-JDK or openjdk,if you are working with a 64bit System, check issue25

How much dollar to get this system ?

0, God bless GPL.

Files

FAQ.md

Latest commit

History