404
Page not found
That’s a Four-Oh-Four.
参照本文 https://hydro.ac/discuss/6172ceeed850d38c79ae18f9 无服务器快速体验系统功能。
如果你没有二开很多功能的需求，推荐直接使用在线服务。超过两万题的题库可以直接复制使用，无需购置云服务器，无需手动维护，更省心。
如果你有需要绑定自己的域名或是改 Logo 等等自定义需求，也可在管理面板中开通高级功能自助操作。
系统中的用户只有编辑、禁用功能，没有删除功能，这是为了从根源上防止出现“教学事故”，请不要要求增加相关功能，如果认为自己绝不会误操作，请自行开发相关功能。
现在你所使用的评测系统也仅仅是一个程序，并没有人工智能。因此很多地方需要你来迁就它，如果不这样做，你的答案即使本质上是正确的，由于形式的错误造成系统不能理解，也会导致错误。
系统运行过程如下：
在了解了上面的情况以后，同学们应该理解，如果题目没有要求程序输出“Please Input Two Number”之类的提示信息，那么自行输出这些文字将导致你的程序输出与老师事先告诉系统的输出不能做到“一字不差”，因而将导致系统报答案错误。
如果题目要求每两行输出之间要空一行，结果你没有空，会是格式错误，反之亦然。
也许你会觉得，哦，这系统太烂了，这点东西都不能自动识别；实际上正是这样才能有效训练大家编程的精确性、养成良好的代码习惯。很多程序高手都跟你一样，是从对这个系统吐槽开始学习如何认真仔细的、一丝不苟的进行编程的。
系统为了能用统一的方式运行所有同学的答案，不得不对所有人提交的答案的形式进行限定。
对于学习C、C++语言的同学来说，所有提交给系统的答案必须包含并且只有一个main函数，这个main函数必须返回int类型，并且最好返回0，因为操作系统对非零的返回值认为是运行出错。
编译错误发生时，点击“编译错误”的文字链接可以得到详细解释。
删除 .yarnrc.yml 和 .yarn 后再试。
如果您使用的是 阿里云/腾讯云 等服务商，请确保安全组放行了 80 和 443 端口。
反向代理时请确保设置了正确的 Host Header。详细说明
hydrooj backup hydrooj restore backup-xxx.zip
百度学习 crontab 的用法后，可以使用 sudo crontab -e 定制自动备份计划。
关闭 minio (pm2 stop minio) 后手动删除 /data/file/hydro 文件夹再重试。
yarn global upgrade-interactive --latest 然后按空格选中除 pm2 之外的所有包更新，回车确认。 然后 pm2 restart hydrooj 重启服务。 重启后 pm2 logs hydrooj --lines 100 没有看到报错并看到了 Server started 则一切正常。
Hydro 的所有历史版本，都可以无损升级到最新版本。如果老系统更新有疑问，随时加官方群咨询群主。
题目列表右侧有相应入口。
切记：不要导入过多你暂时用不上的题目，正确的方式是每次训练、作业，导入所需的5-10个题目，比赛作业结束后让题目成为训练题库的一部分。这样能保证题库中题号靠前的题目难度依次上升，适合后来的同学自行训练。不要贪图题目数量而忽视其质量。自己看不懂解法的题目，少用、慎用。
管理域 -> 管理权限 将 Guest 权限组的 查看此域 权限禁用。
时间是指参与人员做出对应题目“花费”的时间：
即：做出题目的时刻 – 比赛开始的时刻 + 惩罚时间
惩罚时间 = 做对之前错误的提交数 * 20分钟。
普通排名按做对的题目数和“花费”的时间进行排名。
OI排名，按得分排名，题目可以按通过的比例进行记分，每题100分。如果希望数据的分值不平均分配，可以使用 config 配置。
Hydro 的默认位置可以运行 yarn global dir 得到。（不要直接改代码，更新会覆盖此处的所有修改，请使用插件API）
默认的数据库文件放置在 /data/db，但是不要直接复制文件，而是推荐用 hydrooj backup 进行备份。
测试数据等文件存储于 /data/file。
配置文件位于 /root/.config/hydro 和 /root/.hydro。 对于正在运行中的生产服务器，任何操作前请做好离线备份。
备份文件一定要解压查看内部是否包含全部数据，关注备份的大小（大系统备份应该有上百兆），有条件找虚拟机实测还原是否成功
题目限时允许设定的字面精度是 1ms,但是由于操作系统内核参数的限定，实测的精度通常为4ms。 内存限制的精度是1MB，对于本地native的编译型语言c/c++/pascal/freebasic/clang等是考察程序本身的内存申请空间; 对于虚拟机和脚本语言，则包含了虚拟机本身或解释器本身的内存消耗。
如果你是 2022/8/12 日前安装，使用 pip3 install numpy 后 pm2 restart hydro-sandbox
否则参照请参照 编译器 章节。
看 /root/.hydro/config.json 。
用户注册由 Guest 用户（uid 为 0）的 PRIV_REGISTER_USER 权限控制，默认允许注册。 使用 hydrooj cli user setPriv 0 0 即可关闭注册。 若要重新打开，可使用 hydrooj cli user setPriv 0 8。
变更后，请重启 hydrooj 服务：pm2 restart hydrooj
用户名为 Hydro 的用户（uid 为 1）仅用于发送系统消息（与 QQ 中的 10000 类似），无法登录。
使用 hydrooj addon create 创建一个插件，这会自动创建 /root/addon 目录。
进入 /root/addon/public 目录，将您的站点图标放置于该文件夹下。
您需要将以下文件放在该目录中（适配不同浏览器）：
favicon-16x16.pngfavicon-32x32.pngfavicon-96x96.pngfavicon.ico (32x32)android-chrome-192x192.pngapple-touch-icon-180x180.png分辨率应尽可能对应，但不强制要求。以上图片将在浏览器标签页图片上显示。
您还需要将以下文件放在该目录：
nav_logo_dark.png以上图片将在页面左上角 logo 显示。 之后前往系统设置，找到 nav_logo_dark 设置项，改为 /nav_logo_dark.png ，重启 Hydro 即可应用更改。
记得清理浏览器缓存。
Warning
此操作会删除所有用户/题目/比赛等数据。请谨慎操作！
将 此脚本 下载到服务器运行。
您可按需更改，显示顺序与配置中的排列顺序相同。
在系统设置中修改 total_time_limit 为允许的单题最大评测时长即可。
在系统设置中找到 footer_extra_html 项，加上如下内容：（写在一行内，不要多加换行）
基于 https://github.com/hustcc/canvas-nest.js ，MIT
<script>(()=>{function e(e,n,t){return e.getAttribute(n)||t}function n(){l=i.width=window.innerWidth||document.documentElement.clientWidth||document.body.clientWidth,u=i.height=window.innerHeight||document.documentElement.clientHeight||document.body.clientHeight}function c(){var t,o,i,a,m;r.clearRect(0,0,l,u),s.forEach(function(e,n){for(e.x+=e.xa,e.y+=e.ya,e.xa*=e.x>l||e.x<0?-1:1,e.ya*=e.y>u||e.y<0?-1:1,r.fillRect(e.x-.5,e.y-.5,1,1),o=n+1;o<d.length;o++)null!==(t=d[o]).x&&null!==t.y&&(i=e.x-t.x,a=e.y-t.y,(m=i*i+a*a)<t.max&&(t===y&&m>=t.max/2&&(e.x-=.03*i,e.y-=.03*a),m=(t.max-m)/t.max,r.beginPath(),r.lineWidth=m/2,r.strokeStyle="rgba("+x.c+","+(.2+m)+")",r.moveTo(e.x,e.y),r.lineTo(t.x,t.y),r.stroke()))}),w(c)}var l,u,d,t,o,i=document.createElement("canvas"),x=(t=(o=document.getElementsByTagName("script")).length,o=o[t-1],{l:t,z:e(o,"zIndex",-1),o:e(o,"opacity",.5),c:e(o,"color","0,0,0"),n:e(o,"count",99)}),a="c_n"+x.l,r=i.getContext("2d"),w=window.requestAnimationFrame||window.webkitRequestAnimationFrame||window.mozRequestAnimationFrame||window.oRequestAnimationFrame||window.msRequestAnimationFrame||function(e){window.setTimeout(e,1e3/45)},m=Math.random,y={x:null,y:null,max:2e4};i.id=a,i.style.cssText="position:fixed;top:0;left:0;z-index:"+x.z+";opacity:"+x.o,document.getElementsByClassName("main")[0].appendChild(i),n(),window.onresize=n,window.onmousemove=function(e){e=e||window.event,y.x=e.clientX,y.y=e.clientY},window.onmouseout=function(){y.x=null,y.y=null};for(var s=[],h=0;x.n>h;h++){var f=m()*l,g=m()*u,p=2*m()-1,v=2*m()-1;s.push({x:f,y:g,xa:p,ya:v,max:6e3})}d=s.concat([y]),setTimeout(function(){c()},100)})();</script>
+不要钱，我们是 AGPL 的。如果你钱多，可以 给我发个红包。
脚本安装默认只装了一小部分编译器。请参照 编译器 章节安装配置其他编译器。
进入 MongoDB，执行下面的操作即可（根据具体情况替换尖括号中的部分）：
use hydro
+db.user.update({"_id": <用户 UID>}, {$set: {"badge": "<标签内容>#<背景颜色（HEX）>#<文字颜色（HEX）>"}})
+请使用现代浏览器进行操作，并尝试给网站设置 https。 否则请选择逐个下载文件（Ctrl+点击文件名）。
题目 -> 评测设置 -> 允许的语言
域设置 -> 编辑域资料 -> 允许的语言
这两个地方，应该填英文逗号分隔的语言ID，不会填请留空。
如果你搞不明白这个问题，请老实用安装脚本，不要折腾开发模式。
方案一： 通过在内网架设代理服务器，将内网 ip 发送至服务端。（推荐）
方案二： 使用形如 hydrooj cli system set limit.user_login 999 的命令设置新的频率限制（可在错误页面查看具体是触发了哪条限制）
方案三： 使用 pm2 start hydrooj -- --benchmark 启动，关闭所有频率限制（不推荐）
此处列出部分系统通信协议。
当前版本 v1 。
若登录失效，则进行登录操作。
POST /login
+
+{"uname":"USERNAME","password":"PASSWORD","rememberme":true}
+WEBSOCKET /judge/conn
+Authorization: Bearer COOKIE_SID
+连接建立后，评测端向 Web 汇报当前节点状态（可选）
注：下方信息仅作数据格式展示用，不保证真实有效。
{
+ "key": "status",
+ "info": {
+ "mid": "MACHINE_ID",
+ "memory": {
+ "total": 25189552128,
+ "free": 660258800,
+ "used": 24529293328,
+ "active": 1558973164,
+ "available": 23636676608,
+ "buffers": 3075653000,
+ "cached": 1000000000,
+ "slab": 1000000000,
+ "buffcache": 1000000000,
+ "swaptotal": 0,
+ "swapused": 0,
+ "swapfree": 0
+ },
+ "cpu": {
+ "manufacturer": "Intel",
+ "brand": "Xeon® Platinum 8269CY",
+ "vendor": "Intel",
+ "family": "6",
+ "model": "85",
+ "stepping": "7",
+ "speed": 2.5,
+ "cores": 32,
+ "physicalCores": 32,
+ "processors": 2,
+ "flags": "fpu vme de pse tsc ...",
+ "cache": {
+ "l1d": 32768,
+ "l1i": 32768,
+ "l2": 262144,
+ "l3": 6291456
+ }
+ },
+ "load": {
+ "avgLoad": 0.01,
+ "currentLoad": 0.01,
+ "currentLoadUser": 0.01,
+ "currentLoadSystem": 0.01,
+ "currentLoadNice": 0.01,
+ "currentLoadIdle": 0.01,
+ "currentLoadIrq": 0.01
+ },
+ "osinfo": {
+ "platform": "linux",
+ "distro": "Ubuntu",
+ "release": "22.04.2 LTS",
+ "codename": "Jammy Jellyfish",
+ "kernel": "5.15.0-84-generic",
+ "arch": "x64",
+ "hostname": "judge",
+ "codepage": "UTF-8",
+ }
+ }
+}
+建立连接后每隔 30s，评测端发送 {"key":"ping"}。
在连接建立后，Web 端会向 Judge 分发服务端的语言设置。如果客户端需要进行特殊设置，可忽略此条消息。
Web 端会通过 WebSocket 向评测端推送评测任务。
{
+ "task": {
+ "type": "judge",
+ "_id": "RECORD_ID",
+ "lang": "cc.cc11",
+ "uid": SUBMITTER_UID,
+ "code": "USER_SUBMITTED_CODE",
+ "domainId": "SUBMISSION_DOMAIN_ID",
+ "pid": PROBLEM_ID,
+ "contest": "CONTEST_ID (optional)",
+ "input": "INPUT",
+ "source": "SOURCE_ID",
+ "meta": {
+ "rejudge": false,
+ "problemOwner": OWNER_UID
+ },
+ "data": [
+ {
+ "name": "FILE_NAME",
+ "size": SIZE_IN_BYTES,
+ "lastModified": "2023-11-15T08:14:57.535Z",
+ "etag": "ETAG"
+ }
+ ]
+ }
+}
+注1：如果比赛 ID 为 000000000000000000000000 则表示此提交为自测提交，自测提交使用 input 字段值作为程序输入。
注2：source 字段为缓存 ID，同 source 字段的提交使用相同的缓存目录。
注3：source 字段包含且仅包含一个字符 /，建议使用 domainId/pid。
注4：测试数据的 etag 用来识别本地缓存的文件是否与云端一致，可使用 hash 或是修改时间的时间戳。
若推送的评测任务中使用了的测试数据缺失，Judge 端会向 Web 请求缺失或是修改的文件。
POST /d/:domainId/judge/files
+Cookie: sid=COOKIE_SID
+
+{"pid":PROBLEM_ID,"files":["a.in","a.out"]}
+服务端返回如下：
{
+ "links": {
+ "a.in": "https://cdn.hydro.ac/d/DOMAIN_ID/pid/1/a.in",
+ "a.out": "https://cdn.hydro.ac/d/DOMAIN_ID/pid/1/a.out"
+ }
+}
+{
+ "key": "next/end",
+ "domainId": "DOMAIN_ID",
+ "rid": "RECORD_ID",
+
+ "message": "JUDGE_MESSAGE",
+ "compilerText": "COMPILER_OUTPUT",
+ "status": STATUS_CODE,
+ "score": SCORE,
+ "time": TIME_IN_MS,
+ "memory": MEMORY_IN_KB,
+ "progress": PROGRESS_PERCENTAGE,
+ "addProgress": PROGRESS_PERCENTAGE,
+ "case": {
+ "id": ID,
+ "subtaskId": SUBTASK_ID,
+ "score": SCORE,
+ "status": STATUS_CODE,
+ "message": "CHECKER_MESSAGE"
+ }
+}
+除 key, domainId, rid 三个字段外，其他字段均为可选。关于 STATUS_CODE 含义请查看 hydro-dev/Hydro/packages/utils/lib/status 。
当 key 为 end 时表示评测任务已经完成，结果确定，Web 端可进行 AC 数计量，登记成绩表等操作。
此指南将教您修改前端文件。
如果您正在使用开发者模式，请直接修改 packages/ui-default/templates 下的文件。
如果您使用安装脚本部署：
请先使用 hydrooj addon create 创建一个本地插件（如果之前没有做过的话）。
域功能类似团队，允许在一套系统中创建多个环境（如不同班级，或是不同功能，等等）
用户可以创建多个域。（需要用户有 PRIV_CREATE_DOMAIN 权限，默认仅开放给管理员账户）。 域间数据完全独立，仅用户信息相通（注册账户后，在该实例的所有域中均有效）。
登录账号后，在“我的”选项卡中找到“我的域”，并点击“创建域”，填入以下信息：
gravatar:email 或 qq:id 或 github:name 或 url:link 的格式添加。将会在“我的域”界面内显示。创建域后，您将在此域中拥有管理员权限，可以在域内进行添加题目/创建比赛等操作。
您可以在“管理域”选项卡中点击“初始化讨论节点”按钮初始化讨论节点。
未登录用户将默认使用 guest 权限，登录用户将默认使用 default 权限。（所以将登陆用户设为 default 权限后并不会显示在“管理用户”页内，这也表示所有用户默认不会出现在管理列表中）
所以将一个用户的权限设为 default 和将用户移出该域是等价的。
对于不在列表中的用户，点击右上角“添加用户”，在左侧选中用户，右侧选择权限组，再点击“确定”即可。
若您想要创建比赛/作业，您可以在“比赛”或“作业”选项卡中，在页面右侧找到“创建”按钮， 题目一栏支持根据题目ID或是题目名自动筛选。设置完后可点击“创建”按钮创建比赛（描述这类的框不知道写啥就随便填，不能留空）。
Tips
若因为删除作业/比赛内题目导致无法打开，可以通过 /contest/<id>/edit 或 /homework/<id>/edit（即在无法打开的页面页面后加上 /edit）直接访问编辑页并修正。
若您想要创建训练，您可以在“训练” 项卡中点击“新建训练计划”，填写以下信息：
[\n {章节详细信息},\n {章节详细信息},\n ...\n {章节详细信息}\n]\n其中，“章节详细信息”的包含以下部分：
_id：章节数字编号；title：章节标题；requireNids：训练此章节之前需要完成的章节数字编号，若无要求则留空，若有多个则使用逗号分隔；pids：此章节中包含的题目的 ID，若有多个则使用逗号分隔。举例：若要在训练中创建三个章节，章节中分别有 ID 为 1，2，3 的题目。其中章节一、二无前置条件，章节三需要同时完成章节一、二后才能进行，则格式如下：
[\n {\n "_id": 1,\n "title": "入门",\n "requireNids": [],\n "pids": [1]\n },\n {\n "_id": 2,\n "title": "精通",\n "requireNids": [],\n "pids": [2]\n },\n {\n "_id": 3,\n "title": "大师",\n "requireNids": [1,2],\n "pids": [3]\n }\n]\nTips
若因为删除训练计划内题目导致训练计划无法打开，可以通过 /training/<id>/edit（即训练计划页面后加上 /edit）直接访问训练计划编辑页并修正配置文件。
拥有 PERM_CREATE_PROBLEM 的用户均可以新建题目。
请点击题库页面右下角的 创建题目 按钮。
Tips
题目 ID 不能全为数字。若留空则使用自动分配的数字题号。
上传 Hydro 导出的题目压缩包即可。
如果您的压缩包较大无法上传我们也提供cli导入方法：
hydrooj cli problem import <domainId> <file/path> # 将 <file(压缩文件)/path(解压后的文件夹)> 的Hydro格式题目包导入至 <domainId> 域中。\n见插件 import-qduoj。
题面使用 Markdown 语法，并进行了部分扩展。
支持对样例数据分组显示：
```input1\n1 2\n```\n\n```output1\n3\n```后接的数字为测试点编号，将自动合并，并左右分栏显示。
支持从附加文件引用资源。（您可以先创建题目，上传相关文件后再编辑该题目）
[file](file://input.in)@[pdf](file://foo.pdf) （部分情况下若无法使用，请尝试 @[pdf](file://foo.pdf?noDisposition=1) ）@[doc](file://foo.docx) （依赖 onlyoffice 插件）题面支持合并表格：
| 1 | 1 | 3 | 4 | 5 |\n| --- | --- | --- | --- | --- |\n| 1 | 1 | 2 | 2 | 6 |\n| 1 | 1 | 2 | 2 | 7 |\n| 1 | 4 | 3 | 5 | 5 |\n将被渲染为：
支持内嵌 HTML：（用来对付部分 Markdown 搞不定的东西）
<span bgcolor="red">foo</span>\n可点击右侧分类面板快速添加标签，也可以用英文半角逗号分隔多个标签。
您可以在题目右侧“文件”面板上传测试数据和附加文件。（支持拖拽文件至相应位置进行上传）
测试数据格式。
1. 填空题\n\n1+1 = {{ input(1) }}\n\n2. 选择题\n\n{{ select(2) }}\n- 1+1=2\n- 1+1=3\n- 1+1=4\n\n3. 多选题\n\n{{ multiselect(3) }}\n- A\n- B\n- C\n仅需要配置 config.yaml 即可，不需要上传其他文件。
type: objective # 表明该题为客观题\nanswers: # 列举出每一题的正确选项与对应的得分\n '1': ['2', 50] # 填空题/选择题，单答案\n '2': # 填空题/选择题，多答案，不同答案对应不同分数，注意空格缩进\n 'A': 30 # 也可以使用相同分数，即同时存在多个正确答案\n 'B': 10\n '3': [['A', 'B'], 20] # 多选题答案为数组，有部分分\n如您希望改善 Hydro 的访问质量，在您的服务器带宽较小的情况下，您可以考虑使用内容分发网络，即 CDN ，通常情况下您仅需设置资源 CDN 即可大幅度改善访问质量，关于如何使用内容分发网络和使用中的任何问题请联系各大云厂商。
创建并配置好资源 CDN ，在控制面板中将 server.cdn 设置项修改为 CDN 域名。（如 https://cdn.hydro.ac/，以 / 结尾）。
如果您预算充足，可以使用全站 CDN。
Warning
全站 CDN 配置较为繁琐，如您没有相关使用经验请仅建立并配置资源 CDN ，配置资源 CDN 在大部分情况下即可大幅度改善访问质量。 因各服务商全站 CDN 配置方法不同，配置过程不同，需要配置的内容较多，以下仅为参考配置且配置补全，如果有任何问题建议先查阅云服务商文档及咨询云服务商工程师。
缓存设置可以参考以下设置：
| 类型 | 内容 | 缓存行为 |
|---|---|---|
| 全部文件 | 全部文件 | 遵循源站 |
| 文件后缀 | jpg,js,png,css,gif | 缓存一天 |
同时设置添加回源HTTP请求头
| 头部参数 | 头部取值 |
|---|---|
| X-Forward-For | 参考所使用服务商CDN文档来设置用户来源IP |
且您应当修改系统设置中的 server.xff 值为 X-Forwarded-For，该设置是为了能够让系统正确获取到用户的IP地址。
基础列：(domainId, docId, docType), owner, title, content 存储所有文档，包括题目，比赛，训练等等，使用 docType 字段区分文档类型，docType 的定义可参照 packages/hydrooj/src/model/document.ts 。
基础列：(domainId, docId, docType, uid), owner, title, content 存储用户在对应文档下留下的信息，如题目的提交状态，比赛的成绩等等。
基础列：((_id), domainId), uid, code, lang, score, status 存储用户的提交记录。
基础列：(_id), uname, unameLower, mail, mailLower, priv 在系统中的所有用户。
存储系统日志。
用于提交队列等。
用于处理 Hydro 的内部事件通讯，请勿手动操作。
定时任务相关。
用于记录用户的访问情况，作频率限制用
存储临时信息，如登陆状态，注册验证码等
',23)],d={},s=(0,a(3744).Z)(d,[["render",function(e,t){return(0,n.wg)(),(0,n.iD)("div",null,o)}]])},3744:(e,t)=>{t.Z=(e,t)=>{const a=e.__vccOpts||e;for(const[e,n]of t)a[e]=n;return a}}}]); \ No newline at end of file diff --git a/assets/js/v-147825fb.875fdfbc.js b/assets/js/v-147825fb.875fdfbc.js new file mode 100644 index 00000000..bfe5e132 --- /dev/null +++ b/assets/js/v-147825fb.875fdfbc.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkhydro_dev_github_io=self.webpackChunkhydro_dev_github_io||[]).push([[8814],{6872:(t,e,n)=>{n.r(e),n.d(e,{data:()=>a});const a=JSON.parse('{"key":"v-147825fb","path":"/docs/","title":"介绍","lang":"en-US","frontmatter":{"description":"为什么使用 Hydro？ 安全：使用 Linux 容器技术（只读文件系统，命名空间和 cgroup ）进行隔离，杜绝卡评测；; 高效：Hydro 使用了沙箱复用技术，拥有极高的评测效率；; 扩展：Hydro 支持安装额外模块进行扩展；; 强大：配合 Judge 模块（或 HydroJudge 独立评测机），可支持 spj，交互题，提交答案题，文件IO ...","head":[["meta",{"property":"og:url","content":"https://hydro.js.org/docs/"}],["meta",{"property":"og:site_name","content":"Hydro"}],["meta",{"property":"og:title","content":"介绍"}],["meta",{"property":"og:description","content":"为什么使用 Hydro？ 安全：使用 Linux 容器技术（只读文件系统，命名空间和 cgroup ）进行隔离，杜绝卡评测；; 高效：Hydro 使用了沙箱复用技术，拥有极高的评测效率；; 扩展：Hydro 支持安装额外模块进行扩展；; 强大：配合 Judge 模块（或 HydroJudge 独立评测机），可支持 spj，交互题，提交答案题，文件IO ..."}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:image","content":"https://hydro.js.org/"}],["meta",{"property":"og:locale","content":"en-US"}],["meta",{"property":"og:updated_time","content":"2024-04-12T12:11:12.000Z"}],["meta",{"name":"twitter:card","content":"summary_large_image"}],["meta",{"name":"twitter:image:alt","content":"介绍"}],["meta",{"property":"article:modified_time","content":"2024-04-12T12:11:12.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"介绍\\",\\"image\\":[\\"https://hydro.js.org/\\"],\\"dateModified\\":\\"2024-04-12T12:11:12.000Z\\",\\"author\\":[]}"]]},"headers":[{"level":2,"title":"功能对比","slug":"功能对比","link":"#功能对比","children":[]},{"level":2,"title":"截图","slug":"截图","link":"#截图","children":[]},{"level":2,"title":"现在开始","slug":"现在开始","link":"#现在开始","children":[]}],"git":{"createdTime":1611599229000,"updatedTime":1712923872000,"contributors":[{"name":"undefined","email":"i@undefined.moe","commits":14},{"name":"Macesuted","email":"macesuted@qq.com","commits":5},{"name":"(Macesuted)","email":"macesuted@foxmail.com","commits":2},{"name":"Macesuted Kysic","email":"macesuted@foxmail.com","commits":1},{"name":"criyle","email":"gaoyang4425@gmail.com","commits":1},{"name":"panda","email":"panda_dtdyy@outlook.com","commits":1}]},"readingTime":{"minutes":2.52,"words":756},"filePathRelative":"docs/README.md","localizedDate":"January 25, 2021","autoDesc":true,"excerpt":""}')},3865:(t,e,n)=>{n.r(e),n.d(e,{default:()=>x});var a=n(6252);const l=n.p+"assets/img/pict1.648ac21a.png",o=n.p+"assets/img/pict2.da01d875.png",s=n.p+"assets/img/pict3.f80950a4.png",d=n.p+"assets/img/pict4.c80cad4f.png",r=n.p+"assets/img/pict5.5b00151d.png",i=n.p+"assets/img/pict6.241e3a35.png",c=n.p+"assets/img/pict7.13f6d1d4.png",g=n.p+"assets/img/pict8.dc7fa749.png",p=(0,a.uE)('为什么使用 Hydro？
安全：使用 Linux 容器技术（只读文件系统，命名空间和 cgroup ）进行隔离，杜绝卡评测；
高效：Hydro 使用了沙箱复用技术，拥有极高的评测效率；
扩展：Hydro 支持安装额外模块进行扩展；
强大：配合 Judge 模块（或 HydroJudge 独立评测机），可支持 spj，交互题，提交答案题，文件IO 等多种特性；
自定：所有权限节点均可自由设置；
易上手：无需改动源代码，系统设置中预留了大量可自行修改的内容；管理逻辑简洁；
社区：Hydro 正在持续维护中；
如果您正在使用 HustOJ，可以导出题目为 FPS 文件后使用 fps-importer 插件 直接导入 Hydro。
如果您正在使用 QDUOJ， 可以导出题目为 QDUOJ-zip 格式后使用 import-qduoj 插件直接导入 Hydro。
如果您正在使用 Vijos / SYZOJ / HustOJ / UniversalOJ， 可以直接使用 migrate 插件 导入所有数据至 Hydro。
Hydro 支持很多其他系统无法支持的题型，可在 https://hydro.ac/d/system_test/p 中查看并免费下载使用样例。（需要登录）
下方对比了 Hydro 与其他主流 OJ 系统的功能。（只进行在不修改源代码情况下的对比）
+：支持\n=：部分支持\n?: 未知\n-：不支持\n| 功能 | Hydro | HustOJ | SYZOJ[1] | QDUOJ | Vijos |
|---|---|---|---|---|---|
| 安装 | 一键脚本 | 一键脚本 | 手动搭建 | docker | docker |
| 数据库 | MongoDB | MySQL | MariaDB | Postgres | MongoDB |
| 测试数据存储 | 本地/S3 [2] | 本地 | 本地 | 本地 | 数据库 |
| 多评测机 | + | =[3] | =[4] | = | + |
| 测试数据同步 | 按需抓取 | 全量同步 | 全量同步 | 全量同步 | 按需抓取 |
| 比赛 | ACM/OI/IOI/乐多 | ACM/OI | ACM/OI/IOI | ACM/OI/IOI | ACM/OI |
| 封榜 | + | + | - | - | - |
| 作业功能 | + | + | - | - | + |
| 修改编译命令/添加语言 | + | =[5] | - | - | + |
| 权限系统 [6] | + | = | - | - | + |
| 训练计划(题单) | + | + | -[7] | - | + |
| 团队 | + [8] | - | - | - | + |
| Hack | + | - | - | - | - |
| SpecialJudge | + [9] | + | + | - | = |
| Subtask | + | - | + | - | - |
| 交互题 | + | - | + | - | - |
| RemoteJudge | CF/SPOJ/UOJ/POJ/Luogu | HDU/PKU | - | - | - |
| 题目导入 | fps/syzoj/qduoj/hydro | fps/qduoj | syzoj | fps/qduoj | - |
SYZOJ 和 Lyrio （曾用名 syzoj-ng，loj.ac 当前所用系统） 是两套不同的系统，这意味着使用 SYZOJ 无法再导入 loj.ac 的题目，同时 Lyrio 无比赛功能。 ↩︎
S3 指所有兼容 Amazon S3 协议的服务，包括腾讯COS，阿里OSS 等。 ↩︎
安装配置繁琐，且需要手动在服务器间同步数据。 ↩︎
需要手动在服务器间同步数据。 ↩︎
仅能修改部分编译参数，添加语言需要修改源代码。 ↩︎
此处的权限系统指 除用户/管理员二元化权限之外的 的更细粒度的权限划分。 ↩︎
部分二次开发版本有此功能。 ↩︎
通过域功能，允许用户创建域并在域内拥有管理员权限。域之间仅共享账号数据，也可使用域内小组进行权限控制。 ↩︎
支持所有主流 SPJ 格式。 ↩︎
请注意：在阅读本节之前，请确认您已阅读【使用 TypeScript 编写插件】一节并已完成了插件的创建。
import { Context, Time } from 'hydrooj';\n\nexport async function apply(ctx: Context) {\n // handler 表示路由事件\n // after 表示在主逻辑完成后运行，同时支持 before, before-operation, 参照 【插件编写】 章节 【请求流程】\n // RecordDetail 为需要捕获的路由名\n // #get 表示仅捕获 GET 请求，若无此后缀表示捕获该路由的所有请求\n ctx.on('handler/after/RecordDetail#get', (h) => { // handler 系列钩子的一参数为对应的 Handler 实例\n // 不允许查看 24 小时以前的提交记录\n if (h.rdoc._id.getTimestamp() < new Date(Date.now() - Time.day)) {\n h.rdoc.code = '';\n }\n });\n}\nimport { Context } from 'hydrooj';\n\nasync function getAnnounce(domainId: string, limit = 5) {\n // 获取公告...\n return adocs;\n}\n\nexport async function apply(ctx: Context) {\n ctx.withHandlerClass('HomeHandler', (HomeHandler) => {\n // 修改 HomeHandler 中的一个方法（添加公告）\n HomeHandler.prototype.getAnnounce = getAnnounce;\n });\n}\n当前版本 v1 。
若登录失效，则进行登录操作。
POST /login\n\n{"uname":"USERNAME","password":"PASSWORD","rememberme":true}\nWEBSOCKET /judge/conn\nAuthorization: Bearer COOKIE_SID\n连接建立后，评测端向 Web 汇报当前节点状态（可选）
注：下方信息仅作数据格式展示用，不保证真实有效。
{\n "key": "status",\n "info": {\n "mid": "MACHINE_ID",\n "memory": {\n "total": 25189552128,\n "free": 660258800,\n "used": 24529293328,\n "active": 1558973164,\n "available": 23636676608,\n "buffers": 3075653000,\n "cached": 1000000000,\n "slab": 1000000000,\n "buffcache": 1000000000,\n "swaptotal": 0,\n "swapused": 0,\n "swapfree": 0\n },\n "cpu": {\n "manufacturer": "Intel",\n "brand": "Xeon® Platinum 8269CY",\n "vendor": "Intel",\n "family": "6",\n "model": "85",\n "stepping": "7",\n "speed": 2.5,\n "cores": 32,\n "physicalCores": 32,\n "processors": 2,\n "flags": "fpu vme de pse tsc ...",\n "cache": {\n "l1d": 32768,\n "l1i": 32768,\n "l2": 262144,\n "l3": 6291456\n }\n },\n "load": {\n "avgLoad": 0.01,\n "currentLoad": 0.01,\n "currentLoadUser": 0.01,\n "currentLoadSystem": 0.01,\n "currentLoadNice": 0.01,\n "currentLoadIdle": 0.01,\n "currentLoadIrq": 0.01\n },\n "osinfo": {\n "platform": "linux",\n "distro": "Ubuntu",\n "release": "22.04.2 LTS",\n "codename": "Jammy Jellyfish",\n "kernel": "5.15.0-84-generic",\n "arch": "x64",\n "hostname": "judge",\n "codepage": "UTF-8",\n }\n }\n}\n建立连接后每隔 30s，评测端发送 {"key":"ping"}。
在连接建立后，Web 端会向 Judge 分发服务端的语言设置。如果客户端需要进行特殊设置，可忽略此条消息。
Web 端会通过 WebSocket 向评测端推送评测任务。
{\n "task": {\n "type": "judge",\n "_id": "RECORD_ID",\n "lang": "cc.cc11",\n "uid": SUBMITTER_UID,\n "code": "USER_SUBMITTED_CODE",\n "domainId": "SUBMISSION_DOMAIN_ID",\n "pid": PROBLEM_ID,\n "contest": "CONTEST_ID (optional)",\n "input": "INPUT",\n "source": "SOURCE_ID",\n "meta": {\n "rejudge": false,\n "problemOwner": OWNER_UID\n },\n "data": [\n {\n "name": "FILE_NAME",\n "size": SIZE_IN_BYTES,\n "lastModified": "2023-11-15T08:14:57.535Z",\n "etag": "ETAG"\n }\n ]\n }\n}\n注1：如果比赛 ID 为 000000000000000000000000 则表示此提交为自测提交，自测提交使用 input 字段值作为程序输入。
注2：source 字段为缓存 ID，同 source 字段的提交使用相同的缓存目录。
注3：source 字段包含且仅包含一个字符 /，建议使用 domainId/pid。
注4：测试数据的 etag 用来识别本地缓存的文件是否与云端一致，可使用 hash 或是修改时间的时间戳。
若推送的评测任务中使用了的测试数据缺失，Judge 端会向 Web 请求缺失或是修改的文件。
POST /d/:domainId/judge/files\nCookie: sid=COOKIE_SID\n\n{"pid":PROBLEM_ID,"files":["a.in","a.out"]}\n服务端返回如下：
{\n "links": {\n "a.in": "https://cdn.hydro.ac/d/DOMAIN_ID/pid/1/a.in",\n "a.out": "https://cdn.hydro.ac/d/DOMAIN_ID/pid/1/a.out"\n }\n}\n{\n "key": "next/end",\n "domainId": "DOMAIN_ID",\n "rid": "RECORD_ID",\n\n "message": "JUDGE_MESSAGE",\n "compilerText": "COMPILER_OUTPUT",\n "status": STATUS_CODE,\n "score": SCORE,\n "time": TIME_IN_MS,\n "memory": MEMORY_IN_KB,\n "progress": PROGRESS_PERCENTAGE,\n "addProgress": PROGRESS_PERCENTAGE,\n "case": {\n "id": ID,\n "subtaskId": SUBTASK_ID,\n "score": SCORE,\n "status": STATUS_CODE,\n "message": "CHECKER_MESSAGE"\n }\n}\n使用一键安装脚本安装的 Hydro 使用 PM2 对进程进行管理。
可以通过下面的指令查看当前 PM2 正在管理的所有进程。
pm2 ls\n一键安装脚本默认会创建下面几个进程：
hydrooj： Hydro 主进程hydro-sandbox： Hydro 评测沙箱mongodb： MongoDB 数据库caddy： 反向代理后文的指令中将用 <name> 替代此处的进程名称，用 <id> 替代进程 ID（进程 ID 可通过 pm2 ls 查看）。（尖括号同样需要替换）
pm2 ls # 查看进程列表\npm2 start <id> # 启动进程\npm2 stop <id> # 关闭进程\npm2 restart <id> # 重启进程\npm2 del <id> # 删除进程\npm2 log <id/name> --lines=100 # 查看该进程的后 100 行日志\npm2 attach <id> # 与进程交互\npm2 save # 保存对 PM2 进行的修改（在添加、修改、删除进程后需要执行该指令）\n在部分环境（常见于 lxc 容器或是精简版系统）下，服务器重启后 Hydro 可能不能正常自启动，这时请使用 pm2 resurrect 手动载入进程列表。
如果手动修改进程列表且已经覆盖掉保存的原列表，请使用 pm2 stop all && pm2 del all 清空所有进程之后重新运行安装脚本。原有数据不会丢失。
Hydro 主进程同样支持多进程启动，但在中低端服务器（不超过4核）中没有必要使用多进程启动 Hydro，会降低性能且成倍提高内存占用。
pm2 start hydrooj -i <n> # 以 n 进程启动 Hydro 主进程\nHydro 系统会不定期发布更新，可以使用下面的命令获取更新。
无特殊情况请 不要更新PM2 ！此操作可能导致进程列表丢失！
yarn global upgrade-interactive --latest # 在交互式界面中选择想要更新的组件\npm2 restart hydrooj # 更新完后需重启 hydrooj\ncd `yarn global dir` && yarn list --pattern hydrooj\nyarn cache clean && nix-collect-garbage\n在 Hydro 中的大部分变量有固定命名规则：
以及它们的变种：
更多细节可在 packages/hydrooj/src/interface.ts 中找到。
get() 获取内容，返回对应值或 nullgetList() 获取内容，返回 dict 类对象getMulti() 获取数据库查询的指针edit() 更新内容作者: laomai
qq: 29985091
网址: http://82.157.98.222:8888/
日期: 2022/03/16
本文为作者使用hydro时的实验记录，希望对大家有帮助.包括如下内容
零. hydro题目存储格式
一. 制做最简单的oj题
二. 含有自定义头文件的oj题，即函数交互式的题目
三. 半自动对拍的oj题，即不需要录入预期输出的题
四. 完全对拍题，即不需要录入输入数据和输出数据的题
五. 指定输入文件和输出文件
六. 多个子任务
七. 客观题，即制做有标准答案的填空和选择题.
如果想在本地建立好题目，然后批量上传的话. 下面的格式应该对你有帮助
每个题目应自占一个目录，目录名为题目编号比如1 ，2，3，4等等.
每个题目目录下一般有下面的元素：problem_zh.md 这个文件是就是题目的内容，即题目的描述，是一个markdown格式的文档.probelm.yaml 文件.这个是题目的配置信息. 比如标题和标签等。
testdata 子目录，对应网站里的测试数据部分里的文件，
里面至少有一个config.yaml文件 用来说明测试的类型.具体内容见后面的例子
如果题目有测试用例，则每个用例至少要提供一个in文件和一个输出文件(但有些测试类型不用，详情见后)
additional_file子目录用来存放给做题者用的额外文件，比如头文件，图片，pdf文档等，在题目的 markdown 文档中可以用下面的格式为这些文件提供下载链接：[提示文字](file://xxx.txt)
下面为手工录入各种题型的步骤，即在网站登录后点创建题目之后的操作.如下图所示
我们假定题目内容均为下面的markdown文档
# 要求\n\n输入两个整数，输出他们的和\n\n# 样例\n\n```input1\n123 500\n```\n\n```output1\n623\n```\n题目网址: http://82.157.98.222:8888/p/P10000
1.in, 表示用例 1 的输入1.in 的内容为两个整数比如 2 和 3 ，空格分开，如下图所示，然后点确定1.out 文件，内容为 5 ，注意数字编号必须和 in 文件一致，创建之后的文件列表和下面类似.#include <iostream>\nusing namespace std;\nint main(int argc,char* argv[]){\n int a,b;\n cin>>a>>b;\n cout <<(a+b);\n return 0;\n}\n题目网址: http://82.157.98.222:8888/p/P10001
本类型和类型一的区别在于出题者要向做题者提供一个额外的头文件，做题者的主函数里可以包含这个头文件以调用出题者提供的某些函数，或者实现头文件里指定的函数.
tools.h 和 config.yaml ，如下图所示tools.h 的内容为
#include<iostream>\nusing namespace std;\n\nint add(int x,int y); //留待做题者实现\n\nint main(int argc,char* argv[]){\n int a,b;\n cin>>a>>b;\n cout << add(a,b);\n return 0;\n}\n这个头文件里实现了一个主函数，并且声明了需要做题者实现的函数add，当然，出题者应该在题目要求里写明这个函数的原型以及把tools.h文件上传到附加文件列表中，以方便做题者.
题面里可以用如下格式为用户提供下载链接，中括号内的内容可以自己写，[tools.h](file://tools.h) 如下面所示
config.yaml文件的内容为
type: default\nfilename: null\nuser_extra_files:\n - tools.h\n本题的ac代码为
#include "tools.h"\nint add(int x,int y){\n return x+y;\n}\n可见本类型的题目，做题者包含给定的头文件后，可以不需要自己实现主函数，只需要专心实现给定的函数即可.
例题网址:http://82.157.98.222:8888/p/P10002
本题型的特点是不需要手工给出每个用例的预期输出，但是要自己编写一个样本程序,测试时会把用户的输出和样本程序的输出进行对比。
仍以两数求和为例
checker.cc，内容如下:#include "testlib.h"\nint main(int argc, char * argv[]) {\n registerTestlibCmd(argc, argv);\n int a = inf.readInt(); // 读取输入流的第一个整数\n int b = inf.readInt(); // 读取输入流的下一个整数\n int d = a+b;\n int c = ouf.readInt(); // 读取输出流的下一个整数\n if (a+b != c)\n quitf(_wa, "%d + %d expected %d, found %d", a, b,d,c); //输出错误的具体信息,便于做题者调试\n else\n quitf(_ok, "answer of %d + %d is %d",a,b,c);\n}\nchecker_type: testlib\nchecker: checker.cc\ncases:\n - input: 1.in\n output: /dev/null # 无输出\n最终的测试文件列表如下所示:
当程序有错误时,输出的效果如下
可见这里输出了错误细节,便于做题者调试
本题的ac代码和类型一的一样,内容为
#include <iostream>\nusing namespace std;\nint main(int argc,char* argv[]){\n int a,b;\n cin>>a>>b;\n cout <<(a+b);\n return 0;\n}\n如果不希望自己录入输入数据,而是在每次测试时自动动态生成的话,可以将题目类型设为interactive,并提供一个对拍程序.仍以求和为例
例题网址: http://82.157.98.222:8888/p/P10005
最后测试数据部分的文件列表如下图所示
checker.cc,内容为:#include "testlib.h"\n#include <iostream>\nusing namespace std;\n\nint main(int argc, char* argv[]) {\n setName("Interactor A+B");\n registerInteraction(argc, argv);\n //自动生成两个随机整数\n rnd.setSeed(time(NULL));\n int a = rnd.next(1000);\n int b = rnd.next(1000);\n // 本程序的输出将作为用户程序的输入\n cout << a << " " << b << endl;\n int c;\n // 用户程序的最后输出将作为本程序的输入\n cin >> c;\n //对比用户结果和预期结果\n if (a+b != c)\n quitf(_wa, "%d + %d expected %d, found %d", a, b, a+b, c); //输出错误的具体信息,便于做题者调试\n else\n quitf(_ok, "answer of %d + %d is %d",a,b,c);\n}\nconfig.yaml 文件的内容为:type: interactive\ninteractor: checker.cc\ncases:\n- input: /dev/null # no input and no output, dynamic generated\n output: /dev/null\n- input: /dev/null # no input and no output, dynamic generated\n output: /dev/null\nAC 代码和类型一中的相同
例题网址:http://82.157.98.222:8888/p/P10003
有时希望指定输入和输出文件，此时测试文件 1.in 和 1.out 和类型一类似, 但是要提供config.yaml文件，内容类似于下
file: test\n则运行时测试环境会自动把每个输入文件复制到test.in中,输出内容和test.out的内容进行对比. ac的代码如下:
#include <fstream>\nusing namespace std;\nint main(int argc,char* argv[]){\n int a,b;\n ifstream ifs("test.in");\n ifs>>a>>b;\n ofstream ofs("test.out");\n ofs <<(a+b);\n return 0;\n}\n例题网址: https://hydro.ac/d/system_test/p/7
data<id>-<数字> id为子任务编号time: 100ms\nmemory: 8m\nsubtasks:\n - score: 20\n id: 0\n cases:\n - input: data1-1.in\n output: data1-1.ans\n - input: data1-2.in\n output: data1-2.ans\n - input: data1-3.in\n output: data1-3.ans\n - input: data1-4.in\n output: data1-4.ans\n - input: data1-5.in\n output: data1-5.ans\n - score: 20\n id: 1\n cases:\n - input: data2-1.in\n output: data2-1.ans\n - input: data2-2.in\n output: data2-2.ans\n - input: data2-3.in\n output: data2-3.ans\n - input: data2-4.in\n output: data2-4.ans\n - input: data2-5.in\n output: data2-5.ans\n - score: 20\n id: 2\n cases:\n - input: data3-1.in\n output: data3-1.ans\n - input: data3-2.in\n output: data3-2.ans\n - input: data3-3.in\n output: data3-3.ans\n - input: data3-4.in\n output: data3-4.ans\n - input: data3-5.in\n output: data3-5.ans\n - score: 20\n id: 3\n if: [2]\n cases:\n - input: data4-1.in\n output: data4-1.ans\n - input: data4-2.in\n output: data4-2.ans\n - input: data4-3.in\n output: data4-3.ans\n - input: data4-4.in\n output: data4-4.ans\n - input: data4-5.in\n output: data4-5.ans\n - score: 20\n id: 4\n if: [1, 3]\n cases:\n - input: data5-1.in\n output: data5-1.ans\n - input: data5-2.in\n output: data5-2.ans\n - input: data5-3.in\n output: data5-3.ans\n - input: data5-4.in\n output: data5-4.ans\n - input: data5-5.in\n output: data5-5.ans\n可以看出if 用来指定前置子任务.
此外,如果某个子任务没有提供cases部分时,测试时会自动寻找类似于 data<id>-x.in 和data<id>-x.out 的文件,id为子任务编号
上面的例子故意设计为子任务编号和用例文件中的编号不同,所有每个子任务都需要手工指定对应的cases.
注意新版的客观题，格式已经更新。
例题网址:http://82.157.98.222:8888/p/P10004
客观题只需要题面和config.yaml文件. 例子如下:
1. 填空题\n\n1+1 = {{ input(1) }}\n\n2. 选择题\n\n{{ select(2) }}\n- 1+1=2\n- 1+1=3\n- 1+1=4\n\n3. 多选题\n\n{{ multiselect(3) }}\n- A\n- B\n- C\n\n上传的 config.yaml 内容为
type: objective # 表明该题为客观题\nanswers: # 列举出每一题的正确选项与对应的得分\n '1': ['2', 50]\n '2': [['A', 'B'], 30] # 填空题支持多答案，满足其一得分\n '3': [['A', 'B'], 20] # 多选题答案为数组，有部分分\n\n题目运行效果如下：
做完之后点提交,效果如下
可见评分结果正确.
对所有编程题目,题面是必须录入的,如果指定了测试程序时,可以不需要录入输出数据.
如果设置测试方式为interactive,输入数据也不需要手工录入.
想指特殊的测试方式时,一般需要上传一个config.yaml文件,并设置对应字段的值.
对编程题,本文档中用到的字段有
type字段一般为default, 对全自动对拍题,设为interactive
checker_type: testlib checker: checker.cc 用来指定自定义的测试程序,即对拍程序
filename: test用来指定对test.in文件和test.out文件进行读写.
cases:
用来指定测试用例.
更详细的介绍见 https://hydro.js.org/docs/user/testdata/
',87)],D={},C=(0,a(3744).Z)(D,[["render",function(s,n){return(0,l.wg)(),(0,l.iD)("div",null,d)}]])},3744:(s,n)=>{n.Z=(s,n)=>{const a=s.__vccOpts||s;for(const[s,l]of n)a[s]=l;return a}}}]); \ No newline at end of file diff --git a/assets/js/v-2250b6d9.21117f9e.js b/assets/js/v-2250b6d9.21117f9e.js new file mode 100644 index 00000000..b8e00e2e --- /dev/null +++ b/assets/js/v-2250b6d9.21117f9e.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkhydro_dev_github_io=self.webpackChunkhydro_dev_github_io||[]).push([[6331],{6910:(e,t,o)=>{o.r(t),o.d(t,{data:()=>n});const n=JSON.parse('{"key":"v-2250b6d9","path":"/docs/system/database.html","title":"数据库备份和恢复","lang":"en-US","frontmatter":{"description":"进入数据库 非常不推荐直接操作数据库！ 1. 当你改动一个字段的时候，可能与其相关的部分忘记修改，改完觉得好像没什么问题，过段时间发现了一些异常，根本不会想到是你这次改数据库导致的，之后又不会修。 2. 直接修改数据库后，可能没有通知主程序，缓存仍然存在，表现为修改不生效。 3. 直接操作数据库的权限过大，若操作失误带来的影响通常是灾难性的。 在绝大部...","head":[["meta",{"property":"og:url","content":"https://hydro.js.org/docs/system/database.html"}],["meta",{"property":"og:site_name","content":"Hydro"}],["meta",{"property":"og:title","content":"数据库备份和恢复"}],["meta",{"property":"og:description","content":"进入数据库 非常不推荐直接操作数据库！ 1. 当你改动一个字段的时候，可能与其相关的部分忘记修改，改完觉得好像没什么问题，过段时间发现了一些异常，根本不会想到是你这次改数据库导致的，之后又不会修。 2. 直接修改数据库后，可能没有通知主程序，缓存仍然存在，表现为修改不生效。 3. 直接操作数据库的权限过大，若操作失误带来的影响通常是灾难性的。 在绝大部..."}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"en-US"}],["meta",{"property":"og:updated_time","content":"2024-04-03T09:17:20.000Z"}],["meta",{"property":"article:modified_time","content":"2024-04-03T09:17:20.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"数据库备份和恢复\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2024-04-03T09:17:20.000Z\\",\\"author\\":[]}"]]},"headers":[{"level":2,"title":"进入数据库","slug":"进入数据库","link":"#进入数据库","children":[]},{"level":2,"title":"快速备份与恢复","slug":"快速备份与恢复","link":"#快速备份与恢复","children":[]},{"level":2,"title":"手动备份","slug":"手动备份","link":"#手动备份","children":[]},{"level":2,"title":"手动恢复备份","slug":"手动恢复备份","link":"#手动恢复备份","children":[]}],"git":{"createdTime":1628908242000,"updatedTime":1712135840000,"contributors":[{"name":"undefined","email":"i@undefined.moe","commits":4},{"name":"panda","email":"panda_dtdyy@outlook.com","commits":2},{"name":"Macesuted","email":"macesuted@qq.com","commits":1},{"name":"pt3155420267","email":"33685002+pt3155420267@users.noreply.github.com","commits":1}]},"readingTime":{"minutes":1.79,"words":536},"filePathRelative":"docs/system/database.md","localizedDate":"August 14, 2021","autoDesc":true,"excerpt":""}')},7814:(e,t,o)=>{o.r(t),o.d(t,{default:()=>k});var n=o(6252);const a=(0,n.uE)('Warning
非常不推荐直接操作数据库！
在绝大部分情况下均不需要/不可以直接操作数据库。若确需要，可使用 hydrooj db 命令打开数据库 shell，也可以从 ~/.hydro/config.json 查找数据库 connection string 并使用外部工具进行连接。
注：MongoDB 的用户是附加在特定数据库中的，使用外部工具连接请确保使用了正确的 authSource 选项。
为了保证数据安全，请定期备份。
若您使用自动脚本安装，可使用 hydrooj backup 快捷备份数据，备份完成后会在当前目录生成备份压缩包文件，您可使用 hydrooj restore <备份文件路径> 恢复之前备份的数据。
Warning
此文档已过时，仅作留存使用，以下教程仅为实力，请前往 FAQS(常用教程) 查看使用指南。
远程站点对提交数量和访问次数有相关限制，Hydro 不保证 VJudge 的 100% 可用性。
安装插件后创建名为 codeforces 的域，进入数据库 db.domain.updateOne({_id:'codeforces'},{$set:{mount:'codeforces'}});
在 codeforces 的域设置中，将 allowedLangs 如下配置（在新版即在允许提交的语言中选中所有 codeforces 开头的语言）：
codeforces,codeforces.43,codeforces.52,codeforces.50,codeforces.54,codeforces.59,codeforces.61,codeforces.65,codeforces.9,codeforces.28,codeforces.32,codeforces.12,codeforces.60,codeforces.36,codeforces.48,codeforces.19,codeforces.3,codeforces.4,codeforces.51,codeforces.13,codeforces.6,codeforces.7,codeforces.31,codeforces.40,codeforces.41,codeforces.67,codeforces.49,codeforces.20,codeforces.34,codeforces.55\n在 vjudge 表中插入如下条目：
{type:'codeforces', handle:'<codeforces login handle>', password:'<codeforces login password>'}\n将如下配置添加至 langs 设置末尾：
codeforces:\n execute: none\n display: Codeforces\n domain:\n - codeforces # Allow domain 'codeforces' to use these languages\ncodeforces.43:\n highlight: cpp astyle-c\n monaco: cpp\n display: GNU GCC C11 5.1.0\n comment: //\ncodeforces.52:\n highlight: cpp astyle-c\n monaco: cpp\n display: Clang++17 Diagnostics\n comment: //\ncodeforces.50:\n highlight: cpp astyle-c\n monaco: cpp\n display: GNU G++14 6.4.0\n comment: //\ncodeforces.54:\n highlight: cpp astyle-c\n monaco: cpp\n display: GNU G++17 7.3.0\n comment: //\ncodeforces.59:\n highlight: cpp astyle-c\n monaco: cpp\n display: Microsoft Visual C++ 2017\n comment: //\ncodeforces.61:\n highlight: cpp astyle-c\n monaco: cpp\n display: GNU G++17 9.2.0 (64 bit, msys 2)\n comment: //\ncodeforces.65:\n highlight: cpp astyle-cs\n monaco: csharp\n display: C# 8, .NET Core 3.1\n comment: //\ncodeforces.9:\n highlight: cpp astyle-cs\n monaco: csharp\n display: C# Mono 6.8\n comment: //\ncodeforces.28:\n highlight: d\n monaco: plain\n display: D DMD32 v2.091.0\n comment: //\ncodeforces.32:\n highlight: go\n display: Go 1.15.6\n comment: //\ncodeforces.12:\n highlight: haskell\n display: Haskell GHC 8.10.1\n comment: --\ncodeforces.60:\n highlight: java astyle-java\n monaco: java\n display: Java 11.0.6\n comment: //\ncodeforces.36:\n highlight: java astyle-java\n monaco: java\n display: Java 1.8.0_241\n comment: //\ncodeforces.48:\n highlight: kotlin\n display: Kotlin 1.4.0\n comment: //\ncodeforces.19:\n highlight: ocaml\n monaco: plain\n display: OCaml 4.02.1\n comment: ['(*','*)']\ncodeforces.3:\n highlight: pascal\n display: Delphi 7\n comment: //\ncodeforces.4:\n highlight: pascal\n display: Free Pascal 3.0.2\n comment: //\ncodeforces.51:\n highlight: pascal\n display: PascalABC.NET 3.4.2\n comment: //\ncodeforces.13:\n highlight: perl\n display: Perl 5.20.1\n comment: '#'\ncodeforces.6:\n highlight: php\n display: PHP 7.2.13\n comment: //\ncodeforces.7:\n highlight: python\n display: Python 2.7.18\n comment: '#'\ncodeforces.31:\n highlight: python\n display: Python 3.9.1\n comment: '#'\ncodeforces.40:\n highlight: python\n display: PyPy 2.7 (7.3.0)\n comment: '#'\ncodeforces.41:\n highlight: python\n display: PyPy 3.7 (7.3.0)\n comment: '#'\ncodeforces.67:\n highlight: ruby\n display: Ruby 3.0.0\n comment: '#'\ncodeforces.49:\n highlight: rust\n display: Rust 1.49.0\n comment: //\ncodeforces.20:\n highlight: scala\n display: Scala 2.12.8\n comment: //\ncodeforces.34:\n highlight: javascript\n display: JavaScript V8 4.8.0\n comment: //\ncodeforces.55:\n highlight: javascript\n display: Node.js 12.6.3\n comment: //\n之后再重启 Hydro 即可。
',11)],o={},e=(0,a(3744).Z)(o,[["render",function(s,n){return(0,l.wg)(),(0,l.iD)("div",null,p)}]])},3744:(s,n)=>{n.Z=(s,n)=>{const a=s.__vccOpts||s;for(const[s,l]of n)a[s]=l;return a}}}]); \ No newline at end of file diff --git a/assets/js/v-3706649a.ed629ea9.js b/assets/js/v-3706649a.ed629ea9.js new file mode 100644 index 00000000..7d79dde9 --- /dev/null +++ b/assets/js/v-3706649a.ed629ea9.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkhydro_dev_github_io=self.webpackChunkhydro_dev_github_io||[]).push([[88],{8624:(t,e,o)=>{o.r(e),o.d(e,{data:()=>r});const r=JSON.parse('{"key":"v-3706649a","path":"/404.html","title":"","lang":"en-US","frontmatter":{"layout":"NotFound","description":"","head":[["meta",{"property":"og:url","content":"https://hydro.js.org/404.html"}],["meta",{"property":"og:site_name","content":"Hydro"}],["meta",{"property":"og:type","content":"website"}],["meta",{"property":"og:locale","content":"en-US"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"WebPage\\",\\"name\\":\\"\\"}"]]},"headers":[],"git":{},"readingTime":{"minutes":0,"words":0},"filePathRelative":null,"autoDesc":true,"excerpt":""}')},9927:(t,e,o)=>{o.r(e),o.d(e,{default:()=>a});var r=o(6252);const n={},a=(0,o(3744).Z)(n,[["render",function(t,e){return(0,r.wg)(),(0,r.iD)("div")}]])},3744:(t,e)=>{e.Z=(t,e)=>{const o=t.__vccOpts||t;for(const[t,r]of e)o[t]=r;return o}}}]); \ No newline at end of file diff --git a/assets/js/v-4def954c.07c04fc7.js b/assets/js/v-4def954c.07c04fc7.js new file mode 100644 index 00000000..4dfc5143 --- /dev/null +++ b/assets/js/v-4def954c.07c04fc7.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkhydro_dev_github_io=self.webpackChunkhydro_dev_github_io||[]).push([[1672],{6240:(e,s,n)=>{n.r(s),n.d(s,{data:()=>a});const a=JSON.parse('{"key":"v-4def954c","path":"/docs/install/proxy.html","title":"反向代理 / SSL 配置","lang":"en-US","frontmatter":{"description":"2022/10/27 后使用脚本安装的实例已自动配置 Caddy 反向代理，请直接编辑位于 ~/.hydro/Caddyfile 的配置文件！ 若使用反向代理，请注意系统设置中的 server.xff 和 server.xhost 设置项需要填写正确（小写），分别对应反向代理所添加的标头名（通常为 x-forwarded-for 和 x-forward...","head":[["meta",{"property":"og:url","content":"https://hydro.js.org/docs/install/proxy.html"}],["meta",{"property":"og:site_name","content":"Hydro"}],["meta",{"property":"og:title","content":"反向代理 / SSL 配置"}],["meta",{"property":"og:description","content":"2022/10/27 后使用脚本安装的实例已自动配置 Caddy 反向代理，请直接编辑位于 ~/.hydro/Caddyfile 的配置文件！ 若使用反向代理，请注意系统设置中的 server.xff 和 server.xhost 设置项需要填写正确（小写），分别对应反向代理所添加的标头名（通常为 x-forwarded-for 和 x-forward..."}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"en-US"}],["meta",{"property":"og:updated_time","content":"2023-08-23T08:55:42.000Z"}],["meta",{"property":"article:modified_time","content":"2023-08-23T08:55:42.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"反向代理 / SSL 配置\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2023-08-23T08:55:42.000Z\\",\\"author\\":[]}"]]},"headers":[{"level":3,"title":"2022/10/27 后使用脚本安装的实例已自动配置 Caddy 反向代理，请直接编辑位于 ~/.hydro/Caddyfile 的配置文件！","slug":"_2022-10-27-后使用脚本安装的实例已自动配置-caddy-反向代理-请直接编辑位于-hydro-caddyfile-的配置文件","link":"#_2022-10-27-后使用脚本安装的实例已自动配置-caddy-反向代理-请直接编辑位于-hydro-caddyfile-的配置文件","children":[]}],"git":{"createdTime":1629032113000,"updatedTime":1692780942000,"contributors":[{"name":"undefined","email":"i@undefined.moe","commits":6},{"name":"Macesuted","email":"macesuted@qq.com","commits":2},{"name":"panda","email":"panda_dtdyy@outlook.com","commits":1}]},"readingTime":{"minutes":1.2,"words":359},"filePathRelative":"docs/install/proxy.md","localizedDate":"August 15, 2021","autoDesc":true,"excerpt":""}')},5850:(e,s,n)=>{n.r(s),n.d(s,{default:()=>t});var a=n(6252);const d=(0,a.uE)('~/.hydro/Caddyfile 的配置文件！Warning
若使用反向代理，请注意系统设置中的 server.xff 和 server.xhost 设置项需要填写正确（小写），分别对应反向代理所添加的标头名（通常为 x-forwarded-for 和 x-forwarded-host，部分反代工具会使用 x-real-ip 替代 x-forwarded-for）。
server.xhost 设置项配置错误会导致用户无法登录等问题。(CsrfTokenError)
server.xff 设置项配置错误会导致无法记录用户IP。
除一键安装脚本在安装 Caddy 后会自动配置设置项，其他工具请在使用工具前先配置好系统设置！否则将造成用户无法登录、无法记录用户IP等问题。
若您使用 Nginx，请注意配置 WebSocket 协议的反向代理，否则会导致评测状态无法自动刷新，在线 IDE 无法正常使用等问题。
hydro.ac {\n log {\n output file /data/access.log {\n roll_size 1gb\n roll_keep_for 72h\n }\n format json\n }\n root * /root/.hydro/static\n @static {\n file {\n try_files {path}\n }\n }\n handle @static {\n file_server\n }\n handle {\n reverse_proxy http://127.0.0.1:8888\n }\n}\nTips
您可以直接选择文件（支持多选）上传或将文件拖拽至相应位置上传。
若上传文件为 zip 格式，将会自动进行解压操作。
对于一般的题目，您只需提供 .in 和 .out/.ans 文件，以下是一个例子。
请务必确保文件名中含有数字。形如 sample.in 的文件是不会被自动识别的。
喵? tree\n.\n├── a1.in\n├── a1.out\n├── a2.in\n├── a2.out\n├── a3.in\n└── a3.out\n测试数据将被自动识别，并使用 1S 256MB 的限制。
Tips
推荐您通过 评测设置 在线编辑题目配置，可以拥有更好的编辑体验。
上传 config.yaml 文件即可，文件格式如下（下方所有样例均为可选项，若无说明则预填写的内容即为默认值）：
# 题目类型，可以为 default(比对输出，可以含spj), objective(客观题), interactive(交互题)\ntype: default\n\n# 全局时空限制（此处的限制优先级低于测试点的限制）\ntime: 1s\nmemory: 128m\n\n# 输入输出文件名（例：使用 foo.in 和 foo.out），若使用标准 IO 删除此配置项即可\nfilename: foo\n\n# 此部分设置当题目类型为 default 时生效\n# 比较器类型，支持的值有 default（直接比对，忽略行末空格和文件末换行）, ccr, cena, hustoj, lemon, qduoj, syzoj, testlib(比较常用)\nchecker_type: default\n# 比较器文件（当比较器类型不为 default 时填写）\n# 文件路径（位于压缩包中的路径）\n# 将通过扩展名识别语言，与编译命令处一致。在默认配置下，C++ 扩展名应为 .cc 而非 .cpp\nchecker: chk.cc\n\n# 此部分设置当题目类型为interactive时生效\n# 交互器路径（位于压缩包中的路径）\ninteractor: interactor.cc\n\n# Extra files 额外文件\n# These files will be copied to the working directory 这些文件将被复制到工作目录。\n# 提示：您无需手动上传 testlib.h。\nuser_extra_files:\n - extra_input.txt\njudge_extra_files:\n - extra_file.txt\n\n# Test Cases 测试数据列表\n# If neither CASES or SUBTASKS are set(or config.yaml doesn't exist), judge will try to locate them automaticly.\n# 如果 CASES 和 SUBTASKS 都没有设置或 config.yaml 不存在， 系统会自动尝试识别数据点。\n# We support these names for auto mode: 自动识别支持以下命名方式：\n# 1. [name(optional)][number].(in/out/ans) RegExp: /^([a-zA-Z]*)([0-9]+).in$/\n# examples: \n# - c1.in / c1.out\n# - 1.in / 1.out\n# - c1.in / c1.ans\n# 2. input[number].txt / output[number].txt RegExp: /^(input)([0-9]+).txt$/\n# - example: input1.txt / input2.txt\n#\n# The CASES option has higher priority than the SUBTASKS option!\n# 在有 CASES 设置项时，不会读取 SUBTASKS 设置项！\n#\n# The CASES option has been deprecated in the new version, please use the more personalized SUBTASKS!\n# CASES 已于新版本中被废弃，请使用个性化程度更高的SUBTASKS！\n# score: 50 # 单个测试点分数\n# time: 1s # 时间限制\n# memory: 256m # 内存限制\n# cases:\n# - input: abc.in\n# output: def.out\n# - input: ghi.in\n# output: jkl.out\n# 或使用Subtask项：\nsubtasks:\n - score: 30\n type: min # 可选 min/max/sum，分别表示取所有测试点最小值、所有测试点最大值、所有测试点之和\n time: 1s\n memory: 64m\n cases:\n - time: 0.5s\n memory: 32m # 可对单个测试点单独设置时间限制和内存限制\n input: a.in\n output: a.out\n - input: b.in\n output: b.out\n - score: 70\n time: 0.5s\n memory: 32m\n if: [0] # 可选，传入数组，表示仅在subtask0通过时此subtask才计分\n cases:\n - input: c.in\n output: c.out\n - input: d.in\n output: d.out\n\n# 提交语言限制\n# 列举出所有本题允许使用的语言对应的代码（需要和评测机 lang.yaml 内的语言代码相同）\n# 使用语言ID而非名称！对于有子类的选项，请详细至子分类！\nlangs:\n - c\n - cc\n - cc.cc11o2\n - pas\n\n# 时间内存倍率\n# 对某语言设置时间或内存倍率（需要和评测机 lang.yaml 内的语言代码相同）\n# 部分语言默认已存在倍率，请前往控制面板中查看！\n# 使用语言ID而非名称！对于有子类的选项，请详细至子分类！\ntime_limit_rate:\n py.py3: 2\nmemory_limit_rate:\n java: 1.5\n使用 root 用户执行如下命令：
nix-env -iA nixpkgs.sonic-server\n使用 root 用户执行如下命令：
yarn global add @hydrooj/sonic\nhydrooj addon add @hydrooj/sonic\n在 /root/.sonic/config.cfg（没有的自行建立，也可以换成其他的你喜欢的路径）按照以下配置示例写入配置。
配置示例：
# Sonic\n# Fast, lightweight and schema-less search backend\n# Configuration file\n# Example: https://github.com/valeriansaliou/sonic/blob/master/config.cfg\n\n\n[server]\n\nlog_level = "error"\n\n\n[channel]\n\ninet = "127.0.0.1:1491" # 默认监听本机\ntcp_timeout = 300\n\nauth_password = "SecretPassword"\n\n[channel.search]\n\nquery_limit_default = 10\nquery_limit_maximum = 100\nquery_alternates_try = 4\n\nsuggest_limit_default = 5\nsuggest_limit_maximum = 20\n\n\n[store]\n\n[store.kv]\n\npath = "/data/sonic/store/kv/"\n\nretain_word_objects = 1000\n\n[store.kv.pool]\n\ninactive_after = 1800\n\n[store.kv.database]\n\nflush_after = 900\n\ncompress = true\nparallelism = 2\nmax_files = 100\nmax_compactions = 1\nmax_flushes = 1\nwrite_buffer = 16384\nwrite_ahead_log = true\n\n[store.fst]\n\npath = "/data/sonic/store/fst/"\n\n[store.fst.pool]\n\ninactive_after = 300\n\n[store.fst.graph]\n\nconsolidate_after = 180\n\nmax_size = 2048\nmax_words = 250000\n执行如下命令：
pm2 start sonic -- -c /root/.sonic/config.cfg\npm2 save\n进入 HydroOJ 控制面板，配置 sonic 后端地址。
如果您直接复制配置示例，那么按照以下内容配置：
127.0.0.11491SecretPassword修改完成后，重启 HydroOJ。
执行命令 pm2 restart hydrooj。
进入 HydroOJ 控制面板，在脚本管理中找到重建题目索引，点击运行，参数留空即可。
至此，搜索功能应当可以正常使用。
请更新到 HydroOJ 最新版本后，再运行重建题目索引。
',25),r={},t=(0,e(3744).Z)(r,[["render",function(s,n){const e=(0,a.up)("ExternalLinkIcon");return(0,a.wg)(),(0,a.iD)("div",null,[l,i,(0,a._)("h3",d,[(0,a._)("a",p,[(0,a._)("span",null,[(0,a.Uk)("安装 "),(0,a._)("a",o,[(0,a.Uk)("sonic-server"),(0,a.Wm)(e)])])])]),c])}]])},3744:(s,n)=>{n.Z=(s,n)=>{const e=s.__vccOpts||s;for(const[s,a]of n)e[s]=a;return e}}}]); \ No newline at end of file diff --git a/assets/js/v-55131a51.ec71e52c.js b/assets/js/v-55131a51.ec71e52c.js new file mode 100644 index 00000000..9b4b03ad --- /dev/null +++ b/assets/js/v-55131a51.ec71e52c.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkhydro_dev_github_io=self.webpackChunkhydro_dev_github_io||[]).push([[9236],{7185:(s,n,a)=>{a.r(n),a.d(n,{data:()=>l});const l=JSON.parse('{"key":"v-55131a51","path":"/dev/third-party-auth.html","title":"接入第三方账号系统","lang":"en-US","frontmatter":{"description":"Hydro 支持接入第三方的账号系统，并且有以下内置模块可用： @hydrooj/login-with-github; @hydrooj/login-with-google; 对接其他平台 在阅读本节之前，请确保你已阅读 【插件开发】 章节。 以 Github 登录为例：","head":[["meta",{"property":"og:url","content":"https://hydro.js.org/dev/third-party-auth.html"}],["meta",{"property":"og:site_name","content":"Hydro"}],["meta",{"property":"og:title","content":"接入第三方账号系统"}],["meta",{"property":"og:description","content":"Hydro 支持接入第三方的账号系统，并且有以下内置模块可用： @hydrooj/login-with-github; @hydrooj/login-with-google; 对接其他平台 在阅读本节之前，请确保你已阅读 【插件开发】 章节。 以 Github 登录为例："}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"en-US"}],["meta",{"property":"og:updated_time","content":"2023-12-26T15:12:47.000Z"}],["meta",{"property":"article:modified_time","content":"2023-12-26T15:12:47.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"接入第三方账号系统\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2023-12-26T15:12:47.000Z\\",\\"author\\":[]}"]]},"headers":[{"level":2,"title":"对接其他平台","slug":"对接其他平台","link":"#对接其他平台","children":[]}],"git":{"createdTime":1703603464000,"updatedTime":1703603567000,"contributors":[{"name":"undefined","email":"i@undefined.moe","commits":2}]},"readingTime":{"minutes":1.76,"words":528},"filePathRelative":"dev/third-party-auth.md","localizedDate":"December 26, 2023","autoDesc":true,"excerpt":""}')},4945:(s,n,a)=>{a.r(n),a.d(n,{default:()=>e});var l=a(6252);const p=[(0,l.uE)('Hydro 支持接入第三方的账号系统，并且有以下内置模块可用：
在阅读本节之前，请确保你已阅读 【插件开发】 章节。
以 Github 登录为例：
import {\n Context, ForbiddenError, Handler, superagent, SystemModel,\n TokenModel, UserFacingError, ValidationError,\n} from 'hydrooj';\n\ndeclare module 'hydrooj' {\n interface SystemKeys {\n 'login-with-github.id': string;\n 'login-with-github.secret': string;\n 'login-with-github.endpoint': string;\n }\n}\n\n// 当用户点击 【使用 XX 登录】 按钮时，此函数会被执行\nasync function get(this: Handler) {\n // 从系统设置中获取基础设置，并储存状态信息（完成登录逻辑后应该跳转到哪一页）\n const [appid, [state]] = await Promise.all([\n SystemModel.get('login-with-github.id'),\n TokenModel.add(TokenModel.TYPE_OAUTH, 600, { redirect: this.request.referer }),\n ]);\n // 将用户重定向至第三方平台请求授权。\n this.response.redirect = `https://github.com/login/oauth/authorize?client_id=${appid}&state=${state}&scope=read:user,user:email`;\n}\n\n// 当用户在三方系统中完成授权，需要重定向到 /oauth/xxx/callback，这时所有返回的参数作为 callback 的一参数传入。\nasync function callback({ state, code }) {\n // 获取系统设置和之前的状态。\n const [[appid, secret, endpoint, url], s] = await Promise.all([\n SystemModel.getMany([\n 'login-with-github.id',\n 'login-with-github.secret',\n 'login-with-github.endpoint',\n 'server.url',\n ]),\n TokenModel.get(state, TokenModel.TYPE_OAUTH),\n ]);\n if (!s) throw new ValidationError('token');\n // 使用从 url 中返回的 token 请求第三方的 API，获取用户信息，作为函数返回。\n // 在 OAuth 协议中，需要使用 state 和 code 换取 access_token 再调用 API，这在不同系统中可能设计不同。\n // 系统会根据返回的用户信息自动查找已有用户或是创建新用户。\n const res = await superagent.post(`${endpoint || 'https://github.com'}/login/oauth/access_token`)\n .send({\n client_id: appid,\n client_secret: secret,\n code,\n redirect_uri: `${url}oauth/github/callback`,\n state,\n })\n .set('accept', 'application/json');\n if (res.body.error) {\n throw new UserFacingError(\n res.body.error, res.body.error_description, res.body.error_uri,\n );\n }\n const t = res.body.access_token;\n const userInfo = await superagent.get(`${endpoint ? `${endpoint}/api` : 'https://api.github.com'}/user`)\n .set('User-Agent', 'Hydro-OAuth')\n .set('Accept', 'application/vnd.github.v3+json')\n .set('Authorization', `token ${t}`);\n const ret = {\n _id: `${userInfo.body.id}@github.local`,\n email: userInfo.body.email,\n bio: userInfo.body.bio,\n // 提供多个用户名，若需创建用户则从前往后尝试，直到用户名可用\n uname: [userInfo.body.name, userInfo.body.login].filter((i) => i),\n avatar: `github:${userInfo.body.login}`,\n };\n await TokenModel.del(s._id, TokenModel.TYPE_OAUTH);\n if (!ret.email) throw new ForbiddenError("You don't have a verified email.");\n return ret;\n}\n\n// 注册此模块。\nexport function apply(ctx: Context) {\n ctx.provideModule('oauth', 'github', {\n text: 'Login with Github',\n callback,\n get,\n });\n ctx.i18n.load('zh', {\n 'Login With Github': '使用 Github 登录',\n });\n}\n前置条件：NodeJS>=18
此教程将以编写剪贴板插件为例进行说明。
使用 hydrooj addon create 快速在 /root/addon 下初始化一个插件或是在一个空文件夹中运行 yarn init 并按照提示填写相关信息。
# 使用 yarn init 的样例\n/workspace/hydro-plugin $ yarn init\nyarn init v1.22.4\nquestion name (hydro-plugin): @hydrooj/pastebin\nquestion version (1.0.0): 0.0.1\nquestion description: HydroOJ的剪贴板组件\nquestion entry point (index.js): index.ts\nquestion repository url: https://github.com/hydro-dev/pastebin.git\nquestion author: undefined <i@undefined.moe>\nquestion license (MIT): MIT\nquestion private:\nsuccess Saved package.json\n有时我们希望使用本机的 IDE 编写插件上传到服务器（我们也推荐这么做，编辑器提供的代码补全可以很大程度简化开发流程），可以进行如下操作：
yarn init 创建一个项目。yarn add hydrooj -D 安装相关开发组件。hydrooj addon add 插件绝对路径 启用上传的插件。分析：剪贴板组件需要以下功能：
在路由中定义所有的函数应均为异步函数，支持的函数有：prepare, get, post, post[Operation], cleanup
具体流程如下：
先执行 prepare(args) （如果存在）\nargs 为传入的参数集合（包括 QueryString, Body, Path）中的全部参数，\n再执行 prepare(args) （如果存在）\n检查请求类型：\n\n为 GET ？\n -> 执行 get(args)\n为 POST ?\n -> 执行 post(args)\n -> 含有 operation 字段？\n -> 执行 post[Operation]\n\n执行 cleanup()\n如果在 this.response.template 指定模板则渲染，否则直接返回 this.response.body 中的内容。
如 <input type="hidden" name="operation" value="confirm_delete"> 对应 postConfirmDelete 函数。
应当提供 apply 函数，并与定义的 Handler 一同挂载到 global.Hydro.handler[模块名] 位置。 apply 函数将在初始化阶段被调用。
// @noErrors\n// @module: esnext\n// @filename: index.ts\nimport {\n db, definePlugin, Handler, NotFoundError, param, PermissionError, PRIV, Types,\n} from 'hydrooj';\n\nconst coll = db.collection('paste');\n\ninterface Paste {\n _id: string;\n owner: number;\n content: string;\n isPrivate: boolean;\n}\n\ndeclare module 'hydrooj' {\n interface Model {\n pastebin: typeof pastebinModel;\n }\n interface Collections {\n paste: Paste; // 声明数据表类型\n }\n}\n\nasync function add(userId: number, content: string, isPrivate: boolean): Promise<string> {\n const pasteId = String.random(16); // Hydro 提供了此方法，创建一个长度为16的随机字符串\n // 使用 mongodb 为数据库驱动，相关操作参照其文档\n const result = await coll.insertOne({\n _id: pasteId,\n owner: userId,\n content,\n isPrivate,\n });\n return result.insertedId; // 返回插入的文档ID\n}\n\nasync function get(pasteId: string): Promise<Paste> {\n return await coll.findOne({ _id: pasteId });\n}\n\n// 暴露这些接口，使得 cli 也能够正常调用这些函数；\nconst pastebinModel = { add, get };\nglobal.Hydro.model.pastebin = pastebinModel;\n\n// 创建新路由\nclass PasteCreateHandler extends Handler {\n // Get请求时触发该函数\n async get() {\n // 检查用户是否登录，此处为多余（因为底部注册路由时已声明所需权限）\n // 此方法适用于权限的动态检查\n // this.checkPriv(PRIV.PRIV_USER_PROFILE);\n this.response.template = 'paste_create.html'; // 返回此页面\n }\n\n // 使用 Types.Content 检查输入\n @param('content', Types.Content)\n @param('private', Types.Boolean)\n // 从用户提交的表单中取出content和private字段\n // domainId 为固定传入参数\n async post(domainId: string, content: string, isPrivate = false) {\n // 在HTML表单提交的多选框中，选中值为 'on'，未选中则为空，需要进行转换\n const pasteid = await pastebinModel.add(this.user._id, content, !!isPrivate);\n // 将用户重定向到创建完成的url\n this.response.redirect = this.url('paste_show', { id: pasteid });\n // 相应的，提供了 this.back() 方法用于将用户重定向至前一个地址（通常用于 Ajax 或是部分更新操作）\n }\n}\n\nclass PasteShowHandler extends Handler {\n @param('id', Types.String)\n async get(domainId: string, id: string) {\n const doc = await pastebin.get(id);\n if (!doc) throw new NotFoundError(id);\n if (doc.isPrivate && this.user._id !== doc.owner) {\n throw new PermissionError();\n }\n this.response.body = { doc };\n this.response.template = 'paste_show.html';\n }\n\n @param('id', Types.String)\n async postDelete(domainId: string, id: string) {\n // 当提交表单并存在 operation 值为 delete 时执行。\n // 本例中未实现删除功能，仅作为说明。\n }\n}\n\n// Hydro会在服务初始化完成后调用该函数。\nexport async function apply() {\n // 注册一个名为 paste_create 的路由，匹配 '/paste/create'，\n // 使用PasteCreateHandler处理，访问改路由需要PRIV.PRIV_USER_PROFILE权限\n // 提示：路由匹配基于 path-to-regexp\n ctx.Route('paste_create', '/paste/create', PasteCreateHandler, PRIV.PRIV_USER_PROFILE);\n ctx.Route('paste_show', '/paste/show/:id', PasteShowHandler);\n}\n\n模板采用 nunjucks 语法。放置于 templates/ 文件夹下。
会在请求结束时根据 response.template 的值选择模板，并使用 response.body 的值进行渲染，存入 response.body 中。
若 response.template 为空或 request.headers['accept'] == 'application/json'，则跳过渲染步骤。
用于提供多国翻译。格式与 Hydro 的 locale 文件夹格式相同。
',23)],o={},e=(0,a(3744).Z)(o,[["render",function(s,n){return(0,l.wg)(),(0,l.iD)("div",null,p)}]])},3744:(s,n)=>{n.Z=(s,n)=>{const a=s.__vccOpts||s;for(const[s,l]of n)a[s]=l;return a}}}]); \ No newline at end of file diff --git a/assets/js/v-5e09d0a1.410b3766.js b/assets/js/v-5e09d0a1.410b3766.js new file mode 100644 index 00000000..0eb9ba1c --- /dev/null +++ b/assets/js/v-5e09d0a1.410b3766.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkhydro_dev_github_io=self.webpackChunkhydro_dev_github_io||[]).push([[598],{4685:(e,r,t)=>{t.r(r),t.d(r,{data:()=>i});const i=JSON.parse('{"key":"v-5e09d0a1","path":"/docs/user/permission.html","title":"权限系统","lang":"en-US","frontmatter":{"description":"Hydro 的权限系统使用双层结构，分别为 Privilege (PRIV) 和 Permission (PERM)。 权限在系统内部使用位运算表示，具体的定义与数值可以查看 源代码 (https://github.com/hydro-dev/Hydro/blob/master/packages/hydrooj/src/model/builtin.ts...","head":[["meta",{"property":"og:url","content":"https://hydro.js.org/docs/user/permission.html"}],["meta",{"property":"og:site_name","content":"Hydro"}],["meta",{"property":"og:title","content":"权限系统"}],["meta",{"property":"og:description","content":"Hydro 的权限系统使用双层结构，分别为 Privilege (PRIV) 和 Permission (PERM)。 权限在系统内部使用位运算表示，具体的定义与数值可以查看 源代码 (https://github.com/hydro-dev/Hydro/blob/master/packages/hydrooj/src/model/builtin.ts..."}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"en-US"}],["meta",{"property":"og:updated_time","content":"2024-01-05T10:51:30.000Z"}],["meta",{"property":"article:modified_time","content":"2024-01-05T10:51:30.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"权限系统\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2024-01-05T10:51:30.000Z\\",\\"author\\":[]}"]]},"headers":[{"level":2,"title":"Privilege","slug":"privilege","link":"#privilege","children":[]},{"level":2,"title":"Permission","slug":"permission","link":"#permission","children":[]},{"level":2,"title":"角色","slug":"角色","link":"#角色","children":[]},{"level":2,"title":"加入域","slug":"加入域","link":"#加入域","children":[]}],"git":{"createdTime":1704446362000,"updatedTime":1704451890000,"contributors":[{"name":"undefined","email":"i@undefined.moe","commits":2}]},"readingTime":{"minutes":1.67,"words":502},"filePathRelative":"docs/user/permission.md","localizedDate":"January 5, 2024","autoDesc":true,"excerpt":""}')},4323:(e,r,t)=>{t.r(r),t.d(r,{default:()=>d});var i=t(6252);const o=(0,i._)("h1",{id:"权限系统",tabindex:"-1"},[(0,i._)("a",{class:"header-anchor",href:"#权限系统"},[(0,i._)("span",null,"权限系统")])],-1),n=(0,i._)("br",null,null,-1),a={href:"https://github.com/hydro-dev/Hydro/blob/master/packages/hydrooj/src/model/builtin.ts",target:"_blank",rel:"noopener noreferrer"},s=(0,i.uE)('Privilege 是用户在整套系统内拥有的权限，在所有域均生效。如创建用户，编辑系统设置，创建域，查看域等等。
特别地，PRIV.PRIV_USER_PROFILE 控制一个账号是否能够作为普通账号登录。若不具有此权限，该账号将无法登录（被封禁）。
Permission 是用户在单个域内拥有的权限，如创建题目/比赛，发布/删除讨论等等。
如果 PERM.PERM_VIEW 被禁用，则该用户无法查看此域。
通常我们需要给特定的一组用户分配相同的权限。在用户量较多的时候这会非常混乱难以管理，为此我们设计了【角色】，便于批量操作与管理。
角色是针对域内权限（PERM）的。在系统内置了三个角色：
通查情况下，如果需要对域做特殊的权限控制，应当新建一个用户组（例如 member）并将选定用户加入该用户组。
将角色移出域和将用户的角色设置为 default 是等价的。
若有需要，您也可以创建 teacher, admin 等其他角色。
考虑到系统中的用户可能非常多（数万甚至数十万），在用户列表中仅会显示权限不为 default 的用户。
加入域的过程实际上是 用户通过某种方式自助将自己的权限组由 default 变更到另一权限组（如member） 的过程。
因此在入域申请链接的权限组中选择 guest 和 default 是没有意义的。
复制题目可以帮助用户将任何有权提交的题目复制到有权创建题目的域中以在比赛/作业/训练计划中使用这些题目。
Hydro 中题目的难度，根据递交数、通过率以及每个递交的递交时间和评测结果，通过算法计算得出。
您可以在比赛的详细界面内点击“参与比赛”按钮进行参与。 比赛过程中“成绩表”会根据比赛规则显示排名。 在比赛截止之后，您仍然可以订正其中的题目，但“成绩表”将停止更新。
若您想发布一个讨论，请先进入一个讨论节点，之后点击“创建一个讨论”按钮并填写：
之后点击“创建”按钮进行发布。
您可以在作业的详情页面中，点击“认领作业”。
在作业开始之前，您无法查看作业中的题目。
在作业持续时间内，您与他人的做题情况会被实时统计在“成绩表”内。
在作业进入延期阶段后，您仍然可以提交题目，但成绩表内的分数将根据延期扣分规则按百分比折算。
在作业截止之后，您仍然可以订正其中的题目，但“成绩表”将停止更新。
Warning
迁移会删除当前 Hydro 的所有数据（含用户账户信息）并移入 HUSTOJ 的数据。
请注意备份相关文件。
请先完成 Hydro 的部署并完成对文件服务的配置(setting_file)。 在迁移数据之前，请先停止正在运行的 HUSTOJ 服务，仅保留其数据库开启。 请注意 Hydro 所在的数据库不应和源 HUSTOJ 数据库相同。
安装插件后，您应当能够在 控制面板>脚本管理 中找到名为 migrateHustoj 的脚本。 其参数格式如下：
{"host":"localhost","port":3306,"name":"jol","username":"","password":"","domainId":"system","contestType":"","dataDir":"","uploadDir":""}\njolsystemoi 或者 acm，视情况而定/home/judge/src/web/upload/ ，如果此路径与您路径相同，请不要填写此项）当脚本运行完成后，请重启 Hydro 实例，会自动完成之后的升级操作。 迁移后，请使用原 HUSTOJ 的管理员账号登录实例。
SYZOJ 与 HUSTOJ 迁移方法类似，迁移脚本应运行名为 migrateSyzoj 的脚本外，SYZOJ无需 contestType 参数。 其参数格式如下：
{"host":"localhost","port":3306,"name":"syzoj","username":"","password":"","domainId":"system","dataDir":""}\nsyzojsystem由于SYZOJ脚本会将原站所有数据迁移，所以运行耗时较长。 当脚本运行完成后，请重启 Hydro 实例，会自动完成之后的升级操作。 迁移后，请使用原 SYZOJ 的管理员账号登录实例。
UniversalOJ （常称作UOJ社区版）与前两者迁移方法类似，迁移脚本应运行名为 migrateUniversalOJ 的脚本。
由于其升级过程较为麻烦，安装脚本已提供自动升级服务，如您需要可运行安装脚本一键迁移，手动迁移请在开发群中提问。
由于UniversalOJ脚本会将原站所有数据迁移，所以运行耗时较长。 当脚本运行完成后，请重启 Hydro 实例，会自动完成之后的升级操作。 迁移后，请使用原 UniversalOJ 的管理员账号登录实例。
Warning
迁移会删除当前 Hydro 的所有数据（含用户账户信息）并移入 vj4 的数据。
请注意备份相关文件。
请先完成 Hydro 的部署并完成对文件服务的配置(setting_file)。
在迁移数据之前，请先停止正在运行的 vj4 服务，仅保留其数据库开启。
请注意 Hydro 所在的数据库不应和源 vj4 数据库相同。
若您使用 vj4-docker ，可更改 docker-compose.yml 将数据库映射至其他本机端口。
安装插件后，您应当能够在 控制面板>脚本管理 中找到名为 migrateVijos 的脚本。
其参数格式如下：
{"host":"localhost","port":27017,"name":"vj4","username":"","password":""}\nTips
vj4-docker 中数据库名为 vj4，无账号密码。
当脚本运行完成后，请重启 Hydro 实例，会自动完成之后的升级操作。 迁移后，请使用原 vj4 的管理员账号登录实例。
Warning
若您的 vj4 是由 vj2 或 tyvj 升级而来，在迁移完成后请不要卸载该插件，否则可能导致部分用户无法登录。
Hydro 支持使用插件扩展自身所支持的功能。
Warning
插件对站点的所有内容具有完全的访问权限，请不要启用来历不明的插件。
Tips
部分插件（斜体标注）需配合第三方软件使用，如仅安装不配置会导致系统无法正常运行，详情请前往左侧插件详情查看。
Hydro 官方目前提供了以下附加组件：
| ID | 描述 |
|---|---|
| @hydrooj/blog | 博客功能 |
| @hydrooj/fps-importer | 导入 fps 格式的题目 |
| @hydrooj/geoip | 显示用户登录地（需要IP库支持） |
| @hydrooj/hydrojudge | 评测组件 |
| @hydrooj/import-qduoj | 导入 QDUOJ 导出的题库 |
| @hydrooj/login-with-github | 允许用户使用 GitHub 登录 |
| @hydrooj/login-with-google | 允许用户使用 Google 登录 |
| @hydrooj/migrate | 从 vijos4/HustOJ/SYZOJ/UniversalOJ 升级 |
| @hydrooj/recaptcha | 注册时启用 reCAPTCHA 验证码 |
| @hydrooj/ui-default | Hydro 的默认用户界面 |
| @hydrooj/onlyoffice | 显示 doc/docx 格式题目 |
| @hydrooj/sonic | 基于 sonic 的题目搜索增强 |
| @hydrooj/elastic-search | 基于 Elastic 的题目搜索增强 |
| @hydrooj/vjudge | Codeforces/SPOJ/UOJ/POJ/Luogu |
| @hydrooj/prom-client | 导出系统状态至 Prometheus |
大部分插件的配置均可在安装后于 控制面板>系统设置 中找到。
部分插件若安装后没有正确配置可能会影响系统正常使用！
先全局安装所需模块，再向 hydrooj 注册即可。例：安装 @hydrooj/geoip
yarn global add @hydrooj/geoip\nhydrooj addon add @hydrooj/geoip\n或者，如果你正在安装一个其他途径获取的插件（自行创建等），请直接使用文件夹 绝对路径： （文件夹路径即为 包含 package.json 的文件夹）
hydrooj addon add /root/xxx\n请不要将插件与插件嵌套摆放，否则可能会导致一些不可预知的问题。
安装完插件后需要重启 hydrooj 以使插件生效。
hydrooj addon list\nyarn global upgrade-interactive --latest\nyarn global remove @hydrooj/geoip\nhydrooj addon remove @hydrooj/geoip\n以 QQ 邮箱为例。
已知能够完整兼容的服务商有：
如果使用其他服务商且没有发现问题，欢迎向此列表 Pull Request。
',6)],a={},r=(0,i(3744).Z)(a,[["render",function(t,e){return(0,o.wg)(),(0,o.iD)("div",null,l)}]])},3744:(t,e)=>{e.Z=(t,e)=>{const i=t.__vccOpts||t;for(const[t,o]of e)i[t]=o;return i}}}]); \ No newline at end of file diff --git a/assets/js/v-69f3a96a.e1c9e854.js b/assets/js/v-69f3a96a.e1c9e854.js new file mode 100644 index 00000000..5cff5577 --- /dev/null +++ b/assets/js/v-69f3a96a.e1c9e854.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkhydro_dev_github_io=self.webpackChunkhydro_dev_github_io||[]).push([[726],{8689:(e,t,o)=>{o.r(t),o.d(t,{data:()=>d});const d=JSON.parse('{"key":"v-69f3a96a","path":"/docs/system/import-user.html","title":"导入用户","lang":"en-US","frontmatter":{"description":"目前支持 csv 格式（用 , 分隔）或 Excel 格式（用 TAB 分隔） 导入用户数据, 数据既可以用文本编辑器创建，也可以用 Excel 等软件来辅助创建。 每行最少三列，最多五列，分别为: 邮箱，用户名，密码，显示名，用户信息。（显示名和用户信息为可选） 请使用 UTF-8 编码，否则中文可能会乱码。 如果使用 CSV 格式（逗号分隔），则用...","head":[["meta",{"property":"og:url","content":"https://hydro.js.org/docs/system/import-user.html"}],["meta",{"property":"og:site_name","content":"Hydro"}],["meta",{"property":"og:title","content":"导入用户"}],["meta",{"property":"og:description","content":"目前支持 csv 格式（用 , 分隔）或 Excel 格式（用 TAB 分隔） 导入用户数据, 数据既可以用文本编辑器创建，也可以用 Excel 等软件来辅助创建。 每行最少三列，最多五列，分别为: 邮箱，用户名，密码，显示名，用户信息。（显示名和用户信息为可选） 请使用 UTF-8 编码，否则中文可能会乱码。 如果使用 CSV 格式（逗号分隔），则用..."}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"en-US"}],["meta",{"property":"og:updated_time","content":"2022-12-29T09:30:13.000Z"}],["meta",{"property":"article:modified_time","content":"2022-12-29T09:30:13.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"导入用户\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2022-12-29T09:30:13.000Z\\",\\"author\\":[]}"]]},"headers":[],"git":{"createdTime":1628908242000,"updatedTime":1672306213000,"contributors":[{"name":"Macesuted","email":"macesuted@qq.com","commits":2},{"name":"panda","email":"panda_dtdyy@outlook.com","commits":2},{"name":"undefined","email":"i@undefined.moe","commits":2}]},"readingTime":{"minutes":0.84,"words":252},"filePathRelative":"docs/system/import-user.md","localizedDate":"August 14, 2021","autoDesc":true,"excerpt":""}')},197:(e,t,o)=>{o.r(t),o.d(t,{default:()=>a});var d=o(6252);const s=[(0,d.uE)('目前支持 csv 格式（用 , 分隔）或 Excel 格式（用 TAB 分隔） 导入用户数据, 数据既可以用文本编辑器创建，也可以用 Excel 等软件来辅助创建。
每行最少三列，最多五列，分别为: 邮箱，用户名，密码，显示名，用户信息。（显示名和用户信息为可选）
请使用 UTF-8 编码，否则中文可能会乱码。
如果使用 CSV 格式（逗号分隔），则用户信息列不可用。
foo@undefined.moe\tuser1\tpassword1\nbar@undefined.moe\tuser2\tpassword2\ttemp\ntest@undefined.moe\tuser3\tpassword3\ttest\t{"group":"class1","studentId":"123","school":"Hydro School"}\n可以在粘贴后点击预览验证复制入的数据的有效性
这将创建三个用户：
user1 密码为 password1 , 邮箱 foo@undefined.moe；user2 密码为 password2 ，邮箱 bar@undefined.moe，显示名为 temp；user3 密码为 password3，邮箱 test@undefined.moe，显示名为 test，学校为 Hydro School，学号为 123，该用户将会被分配至当前域的 class1 小组内；Warning
用户创建后无法删除，请谨慎操作
Tips
使用一键安装脚本部署的 Hydro 一般已自动完成存储配置。
文件默认存储于本地的 /data/file/hydro 目录下，切换存储后端时需要手动复制或移动原有文件。
请根据你使用的存储端类型阅读对应教程。（同时欢迎使用其他存储类型的用户向我们提供详细的存储教程）
MinIO
Warning
新版本 MinIO 占用较大，如果您为轻量使用，我们不建议使用 MinIO 。旧版本 Hydro 用户大部分可直接切换至 file 模式，由 Hydro 代替读取。
file.type: s3file.endPoint： http://127.0.0.1:9000（即 MinIO 启动时显示的 endPoint）file.accessKey： 参照 MinIO 配置file.secretKey： 参照 MinIO 配置file.bucket： hydro（MinIO 内部存储桶名称）file.region： us-east-1file.pathStyle： truefile.endPointForUser： /fs/file.endPointForJudge： /fs/保存后重启，已有文件请自行复制。
腾讯云COS
进入 控制面板>系统设置>存储桶设置。
file.type: s3file.endPoint： http://cos.<存储桶地域>.myqcloud.com （或是 https）file.accessKey： 您的腾讯云 API 密钥的 SecretIdfile.secretKey： 您的腾讯云 API 密钥的 SecretKeyfile.bucket： <存储桶名称>file.region： Autofile.pathStyle： truefile.endPointForUser： 给用户使用的 EndPoint，若填 /fs/ 则表示由服务器转发file.endPointForJudge： 给 judge 使用的 EndPoint，若填 /fs/ 则表示由服务器转发保存后重启，已有文件请自行复制。
阿里云OSS
// TODO & PRs Welcome
",8),l={},r=(0,t(3744).Z)(l,[["render",function(e,o){const t=(0,i.up)("ExternalLinkIcon");return(0,i.wg)(),(0,i.iD)("div",null,[d,(0,i._)("p",null,[(0,i._)("a",c,[(0,i.Uk)("安装 MinIO"),(0,i.Wm)(t)]),(0,i.Uk)(" 后进入 控制面板>manage_config。")]),n])}]])},3744:(e,o)=>{o.Z=(e,o)=>{const t=e.__vccOpts||e;for(const[e,i]of o)t[e]=i;return t}}}]); \ No newline at end of file diff --git a/assets/js/v-6d3257b0.dcf0a34f.js b/assets/js/v-6d3257b0.dcf0a34f.js new file mode 100644 index 00000000..6e268bb4 --- /dev/null +++ b/assets/js/v-6d3257b0.dcf0a34f.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkhydro_dev_github_io=self.webpackChunkhydro_dev_github_io||[]).push([[578],{1952:(e,t,o)=>{o.r(t),o.d(t,{data:()=>n});const n=JSON.parse('{"key":"v-6d3257b0","path":"/docs/system/FAQ.html","title":"常见问题","lang":"en-US","frontmatter":{"description":"已移动至 此处 (/FAQ/)","head":[["meta",{"property":"og:url","content":"https://hydro.js.org/docs/system/FAQ.html"}],["meta",{"property":"og:site_name","content":"Hydro"}],["meta",{"property":"og:title","content":"常见问题"}],["meta",{"property":"og:description","content":"已移动至 此处 (/FAQ/)"}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"en-US"}],["meta",{"property":"og:updated_time","content":"2022-03-14T10:46:41.000Z"}],["meta",{"property":"article:modified_time","content":"2022-03-14T10:46:41.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"常见问题\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2022-03-14T10:46:41.000Z\\",\\"author\\":[]}"]]},"headers":[],"git":{"createdTime":1622877676000,"updatedTime":1647254801000,"contributors":[{"name":"undefined","email":"i@undefined.moe","commits":7},{"name":"Macesuted","email":"macesuted@qq.com","commits":3},{"name":"(Macesuted)","email":"1912192337@qq.com","commits":2},{"name":"stong12345","email":"93954074@qq.com","commits":1},{"name":"zryoung","email":"riyang@qq.com","commits":1}]},"readingTime":{"minutes":0.04,"words":11},"filePathRelative":"docs/system/FAQ.md","localizedDate":"June 5, 2021","autoDesc":true,"excerpt":""}')},4121:(e,t,o)=>{o.r(t),o.d(t,{default:()=>i});var n=o(6252);const a=(0,n._)("h1",{id:"常见问题",tabindex:"-1"},[(0,n._)("a",{class:"header-anchor",href:"#常见问题"},[(0,n._)("span",null,"常见问题")])],-1),r={},i=(0,o(3744).Z)(r,[["render",function(e,t){const o=(0,n.up)("RouterLink");return(0,n.wg)(),(0,n.iD)("div",null,[a,(0,n._)("p",null,[(0,n.Uk)("已移动至 "),(0,n.Wm)(o,{to:"/FAQ/"},{default:(0,n.w5)((()=>[(0,n.Uk)("此处")])),_:1})])])}]])},3744:(e,t)=>{t.Z=(e,t)=>{const o=e.__vccOpts||e;for(const[e,n]of t)o[e]=n;return o}}}]); \ No newline at end of file diff --git a/assets/js/v-6dd45d9b.f1c847aa.js b/assets/js/v-6dd45d9b.f1c847aa.js new file mode 100644 index 00000000..de284a05 --- /dev/null +++ b/assets/js/v-6dd45d9b.f1c847aa.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkhydro_dev_github_io=self.webpackChunkhydro_dev_github_io||[]).push([[6165],{627:(e,t,p)=>{p.r(t),p.d(t,{data:()=>r});const r=JSON.parse('{"key":"v-6dd45d9b","path":"/plugins/fps-importer.html","title":"fps-importer","lang":"en-US","frontmatter":{"description":"从 fps 文件导入题目 在题库右侧“创建题目”一栏中选择“从 FPS 文件导入”。 在打开的窗口中，您可以上传： fps 格式的 xml 文件; zip 文件，其中包含了一个或多个 fps 格式的 xml 文件; 由于防止解析 fps 文件消耗大量内存，将拒绝导入超过 64MiB 的文件。 xml 文件需要为 UTF8 编码，否则可能出现中文题面乱码...","head":[["meta",{"property":"og:url","content":"https://hydro.js.org/plugins/fps-importer.html"}],["meta",{"property":"og:site_name","content":"Hydro"}],["meta",{"property":"og:title","content":"fps-importer"}],["meta",{"property":"og:description","content":"从 fps 文件导入题目 在题库右侧“创建题目”一栏中选择“从 FPS 文件导入”。 在打开的窗口中，您可以上传： fps 格式的 xml 文件; zip 文件，其中包含了一个或多个 fps 格式的 xml 文件; 由于防止解析 fps 文件消耗大量内存，将拒绝导入超过 64MiB 的文件。 xml 文件需要为 UTF8 编码，否则可能出现中文题面乱码..."}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"en-US"}],["meta",{"property":"og:updated_time","content":"2022-12-09T10:31:58.000Z"}],["meta",{"property":"article:modified_time","content":"2022-12-09T10:31:58.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"fps-importer\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2022-12-09T10:31:58.000Z\\",\\"author\\":[]}"]]},"headers":[{"level":2,"title":"从 fps 文件导入题目","slug":"从-fps-文件导入题目","link":"#从-fps-文件导入题目","children":[]}],"git":{"createdTime":1618895412000,"updatedTime":1670581918000,"contributors":[{"name":"Macesuted","email":"macesuted@qq.com","commits":3},{"name":"undefined","email":"i@undefined.moe","commits":2}]},"readingTime":{"minutes":0.49,"words":146},"filePathRelative":"plugins/fps-importer.md","localizedDate":"April 20, 2021","autoDesc":true,"excerpt":""}')},9669:(e,t,p)=>{p.r(t),p.d(t,{default:()=>o});var r=p(6252);const i=[(0,r.uE)('在题库右侧“创建题目”一栏中选择“从 FPS 文件导入”。
在打开的窗口中，您可以上传：
由于防止解析 fps 文件消耗大量内存，将拒绝导入超过 64MiB 的文件。
xml 文件需要为 UTF8 编码，否则可能出现中文题面乱码；
若您的文件超过大小限制，可考虑先在本地使用 Easy-Fps-Viewer 等工具进行拆分。
系统中的用户只有编辑、禁用功能，没有删除功能，这是为了从根源上防止出现“教学事故”，请不要要求增加相关功能，如果认为自己绝不会误操作，请自行开发相关功能。
现在你所使用的评测系统也仅仅是一个程序，并没有人工智能。因此很多地方需要你来迁就它，如果不这样做，你的答案即使本质上是正确的，由于形式的错误造成系统不能理解，也会导致错误。
系统运行过程如下：
在了解了上面的情况以后，同学们应该理解，如果题目没有要求程序输出“Please Input Two Number”之类的提示信息，那么自行输出这些文字将导致你的程序输出与老师事先告诉系统的输出不能做到“一字不差”，因而将导致系统报答案错误。
如果题目要求每两行输出之间要空一行，结果你没有空，会是格式错误，反之亦然。
也许你会觉得，哦，这系统太烂了，这点东西都不能自动识别；实际上正是这样才能有效训练大家编程的精确性、养成良好的代码习惯。很多程序高手都跟你一样，是从对这个系统吐槽开始学习如何认真仔细的、一丝不苟的进行编程的。
系统为了能用统一的方式运行所有同学的答案，不得不对所有人提交的答案的形式进行限定。
对于学习C、C++语言的同学来说，所有提交给系统的答案必须包含并且只有一个main函数，这个main函数必须返回int类型，并且最好返回0，因为操作系统对非零的返回值认为是运行出错。
编译错误发生时，点击“编译错误”的文字链接可以得到详细解释。
删除 .yarnrc.yml 和 .yarn 后再试。
如果您使用的是 阿里云/腾讯云 等服务商，请确保安全组放行了 80 和 443 端口。
hydrooj backup hydrooj restore backup-xxx.zip
百度学习 crontab 的用法后，可以使用 sudo crontab -e 定制自动备份计划。
关闭 minio (pm2 stop minio) 后手动删除 /data/file/hydro 文件夹再重试。
yarn global upgrade-interactive --latest 然后按空格选中除 pm2 之外的所有包更新，回车确认。 然后 pm2 restart hydrooj 重启服务。 重启后 pm2 logs hydrooj --lines 100 没有看到报错并看到了 Server started 则一切正常。
Hydro 的所有历史版本，都可以无损升级到最新版本。如果老系统更新有疑问，随时加官方群咨询群主。
题目列表右侧有相应入口。
切记：不要导入过多你暂时用不上的题目，正确的方式是每次训练、作业，导入所需的5-10个题目，比赛作业结束后让题目成为训练题库的一部分。这样能保证题库中题号靠前的题目难度依次上升，适合后来的同学自行训练。不要贪图题目数量而忽视其质量。自己看不懂解法的题目，少用、慎用。
管理域 -> 管理权限 将 Guest 权限组的 查看此域 权限禁用。
时间是指参与人员做出对应题目“花费”的时间：
即：做出题目的时刻 – 比赛开始的时刻 + 惩罚时间
惩罚时间 = 做对之前错误的提交数 * 20分钟。
普通排名按做对的题目数和“花费”的时间进行排名。
OI排名，按得分排名，题目可以按通过的比例进行记分，每题100分。如果希望数据的分值不平均分配，可以使用 config 配置。
Hydro 的默认位置可以运行 yarn global dir 得到。（不要直接改代码，更新会覆盖此处的所有修改，请使用插件API）
默认的数据库文件放置在 /data/db，但是不要直接复制文件，而是推荐用 hydrooj backup 进行备份。
测试数据等文件存储于 /data/file。
配置文件位于 /root/.config/hydro 和 /root/.hydro。 对于正在运行中的生产服务器，任何操作前请做好离线备份。
备份文件一定要解压查看内部是否包含全部数据，关注备份的大小（大系统备份应该有上百兆），有条件找虚拟机实测还原是否成功
题目限时允许设定的字面精度是 1ms,但是由于操作系统内核参数的限定，实测的精度通常为4ms。 内存限制的精度是1MB，对于本地native的编译型语言c/c++/pascal/freebasic/clang等是考察程序本身的内存申请空间; 对于虚拟机和脚本语言，则包含了虚拟机本身或解释器本身的内存消耗。
如果你是 2022/8/12 日前安装，使用 pip3 install numpy 后 pm2 restart hydro-sandbox
否则参照请参照 编译器 章节。
看 /root/.hydro/config.json 。
用户注册由 Guest 用户（uid 为 0）的 PRIV_REGISTER_USER 权限控制，默认允许注册。 使用 hydrooj cli user setPriv 0 0 即可关闭注册。 若要重新打开，可使用 hydrooj cli user setPriv 0 8。
变更后，请重启 hydrooj 服务：pm2 restart hydrooj
用户名为 Hydro 的用户（uid 为 1）仅用于发送系统消息（与 QQ 中的 10000 类似），无法登录。
使用 hydrooj addon create 创建一个插件，这会自动创建 /root/addon 目录。
进入 /root/addon/public 目录，将您的站点图标放置于该文件夹下。
您需要将以下文件放在该目录中（适配不同浏览器）：
favicon-16x16.pngfavicon-32x32.pngfavicon-96x96.pngfavicon.ico (32x32)android-chrome-192x192.pngapple-touch-icon-180x180.png分辨率应尽可能对应，但不强制要求。以上图片将在浏览器标签页图片上显示。
您还需要将以下文件放在该目录：
nav_logo_dark.png以上图片将在页面左上角 logo 显示。 之后前往系统设置，找到 nav_logo_dark 设置项，改为 /nav_logo_dark.png ，重启 Hydro 即可应用更改。
记得清理浏览器缓存。
Warning
此操作会删除所有用户/题目/比赛等数据。请谨慎操作！
您可按需更改，显示顺序与配置中的排列顺序相同。
在系统设置中修改 total_time_limit 为允许的单题最大评测时长即可。
在系统设置中找到 footer_extra_html 项，加上如下内容：（写在一行内，不要多加换行）
基于 https://github.com/hustcc/canvas-nest.js ，MIT
<script>(()=>{function e(e,n,t){return e.getAttribute(n)||t}function n(){l=i.width=window.innerWidth||document.documentElement.clientWidth||document.body.clientWidth,u=i.height=window.innerHeight||document.documentElement.clientHeight||document.body.clientHeight}function c(){var t,o,i,a,m;r.clearRect(0,0,l,u),s.forEach(function(e,n){for(e.x+=e.xa,e.y+=e.ya,e.xa*=e.x>l||e.x<0?-1:1,e.ya*=e.y>u||e.y<0?-1:1,r.fillRect(e.x-.5,e.y-.5,1,1),o=n+1;o<d.length;o++)null!==(t=d[o]).x&&null!==t.y&&(i=e.x-t.x,a=e.y-t.y,(m=i*i+a*a)<t.max&&(t===y&&m>=t.max/2&&(e.x-=.03*i,e.y-=.03*a),m=(t.max-m)/t.max,r.beginPath(),r.lineWidth=m/2,r.strokeStyle="rgba("+x.c+","+(.2+m)+")",r.moveTo(e.x,e.y),r.lineTo(t.x,t.y),r.stroke()))}),w(c)}var l,u,d,t,o,i=document.createElement("canvas"),x=(t=(o=document.getElementsByTagName("script")).length,o=o[t-1],{l:t,z:e(o,"zIndex",-1),o:e(o,"opacity",.5),c:e(o,"color","0,0,0"),n:e(o,"count",99)}),a="c_n"+x.l,r=i.getContext("2d"),w=window.requestAnimationFrame||window.webkitRequestAnimationFrame||window.mozRequestAnimationFrame||window.oRequestAnimationFrame||window.msRequestAnimationFrame||function(e){window.setTimeout(e,1e3/45)},m=Math.random,y={x:null,y:null,max:2e4};i.id=a,i.style.cssText="position:fixed;top:0;left:0;z-index:"+x.z+";opacity:"+x.o,document.getElementsByClassName("main")[0].appendChild(i),n(),window.onresize=n,window.onmousemove=function(e){e=e||window.event,y.x=e.clientX,y.y=e.clientY},window.onmouseout=function(){y.x=null,y.y=null};for(var s=[],h=0;x.n>h;h++){var f=m()*l,g=m()*u,p=2*m()-1,v=2*m()-1;s.push({x:f,y:g,xa:p,ya:v,max:6e3})}d=s.concat([y]),setTimeout(function(){c()},100)})();</script>\n脚本安装默认只装了一小部分编译器。请参照 编译器 章节安装配置其他编译器。
进入 MongoDB，执行下面的操作即可（根据具体情况替换尖括号中的部分）：
use hydro\ndb.user.update({"_id": <用户 UID>}, {$set: {"badge": "<标签内容>#<背景颜色（HEX）>#<文字颜色（HEX）>"}})\n请使用现代浏览器进行操作，并尝试给网站设置 https。 否则请选择逐个下载文件（Ctrl+点击文件名）。
题目 -> 评测设置 -> 允许的语言
域设置 -> 编辑域资料 -> 允许的语言
这两个地方，应该填英文逗号分隔的语言ID，不会填请留空。
如果你搞不明白这个问题，请老实用安装脚本，不要折腾开发模式。
方案一： 通过在内网架设代理服务器，将内网 ip 发送至服务端。（推荐）
方案二： 使用形如 hydrooj cli system set limit.user_login 999 的命令设置新的频率限制（可在错误页面查看具体是触发了哪条限制）
方案三： 使用 pm2 start hydrooj -- --benchmark 启动，关闭所有频率限制（不推荐）
Tips
使用开发环境默认您有良好的国际互联网连接。以下报错信息均为网络问题导致，您可以尝试换源/使用代理/切换网络环境。
开发组不会为您解决任何网络问题。
在开发之前，请务必确认您使用了支持 TypeScript 的 IDE 环境，这可以极大降低开发难度。
git clone https://github.com/hydro-dev/Hydro.git /root/Hydro --recursive # 下载至 /root/Hydro 文件夹\ncd /root/Hydro # 进入工作目录\nyarn # 安装依赖包\nyarn build:ui:production # 编译前端\n开发环境部署完成后默认不启用任何插件。
所有官方插件均随源码仓库下载到安装文件夹的 packages 子文件夹下，可以通过下面的命令启用官方插件（以启用 @hydrooj/ui-default 为例）：
yarn hydrooj addon add @hydrooj/ui-default\n对于非官方插件，下载后通过下面的命令启用即可（以启用位置在 /root/addon 下的插件为例）：
yarn hydrooj addon add /root/addon\n支持如下启动参数：
--port=2333 指定启动端口--debug 启用开发模式--watch 启用热重载（实验性）使用 yarn debug --port=2333 --watch 启动 Hydro，并在后台运行 yarn build:ui:dev，可以对前端源码进行实时转译，在反复修改时可节省编译时间。启动完成后，您可以在 8000 端口访问到 Hydro 实例，且前端的任何更改将即时生效。（后端热重载可能存在 bug，部分模块修改后可能仍需重启才能生效）
请注意：此功能仅在启用了 @hydrooj/ui-default 插件的情况下才会生效。
首次启动会要求您填写数据库连接信息。请根据您数据库的安装填写（若无密码则留空）
请按照下文说明创建管理员账户即可正常使用。
需要更新的时候进入对应仓库文件夹执行 git pull，然后重新 yarn && yarn build:ui:production 即可。
Hydro 是一个高效的信息学在线测评系统。特点：易于部署（且提供安装脚本），轻量，功能强大且易于扩展。
',2),l={href:"https://github.com/hydro-dev/Hydro",target:"_blank",rel:"noopener noreferrer"},n=(0,o._)("br",null,null,-1),a=(0,o._)("br",null,null,-1),s=(0,o._)("br",null,null,-1),d=(0,o._)("br",null,null,-1),u={href:"https://github.com/hydro-dev/Hydro/issues",target:"_blank",rel:"noopener noreferrer"},m={href:"https://gitpod.io/#https://github.com/hydro-dev/Hydro",target:"_blank",rel:"noopener noreferrer"},c={href:"https://hydro.ac/",target:"_blank",rel:"noopener noreferrer"},h=(0,o._)("h2",{id:"联系我们",tabindex:"-1"},[(0,o._)("a",{class:"header-anchor",href:"#联系我们"},[(0,o._)("span",null,"联系我们")])],-1),p=(0,o._)("a",{href:"mailto:i@undefined.moe"},"i@undefined.moe",-1),y=(0,o._)("br",null,null,-1),b={href:"https://t.me/undefinedmoe",target:"_blank",rel:"noopener noreferrer"},g=(0,o._)("br",null,null,-1),k=(0,o._)("p",null,[(0,o.Uk)("注1：Hydro 为开源框架，任何人均能够在遵守协议的情况下使用这套框架。"),(0,o._)("br"),(0,o.Uk)(" 版权申诉相关问题请联系对应网站管理者，（通常为其 UID=2 的用户），与开发者无关。")],-1),_={href:"https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/main/README-zh_CN.md",target:"_blank",rel:"noopener noreferrer"},f=(0,o._)("br",null,null,-1),H=(0,o._)("strong",null,"请勿加群",-1),U=(0,o.uE)('本项目中的 examples/ install/ packages/ui-default/ 下的内容仅采用 AGPL-3.0 进行授权。 项目其余部分使用双重许可：
基于 AGPL3 协议第七条，您在使用本项目时，需要遵守以下额外条款：
即：
在您部署 Hydro 时，需要保留底部的 Powered by Hydro 字样，其中的 Hydro 字样需指向 hydro.js.org/本仓库/fork 之一的链接。
若您对源码做出修改/扩展，同样需要以 AGPL-3.0-or-later 开源，您可以以 Powered by Hydro, Modified by xxx 格式在页脚注明。
此限制对以下模块仍然有效：
如果您对以上条目感到不适，建议您停止使用本项目。
排名不分先后，按照链接字典序。
',4),L={href:"https://github.com/",target:"_blank",rel:"noopener noreferrer"},x={href:"https://github.com/criyle",target:"_blank",rel:"noopener noreferrer"},W={href:"https://github.com/vijos/vj4",target:"_blank",rel:"noopener noreferrer"},w={},S=(0,r(3744).Z)(w,[["render",function(e,t){const r=(0,o.up)("ExternalLinkIcon");return(0,o.wg)(),(0,o.iD)("div",null,[i,(0,o._)("p",null,[(0,o._)("a",l,[(0,o.Uk)("Github 仓库"),(0,o.Wm)(r)])]),(0,o._)("p",null,[(0,o.Uk)("欢迎 star 本项目，这是对开发者的鼓励。"),n,(0,o.Uk)(" 项目的开发与维护需要资金，欢迎进行捐助。"),a,(0,o.Uk)(" Hydro 提供收费的功能定制服务，如您需要可与我们联系。"),s,(0,o.Uk)(" 相关文档若说明的不够详细，请提交 Pull Request 或联系开发组说明。"),d,(0,o.Uk)(" Bug 和功能建议请在 "),(0,o._)("a",u,[(0,o.Uk)("Issues"),(0,o.Wm)(r)]),(0,o.Uk)(" 提出。")]),(0,o._)("p",null,[(0,o._)("a",m,[(0,o.Uk)("在 Gitpod 打开已配置完成的测试环境"),(0,o.Wm)(r)])]),(0,o._)("p",null,[(0,o._)("a",c,[(0,o.Uk)("Hydro Online Judge"),(0,o.Wm)(r)])]),h,(0,o._)("p",null,[(0,o.Uk)("Email "),p,y,(0,o.Uk)(" Telegram "),(0,o._)("a",b,[(0,o.Uk)("@undefinedmoe"),(0,o.Wm)(r)]),g,(0,o.Uk)(" Hydro 用户群：1085853538")]),k,(0,o._)("p",null,[(0,o.Uk)("注2：加入用户群请先阅读"),(0,o._)("a",_,[(0,o.Uk)("《提问的智慧》"),(0,o.Wm)(r)]),(0,o.Uk)("。"),f,(0,o.Uk)(" 同时群内可能存在部分令您感到不适或感到冒犯的内容。若对此有顾虑"),H,(0,o.Uk)("。")]),U,(0,o._)("p",null,[(0,o.Uk)("若您需要对这些模块闭源处理，请考虑联系我们以购买许可。"),v,(0,o.Uk)(" 鉴于 Mirai 处的 "),(0,o._)("a",G,[(0,o.Uk)("不和谐事件"),(0,o.Wm)(r)]),(0,o.Uk)(" 对此项目做如下声明：")]),E,(0,o._)("ul",null,[(0,o._)("li",null,[(0,o._)("a",L,[(0,o.Uk)("Github"),(0,o.Wm)(r)]),(0,o.Uk)(" 为 Hydro 提供了代码托管与自动构建。")]),(0,o._)("li",null,[(0,o._)("a",x,[(0,o.Uk)("criyle"),(0,o.Wm)(r)]),(0,o.Uk)(" 提供评测沙箱实现。")]),(0,o._)("li",null,[(0,o._)("a",W,[(0,o.Uk)("Vijos"),(0,o.Wm)(r)]),(0,o.Uk)(" 为 Hydro 提供了UI框架。")])])])}]])},3744:(e,t)=>{t.Z=(e,t)=>{const r=e.__vccOpts||e;for(const[e,o]of t)r[e]=o;return r}}}]); \ No newline at end of file diff --git a/assets/js/v-a08ef0ec.f3aa503a.js b/assets/js/v-a08ef0ec.f3aa503a.js new file mode 100644 index 00000000..cd154302 --- /dev/null +++ b/assets/js/v-a08ef0ec.f3aa503a.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkhydro_dev_github_io=self.webpackChunkhydro_dev_github_io||[]).push([[288],{2560:(s,a,e)=>{e.r(a),e.d(a,{data:()=>n});const n=JSON.parse('{"key":"v-a08ef0ec","path":"/plugins/hydrojudge.html","title":"hydrojudge","lang":"en-US","frontmatter":{"description":"您可以通过一键安装脚本快速安装独立评测机，详情请前往 部署Hydro (/docs/install/#部署) 查看。 准备 在配置评测机之前，请确认您的站点已经可以访问并正常登录/注册。 您应该预先下载您所要支持的语言的编译器，若您在配置完评测机后 升级/重新安装 了编译器，您需要重新启动沙箱。 关于编译器说明，请参照 编译器 (/docs/insta...","head":[["meta",{"property":"og:url","content":"https://hydro.js.org/plugins/hydrojudge.html"}],["meta",{"property":"og:site_name","content":"Hydro"}],["meta",{"property":"og:title","content":"hydrojudge"}],["meta",{"property":"og:description","content":"您可以通过一键安装脚本快速安装独立评测机，详情请前往 部署Hydro (/docs/install/#部署) 查看。 准备 在配置评测机之前，请确认您的站点已经可以访问并正常登录/注册。 您应该预先下载您所要支持的语言的编译器，若您在配置完评测机后 升级/重新安装 了编译器，您需要重新启动沙箱。 关于编译器说明，请参照 编译器 (/docs/insta..."}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"en-US"}],["meta",{"property":"og:updated_time","content":"2024-04-12T12:11:12.000Z"}],["meta",{"property":"article:modified_time","content":"2024-04-12T12:11:12.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"hydrojudge\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2024-04-12T12:11:12.000Z\\",\\"author\\":[]}"]]},"headers":[{"level":2,"title":"准备","slug":"准备","link":"#准备","children":[]},{"level":2,"title":"安装","slug":"安装","link":"#安装","children":[{"level":3,"title":"作为附加组件","slug":"作为附加组件","link":"#作为附加组件","children":[]},{"level":3,"title":"作为独立进程","slug":"作为独立进程","link":"#作为独立进程","children":[]}]},{"level":2,"title":"更新","slug":"更新","link":"#更新","children":[]},{"level":2,"title":"关闭","slug":"关闭","link":"#关闭","children":[{"level":3,"title":"作为附加组件","slug":"作为附加组件-1","link":"#作为附加组件-1","children":[]},{"level":3,"title":"作为独立进程","slug":"作为独立进程-1","link":"#作为独立进程-1","children":[]}]},{"level":2,"title":"卸载","slug":"卸载","link":"#卸载","children":[]},{"level":2,"title":"评测设置","slug":"评测设置","link":"#评测设置","children":[{"level":3,"title":"作为附加组件","slug":"作为附加组件-2","link":"#作为附加组件-2","children":[]},{"level":3,"title":"作为独立进程","slug":"作为独立进程-2","link":"#作为独立进程-2","children":[]}]},{"level":2,"title":"修改编译选项/添加新语言支持","slug":"修改编译选项-添加新语言支持","link":"#修改编译选项-添加新语言支持","children":[]},{"level":2,"title":"测试数据格式","slug":"测试数据格式","link":"#测试数据格式","children":[]},{"level":2,"title":"调整沙箱空间大小","slug":"调整沙箱空间大小","link":"#调整沙箱空间大小","children":[]},{"level":2,"title":"C/C++ 彩色编译错误信息","slug":"c-c-彩色编译错误信息","link":"#c-c-彩色编译错误信息","children":[]},{"level":2,"title":"开大程序运行栈空间","slug":"开大程序运行栈空间","link":"#开大程序运行栈空间","children":[]},{"level":2,"title":"提高测评精度","slug":"提高测评精度","link":"#提高测评精度","children":[]},{"level":2,"title":"内存计量不准确","slug":"内存计量不准确","link":"#内存计量不准确","children":[]}],"git":{"createdTime":1613893902000,"updatedTime":1712923872000,"contributors":[{"name":"Macesuted","email":"macesuted@qq.com","commits":19},{"name":"undefined","email":"i@undefined.moe","commits":11},{"name":"panda","email":"panda_dtdyy@outlook.com","commits":3},{"name":"Macesuted Kysic","email":"57275149+Macesuted@users.noreply.github.com","commits":1},{"name":"criyle","email":"gaoyang4425@gmail.com","commits":1},{"name":"代建杉","email":"wood3s@foxmail.com","commits":1}]},"readingTime":{"minutes":5.22,"words":1565},"filePathRelative":"plugins/hydrojudge.md","localizedDate":"February 21, 2021","autoDesc":true,"excerpt":""}')},8817:(s,a,e)=>{e.r(a),e.d(a,{default:()=>A});var n=e(6252);const l=(0,n._)("h1",{id:"hydrojudge",tabindex:"-1"},[(0,n._)("a",{class:"header-anchor",href:"#hydrojudge"},[(0,n._)("span",null,"hydrojudge")])],-1),o={class:"hint-container tip"},p=(0,n._)("p",{class:"hint-container-title"},"Tips",-1),r=(0,n._)("h2",{id:"准备",tabindex:"-1"},[(0,n._)("a",{class:"header-anchor",href:"#准备"},[(0,n._)("span",null,"准备")])],-1),t=(0,n._)("p",null,"在配置评测机之前，请确认您的站点已经可以访问并正常登录/注册。",-1),d=(0,n._)("p",null,[(0,n.Uk)("您应该预先下载您所要支持的语言的编译器，若您在配置完评测机后 升级/重新安装 了编译器，您需要重新启动沙箱。"),(0,n._)("br"),(0,n.Uk)(" 关于编译器说明，请参照 "),(0,n._)("a",{href:"/docs/install/compiler"},"编译器"),(0,n.Uk)(" 章节。")],-1),c=(0,n._)("br",null,null,-1),i={href:"https://github.com/criyle/go-judge/releases",target:"_blank",rel:"noopener noreferrer"},y=(0,n._)("code",null,"127.0.0.1:5050",-1),u=(0,n._)("strong",null,"以 root 权限",-1),h=(0,n.uE)('Tips
由于用附加组件安装的评测机与 Hydro 必须在同一台服务器上，每一个 Hydro 实例最多只能有一台评测机由附加组件安装。
在安装 Hydro 的机器上运行下面的指令安装 @hydrooj/hydrojudge：
yarn global add @hydrooj/hydrojudge\nhydrooj addon add @hydrooj/hydrojudge\n重启 Hydro 后 hydrojudge 即可正常运行。
Tips
该方法可以帮助您在任意服务器上部署评测机。
然后在运行评测机的服务器上安装 HydroJudge ：
. <(curl https://hydro.ac/setup.sh) --judge\n创建目录 ~/.config/hydro，在该目录下创建文件 judge.yaml，配置文件格式如下：
hosts:\n localhost:\n type: hydro # vj4 用户请在此处填写 vj4\n server_url: http://localhost/ # Hydro 运行的网址\n uname: judge # 评测账号用户名\n password: abc123 # 评测账号密码\n detail: true # 默认为 true\n设置完之后，使用下面的指令即可开始运行（可以使用 pm2 管理）：
hydrojudge\nHydroJudge 会发布不定期更新。您可以使用 yarn global upgrade-interactive --latest 来检测并进行更新。
在 系统设置>hydrojudge 中有一栏 Disable builtin judge，将它勾上，然后重启 Hydro 即可。
根据开启的方法关闭即可。
关闭后运行下面指令即可。
yarn global remove @hydrooj/hydrojudge\nhydrooj addon remove @hydrooj/hydrojudge\n在 系统设置>hydrojudge 修改对应的参数，然后重启 Hydro 和 hydrojudge 即可。
如果有需要修改单题测试点数量上限等设置，可以在 ~/.config/hydro/judge.yaml 的末尾添加下列内容：
testcases_max: 100 # 单题最多测试点数量\ntotal_time_limit: 120 # 单题最大总测试时长\nparallelism: 2 # 单评测机评测进程数量\n# 更多可选配置均可添加在此处，格式与前面的三排类似\nWarning
如果不调整沙箱的空间大小，当您的评测使用文件 IO 且输入输出文件较大时可能会引发错误。
对于 2022/8/12 前安装的用户：
在服务器上运行下面的代码找到 hydro-sandbox 的运行目录：
pm2 info hydro-sandbox | grep "exec cwd"\n对于 2022/8/12 后安装的用户：
编辑 /root/.hydro/mount.yaml，修改 size 即可。
-fdiagnostics-color=always例：
c:\n compile: /usr/bin/gcc -O2 -Wall -std=c99 -o ${name} foo.c -lm -fdiagnostics-color=always\n2022/8/12 后安装的实例默认已开启无限栈空间，无需手动操作
在很多时候系统默认为程序提供的栈空间并不能满足我们的需求，此时我们需要手动为用户程序提供更大的栈空间。
修改 pm2 中 hydro-sandbox 的启动参数为 ulimit -s unlimited && /usr/bin/hydro-sandbox ：
pm2 del hydro-sandbox\npm2 start bash --name hydro-sandbox -- -c "ulimit -s unlimited && hydro-sandbox" \n禁用 CPU 频率缩放与 Intel 睿频加速技术，防止 CPU 频率波动。
禁用内存地址空间随机化，以使得存在内存寻址错误的代码能够得到更多可重复的结果，可以通过在 /etc/sysctl.conf 中添加下面这行并运行 sudo sysctl -p 应用：
kernel.randomize_va_space = 0\n在控制面板上出现内容为 You are using cgroup v2 without kernel 5.19+. This could result in inaccurate memory usage measurements. 警告时，意味着当前系统的内存消耗计量存在误差。
部分 Linux 设备默认使用 cgroup2，而在 5.19 版本前的内核的 cgroup2 中移除了精确计量内存消耗的接口。 若要获得更精确的内存计量，推荐启用 cgroup v1 (您可以通过检查 /sys/fs/cgroup/memory/memory.memsw.usage_in_bytes 是否存在来验证是否当前系统是否启用了 cgroup v1 )：
以 Ubuntu 的默认引导器 GRUB 2 为例，编辑 /etc/default/grub： 在其中
GRUB_CMDLINE_LINUX_DEFAULT="quiet splash"\n后，加入 `cgroup_enable=memory swapaccount=1 systemd.unified_cgroup_hierarchy=0，变为：
GRUB_CMDLINE_LINUX_DEFAULT="quiet splash cgroup_enable=memory swapaccount=1 systemd.unified_cgroup_hierarchy=0"\n运行以下命令更新 GRUB 2 的配置，然后重新启动。
update-grub && reboot\nTips
在使用 cli 之前，请完成数据库配置。
指令中使用 <> 括起来的参数必须给出，用 [] 括起来的参数可以给出，若不给出则按照默认设置。
用户请根据自己的情况替换掉用 <> 或是 [] 包括起来的部分（括号也应替换）
cli 可以帮助用户在控制台下快捷地进行一些操作。
这些命令需要以在终端以 root 用户执行（安装时执行命令的位置）。
下面给出了一些常用的例子。
Tips
很少使用。建议通过 控制面板>导入用户 功能代替
hydrooj cli user create <mail> <username> <password> <uid>\n# 该用户的邮箱、用户名和密码\n\n# 如创建邮箱为 hydro@hydro.local，用户名为 Hydro，密码为 hydrohydro ，UID 为 2 的用户：\n# 请确保 UID 为不小于 2 的正整数且未被占用，邮箱和用户名均不重复。\nhydrooj cli user create hydro@hydro.local Hydro hydrohydro 2\n若一切正常，运行该指令后您会从命令行窗口中看到该用户 uid。
hydrooj cli user setSuperAdmin <uid>\n\n# 如设置 uid 为 2 的用户为管理员：\nhydrooj cli user setSuperAdmin 2\nhydrooj cli user setPriv <uid> <priv>\nhydrooj cli user setPassword <uid> <password>\n\n# 如将 uid 为 1 的用户的密码改为 hydrohydro：\nhydrooj cli user setPassword 1 hydrohydro\n先 创建一个账号。
您需要留意运行此指令返回的数字，表示该用户的 uid，需要填入下面的指令中，然后给予该账号评测权限。
hydrooj cli user setJudge <uid>\n完成后将配置的用户名及密码写入评测机配置文件，评测机即可连接到网页端。
用户封禁：
hydrooj cli user setPriv <uid> 0\nIP/邮箱域名封禁：
# key 格式为 ip::xxx.xxx.xxx.xxx （封禁 IP 访问） 或是 mail::xxx.com （禁止 xxx.com 的邮箱注册）\nhydrooj cli blacklist add <key> [duration] # 将 <key> 拉入黑名单，时长为 [duration] （以月为单位的整数，默认为 12，若 duration=0 则永久封禁）\nhydrooj cli blacklist get <key> # 获取黑名单中有关 <key> 的信息\nhydrooj cli blacklist del <key> # 将 <key> 移出黑名单\n这里并没有列出所有可以运行的指令，因为其中很多功能我们更推荐通过 Web 访问。
hydrooj cli user create <mail> <uname> <password> [uid] [regip] [priv]\n# 创建邮箱为 <mail>，用户名为 <uname>，密码为 <password>，ID 为 [uid]，注册 ip 为 [regip]，权限为 [priv] 的用户\nhydrooj cli user setUname <uid> <unmae> # 将 ID 为 <uid> 的用户的用户名设置为 <uname>\nhydrooj cli user setPriv <uid> <priv> # 将 ID 为 <uid> 的用户的权限设为 <priv>\nhydrooj cli user setPassword <uid> <password> # 将 ID 为 <uid> 的用户的密码设置为 <password>\nhydrooj cli user setEmail <uid> <mail> # 将 ID 为 <uid> 的用户的邮箱设置为 <mail>\nhydrooj cli user setSuperAdmin <uid> # 将 ID 为 <uid> 的用户设为全站管理员\nhydrooj cli problem import <domainId> <file/path> # 将 <file/path> 的Hydro格式题目包导入至 <domainId> 域中\nhydrooj cli problem export <domainId> # 将 <domainId> 域中的所有题目包导出\nhydrooj cli system set <key> <value> # 修改系统设置 <key> 值为 <value>\n为了便于系统间进行数据交换，Hydro 定义了一种基于 zip 的标准格式用于题目传输。压缩包内文件结构如下：
喵? tree\n.\n├── 任意文件名的文件夹\n│ ├── problem.yaml\n│ ├── problem_zh.md\n│ ├── testdata\n│ │ ├── config.yaml\n│ │ ├── a1.in\n│ │ ├── a1.out\n│ │ ├── a2.in\n│ │ ├── a2.out\n│ │ ├── a3.in\n│ │ └── a3.out\n│ └── additional_file\n│ ├── a.png\n│ └── b.pdf\n└── ...\n其中 problem.yaml 内容如下：
title: 题目名\ntag:\n- 标签1\n- 标签2\npid: 题号（字母+数字）\nproblem_*.md 中为 markdown 格式的题面，语言代号支持完整形式（如 zh_CN），也支持短形式（如 zh）。若同时存在多个语言的题面，Hydro 将会自动识别并提供切换功能。
testdata 文件夹中存放所有测试数据文件，命名规则和配置文件格式请参照【测试数据格式】章节。
additional_file 中存储附加文件，通常用于存放图片，PDF 等文件。这些文件可以在题面中使用 file://文件名 的路径访问。
',8)],o={},p=(0,n(3744).Z)(o,[["render",function(s,e){return(0,a.wg)(),(0,a.iD)("div",null,l)}]])},3744:(s,e)=>{e.Z=(s,e)=>{const n=s.__vccOpts||s;for(const[s,a]of e)n[s]=a;return n}}}]); \ No newline at end of file diff --git a/assets/js/v-fa72264c.c4725840.js b/assets/js/v-fa72264c.c4725840.js new file mode 100644 index 00000000..98f8b586 --- /dev/null +++ b/assets/js/v-fa72264c.c4725840.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkhydro_dev_github_io=self.webpackChunkhydro_dev_github_io||[]).push([[8886],{9758:(e,t,r)=>{r.r(t),r.d(t,{data:()=>a});const a=JSON.parse('{"key":"v-fa72264c","path":"/plugins/recaptcha.html","title":"recaptcha","lang":"en-US","frontmatter":{"description":"我们采用 reCAPTCHA v3 来检验注册者是否是人类，在注册过程中没有看见传统验证码属正常现象。 前往 创建 reCAPTCHA 密钥。 reCAPTCHA 类型请选择“reCAPTCHA 第 3 版”。 创建成功后将客户端密钥和服务端密钥分别填入系统设置 recaptcha 栏下的 key 和 secret 中，重启 Hydro 后 reCAP...","head":[["meta",{"property":"og:url","content":"https://hydro.js.org/plugins/recaptcha.html"}],["meta",{"property":"og:site_name","content":"Hydro"}],["meta",{"property":"og:title","content":"recaptcha"}],["meta",{"property":"og:description","content":"我们采用 reCAPTCHA v3 来检验注册者是否是人类，在注册过程中没有看见传统验证码属正常现象。 前往 创建 reCAPTCHA 密钥。 reCAPTCHA 类型请选择“reCAPTCHA 第 3 版”。 创建成功后将客户端密钥和服务端密钥分别填入系统设置 recaptcha 栏下的 key 和 secret 中，重启 Hydro 后 reCAP..."}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"en-US"}],["meta",{"property":"og:updated_time","content":"2021-04-20T05:10:12.000Z"}],["meta",{"property":"article:modified_time","content":"2021-04-20T05:10:12.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"recaptcha\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2021-04-20T05:10:12.000Z\\",\\"author\\":[]}"]]},"headers":[],"git":{"createdTime":1618895412000,"updatedTime":1618895412000,"contributors":[{"name":"Macesuted","email":"57275149+Macesuted@users.noreply.github.com","commits":1}]},"readingTime":{"minutes":0.34,"words":102},"filePathRelative":"plugins/recaptcha.md","localizedDate":"April 20, 2021","autoDesc":true,"excerpt":""}')},6843:(e,t,r)=>{r.r(t),r.d(t,{default:()=>s});var a=r(6252);const c=(0,a._)("h1",{id:"recaptcha",tabindex:"-1"},[(0,a._)("a",{class:"header-anchor",href:"#recaptcha"},[(0,a._)("span",null,"recaptcha")])],-1),o=(0,a._)("div",{class:"hint-container tip"},[(0,a._)("p",{class:"hint-container-title"},"Tips"),(0,a._)("p",null,"我们采用 reCAPTCHA v3 来检验注册者是否是人类，在注册过程中没有看见传统验证码属正常现象。")],-1),n={href:"https://www.google.com/recaptcha/admin/create",target:"_blank",rel:"noopener noreferrer"},p=(0,a._)("br",null,null,-1),i=(0,a._)("p",null,[(0,a.Uk)("创建成功后将客户端密钥和服务端密钥分别填入系统设置 recaptcha 栏下的 "),(0,a._)("code",null,"key"),(0,a.Uk)(" 和 "),(0,a._)("code",null,"secret"),(0,a.Uk)(" 中，重启 Hydro 后 reCAPTCHA 即可正常工作。")],-1),l={},s=(0,r(3744).Z)(l,[["render",function(e,t){const r=(0,a.up)("ExternalLinkIcon");return(0,a.wg)(),(0,a.iD)("div",null,[c,o,(0,a._)("p",null,[(0,a.Uk)("前往 "),(0,a._)("a",n,[(0,a.Uk)("https://www.google.com/recaptcha/admin/create"),(0,a.Wm)(r)]),(0,a.Uk)(" 创建 reCAPTCHA 密钥。"),p,(0,a.Uk)(" reCAPTCHA 类型请选择“reCAPTCHA 第 3 版”。")]),i])}]])},3744:(e,t)=>{t.Z=(e,t)=>{const r=e.__vccOpts||e;for(const[e,a]of t)r[e]=a;return r}}}]); \ No newline at end of file diff --git a/assets/js/v-fdd5d9ea.dcd6ea9f.js b/assets/js/v-fdd5d9ea.dcd6ea9f.js new file mode 100644 index 00000000..7fcaed77 --- /dev/null +++ b/assets/js/v-fdd5d9ea.dcd6ea9f.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunkhydro_dev_github_io=self.webpackChunkhydro_dev_github_io||[]).push([[2689],{2405:(s,n,a)=>{a.r(n),a.d(n,{data:()=>l});const l=JSON.parse('{"key":"v-fdd5d9ea","path":"/docs/install/compiler.html","title":"编译器","lang":"en-US","frontmatter":{"description":"从 2022/8/12 开始，Hydro 为了避免宿主机环境变化对于评测的影响，对于 此后新安装的实例 默认使用 nix () 管理环境。 如果你是在这之前安装的 Hydro，请使用 apt 安装编译器后使用 pm2 restart hydro-sandbox 重启沙箱，并忽略本章节。 以下是 nix 的简要操作说明： 使用 nix-env -iA n...","head":[["meta",{"property":"og:url","content":"https://hydro.js.org/docs/install/compiler.html"}],["meta",{"property":"og:site_name","content":"Hydro"}],["meta",{"property":"og:title","content":"编译器"}],["meta",{"property":"og:description","content":"从 2022/8/12 开始，Hydro 为了避免宿主机环境变化对于评测的影响，对于 此后新安装的实例 默认使用 nix () 管理环境。 如果你是在这之前安装的 Hydro，请使用 apt 安装编译器后使用 pm2 restart hydro-sandbox 重启沙箱，并忽略本章节。 以下是 nix 的简要操作说明： 使用 nix-env -iA n..."}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"en-US"}],["meta",{"property":"og:updated_time","content":"2023-02-26T07:44:01.000Z"}],["meta",{"property":"article:modified_time","content":"2023-02-26T07:44:01.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"编译器\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2023-02-26T07:44:01.000Z\\",\\"author\\":[]}"]]},"headers":[{"level":2,"title":"进阶","slug":"进阶","link":"#进阶","children":[]}],"git":{"createdTime":1660293799000,"updatedTime":1677397441000,"contributors":[{"name":"undefined","email":"i@undefined.moe","commits":3}]},"readingTime":{"minutes":1.98,"words":593},"filePathRelative":"docs/install/compiler.md","localizedDate":"August 12, 2022","autoDesc":true,"excerpt":""}')},3186:(s,n,a)=>{a.r(n),a.d(n,{default:()=>E});var l=a(6252);const p=(0,l.uE)('从 2022/8/12 开始，Hydro 为了避免宿主机环境变化对于评测的影响，对于 此后新安装的实例 默认使用 nix 管理环境。
如果你是在这之前安装的 Hydro，请使用 apt 安装编译器后使用 pm2 restart hydro-sandbox 重启沙箱，并忽略本章节。
以下是 nix 的简要操作说明：
使用 nix-env -iA nixpkgs.编译器名 安装新编译器，后重启沙箱 pm2 restart hydro-sandbox 生效。
nix-env -iA nixpkgs.busybox nixpkgs.bash nixpkgs.diffutils nixpkgs.unzip # 基础组件，已预装，不建议删除\nnix-env -iA nixpkgs.gcc nixpkgs.fpc # C/C++ 和 Pascal，已预装，不建议删除\nnix-env -iA nixpkgs.ghc # Haskell \nnix-env -iA nixpkgs.rustc # Rust\nnix-env -iA nixpkgs.python2 # Python2\nnix-env -iA nixpkgs.pythonPackages.numpy # Python2 Numpy 库\nnix-env -iA nixpkgs.python3Minimal\nnix-env -iA nixpkgs.python3Packages.numpy\nnix-env -iA nixpkgs.php # PHP\nnix-env -iA nixpkgs.go # Golang\nnix-env -iA nixpkgs.nodejs # NodeJS\nnix-env -iA nixpkgs.openjdk_headless # Java\nnix-env -iA nixpkgs.ruby # Ruby\nnix-env -iA nixpkgs.mono # C#\nnix-env -iA nixpkgs.julia_17-bin # Julia\n使用 nix-env -q 查看已安装的列表，后使用 nix-env -e 编译器名 即可删除对应的编译器。
请注意不要误删 Hydro 基础组件，且操作完成后需要重启沙箱 pm2 restart hydro-sandbox 生效。
如果你需要更加复杂的编译环境配置，我们建议使用编写单独的 nix 文件。
{ \n system ? builtins.currentSystem,\n pkgs ? import <nixpkgs> { system = system; }\n}:\n\npkgs.buildEnv {\n name = "hydrojudge-rootfs";\n paths = with pkgs; [\n coreutils bash diffutils nix zip unzip gcc\n # 上方包是评测所需要的，请勿删除，\n # 在下方列出你所需要的包，查找方式同上文：\n fpc python3 rustc\n ];\n ignoreCollisions = true;\n pathsToLink = [ "/" ];\n # 导出一些基本信息和部分编译器所需的 /etc/passwd\n postBuild = ''\n mkdir $out/buildInfo\n echo 'root:x:0:0:root:/root:/bin/bash' >$out/etc/passwd\n date >$out/buildInfo/timestamp\n '';\n}\n复制以上文件，保存为 default.nix ，使用 nix-build 进行构建。
构建后会产生一个 result 文件夹，记住该文件夹所在的路径。
打开 ~/.hydro/mount.yaml 将其中 /root/.nix-profile 替换为编译出的 result 文件夹（切换到新的环境）
之后保存并重启沙箱。
后续若需更改环境配置，仅需要修改 default.nix 文件之后 nix-build 重新构建，再重启沙箱即可生效。
构建过程中的缓存文件可以使用 nix-collect-garbage 进行清理。
Tips
兼容大部分 Linux 发行版，推荐使用 Debian 12 / Debian 11 / Ubuntu 22.04 （教程多，成功率高，上手简单），不支持 CentOS 及其各种变种：
如果你的机器内存较小（<=2GiB），请避免使用 Ubuntu 22.04，它会消耗较多的内存。建议使用 Debian 12 / Debian 11。
如果你有 Linux 运维经验，Hydro 同样支持在 Alpine Linux 上运行，Alpine Linux 系统启动后仅占用 ~100M 内存，是在低配置服务器上运行的更优方案。
Warning
虚拟机用户请注意：
Docker 用户请注意：
USER 环境变量为 root。--privileged 参数启动容器，否则评测机无法运行。Tips
Hydro 需要使用以下端口： 80, 443, 2019, 8888, 5050, 27017，请确保这些端口空闲。
安装和安装后的所有操作均需要在 root 权限下进行！（sudo su）。
宝塔面板已知出现多次高危漏洞，为防止数据丢失，请不要在生产环境中使用！
运行下面的脚本，等待几分钟即可（建议复制防止敲错）：
LANG=zh . <(curl https://hydro.ac/setup.sh)\nTips
如果有特殊需求，安装脚本支持一些可选的高级选项，以此方式调用： . <(curl https://hydro.ac/setup.sh) --foo --bar
阿里云/腾讯云/华为云等等用户安装后如果不能访问 请百度搜索 xx云 放行80端口
脚本默认使用的为清华大学镜像。
安装完成后，从 http://服务器ip/ 访问网页端，注册一个账号，之后在终端中使用
hydrooj cli user setSuperAdmin 2\n将首个注册用户设置为超级管理员。之后刷新页面，您应当能在上方导航栏看到控制面板入口。
进入控制面板，右侧系统设置，验证管理员密码后按需修改配置，注意 Server BaseURL 一项需要填写访问网站用的完整的 URL，以 / 结尾。（重要，务必正确填写，样例：https://hydro.ac/）
系统安装后需要题库，可前往 https://hydro.ac/d/tk/p 免费专区进行下载，支持批量导入。 至此，基础功能安装已全部完成，另，如果你的服务部署在内网，且希望外网的用户可以访问，可以百度搜索 “端口映射” 相关教程。
',11),c={},d=(0,t(3744).Z)(c,[["render",function(e,n){const t=(0,s.up)("RouterLink"),c=(0,s.up)("ExternalLinkIcon");return(0,s.wg)(),(0,s.iD)("div",null,[a,(0,s._)("p",null,[(0,s.Uk)("这里提供了几套方案帮助您建立自己的站点，请选择适合您的方案并继续。"),l,(0,s.Uk)(" 搭建过程中如果遇到问题欢迎 "),(0,s.Wm)(t,{to:"/#%E8%81%94%E7%B3%BB%E6%88%91%E4%BB%AC"},{default:(0,s.w5)((()=>[(0,s.Uk)("联系我们")])),_:1}),(0,s.Uk)(" 提问。")]),o,i,(0,s._)("p",null,[(0,s.Uk)("CentOS 8 "),(0,s._)("a",r,[(0,s.Uk)("已于 2021-12-31 停止支持"),(0,s.Wm)(c)]),(0,s.Uk)("，后续不会为安全漏洞发布补丁，建议重装为其他操作系统。")]),p])}]])},3744:(e,n)=>{n.Z=(e,n)=>{const t=e.__vccOpts||e;for(const[e,s]of n)t[e]=s;return t}}}]); \ No newline at end of file diff --git a/dev/PERM_PRIV.html b/dev/PERM_PRIV.html new file mode 100644 index 00000000..c5a3e5de --- /dev/null +++ b/dev/PERM_PRIV.html @@ -0,0 +1,40 @@ + + + + + + + + + +基础列：(domainId, docId, docType), owner, title, content 存储所有文档，包括题目，比赛，训练等等，使用 docType 字段区分文档类型，docType 的定义可参照 packages/hydrooj/src/model/document.ts 。
基础列：(domainId, docId, docType, uid), owner, title, content 存储用户在对应文档下留下的信息，如题目的提交状态，比赛的成绩等等。
基础列：((_id), domainId), uid, code, lang, score, status 存储用户的提交记录。
基础列：(_id), uname, unameLower, mail, mailLower, priv 在系统中的所有用户。
存储系统日志。
用于提交队列等。
用于处理 Hydro 的内部事件通讯，请勿手动操作。
定时任务相关。
用于记录用户的访问情况，作频率限制用
存储临时信息，如登陆状态，注册验证码等
请注意：在阅读本节之前，请确认您已阅读【使用 TypeScript 编写插件】一节并已完成了插件的创建。
import { Context, Time } from 'hydrooj';
+
+export async function apply(ctx: Context) {
+ // handler 表示路由事件
+ // after 表示在主逻辑完成后运行，同时支持 before, before-operation, 参照 【插件编写】 章节 【请求流程】
+ // RecordDetail 为需要捕获的路由名
+ // #get 表示仅捕获 GET 请求，若无此后缀表示捕获该路由的所有请求
+ ctx.on('handler/after/RecordDetail#get', (h) => { // handler 系列钩子的一参数为对应的 Handler 实例
+ // 不允许查看 24 小时以前的提交记录
+ if (h.rdoc._id.getTimestamp() < new Date(Date.now() - Time.day)) {
+ h.rdoc.code = '';
+ }
+ });
+}
+import { Context } from 'hydrooj';
+
+async function getAnnounce(domainId: string, limit = 5) {
+ // 获取公告...
+ return adocs;
+}
+
+export async function apply(ctx: Context) {
+ ctx.withHandlerClass('HomeHandler', (HomeHandler) => {
+ // 修改 HomeHandler 中的一个方法（添加公告）
+ HomeHandler.prototype.getAnnounce = getAnnounce;
+ });
+}
+如果您没有过 TypeScript 项目的开发经验，非常不建议自建开发环境。
使用自动脚本安装也可以基于插件系统完成大部分的定制需求（参照左侧【使用 TypeScript 编写插件】章节）。
您可以使用 Gitpod 快速打开配置完成的开发环境或是按照下方说明进行手动配置。（由于 Gitpod 的限制，hydrojudge 模块无法正常运行，若需要开发 hydrojudge 相关内容请自行部署）
Tips
使用开发环境默认您有良好的国际互联网连接。以下报错信息均为网络问题导致，您可以尝试换源/使用代理/切换网络环境。
开发组不会为您解决任何网络问题。
在开发之前，请务必确认您使用了支持 TypeScript 的 IDE 环境，这可以极大降低开发难度。
. <(curl https://hydro.ac/nix.sh) 快速安装）nix-env -iA nixpkgs.yarn 或 npm install -g yarngit clone https://github.com/hydro-dev/Hydro.git /root/Hydro --recursive # 下载至 /root/Hydro 文件夹
+cd /root/Hydro # 进入工作目录
+yarn # 安装依赖包
+yarn build:ui:production # 编译前端
+开发环境部署完成后默认不启用任何插件。
所有官方插件均随源码仓库下载到安装文件夹的 packages 子文件夹下，可以通过下面的命令启用官方插件（以启用 @hydrooj/ui-default 为例）：
yarn hydrooj addon add @hydrooj/ui-default
+对于非官方插件，下载后通过下面的命令启用即可（以启用位置在 /root/addon 下的插件为例）：
yarn hydrooj addon add /root/addon
+支持如下启动参数：
--port=2333 指定启动端口--debug 启用开发模式--watch 启用热重载（实验性）使用 yarn debug --port=2333 --watch 启动 Hydro，并在后台运行 yarn build:ui:dev，可以对前端源码进行实时转译，在反复修改时可节省编译时间。启动完成后，您可以在 8000 端口访问到 Hydro 实例，且前端的任何更改将即时生效。（后端热重载可能存在 bug，部分模块修改后可能仍需重启才能生效）
请注意：此功能仅在启用了 @hydrooj/ui-default 插件的情况下才会生效。
首次启动会要求您填写数据库连接信息。请根据您数据库的安装填写（若无密码则留空）
请按照下文说明创建管理员账户即可正常使用。
需要更新的时候进入对应仓库文件夹执行 git pull，然后重新 yarn && yarn build:ui:production 即可。
在 Hydro 中的大部分变量有固定命名规则：
以及它们的变种：
更多细节可在 packages/hydrooj/src/interface.ts 中找到。
get() 获取内容，返回对应值或 nullgetList() 获取内容，返回 dict 类对象getMulti() 获取数据库查询的指针edit() 更新内容Hydro 支持接入第三方的账号系统，并且有以下内置模块可用：
在阅读本节之前，请确保你已阅读 【插件开发】 章节。
以 Github 登录为例：
import {
+ Context, ForbiddenError, Handler, superagent, SystemModel,
+ TokenModel, UserFacingError, ValidationError,
+} from 'hydrooj';
+
+declare module 'hydrooj' {
+ interface SystemKeys {
+ 'login-with-github.id': string;
+ 'login-with-github.secret': string;
+ 'login-with-github.endpoint': string;
+ }
+}
+
+// 当用户点击 【使用 XX 登录】 按钮时，此函数会被执行
+async function get(this: Handler) {
+ // 从系统设置中获取基础设置，并储存状态信息（完成登录逻辑后应该跳转到哪一页）
+ const [appid, [state]] = await Promise.all([
+ SystemModel.get('login-with-github.id'),
+ TokenModel.add(TokenModel.TYPE_OAUTH, 600, { redirect: this.request.referer }),
+ ]);
+ // 将用户重定向至第三方平台请求授权。
+ this.response.redirect = `https://github.com/login/oauth/authorize?client_id=${appid}&state=${state}&scope=read:user,user:email`;
+}
+
+// 当用户在三方系统中完成授权，需要重定向到 /oauth/xxx/callback，这时所有返回的参数作为 callback 的一参数传入。
+async function callback({ state, code }) {
+ // 获取系统设置和之前的状态。
+ const [[appid, secret, endpoint, url], s] = await Promise.all([
+ SystemModel.getMany([
+ 'login-with-github.id',
+ 'login-with-github.secret',
+ 'login-with-github.endpoint',
+ 'server.url',
+ ]),
+ TokenModel.get(state, TokenModel.TYPE_OAUTH),
+ ]);
+ if (!s) throw new ValidationError('token');
+ // 使用从 url 中返回的 token 请求第三方的 API，获取用户信息，作为函数返回。
+ // 在 OAuth 协议中，需要使用 state 和 code 换取 access_token 再调用 API，这在不同系统中可能设计不同。
+ // 系统会根据返回的用户信息自动查找已有用户或是创建新用户。
+ const res = await superagent.post(`${endpoint || 'https://github.com'}/login/oauth/access_token`)
+ .send({
+ client_id: appid,
+ client_secret: secret,
+ code,
+ redirect_uri: `${url}oauth/github/callback`,
+ state,
+ })
+ .set('accept', 'application/json');
+ if (res.body.error) {
+ throw new UserFacingError(
+ res.body.error, res.body.error_description, res.body.error_uri,
+ );
+ }
+ const t = res.body.access_token;
+ const userInfo = await superagent.get(`${endpoint ? `${endpoint}/api` : 'https://api.github.com'}/user`)
+ .set('User-Agent', 'Hydro-OAuth')
+ .set('Accept', 'application/vnd.github.v3+json')
+ .set('Authorization', `token ${t}`);
+ const ret = {
+ _id: `${userInfo.body.id}@github.local`,
+ email: userInfo.body.email,
+ bio: userInfo.body.bio,
+ // 提供多个用户名，若需创建用户则从前往后尝试，直到用户名可用
+ uname: [userInfo.body.name, userInfo.body.login].filter((i) => i),
+ avatar: `github:${userInfo.body.login}`,
+ };
+ await TokenModel.del(s._id, TokenModel.TYPE_OAUTH);
+ if (!ret.email) throw new ForbiddenError("You don't have a verified email.");
+ return ret;
+}
+
+// 注册此模块。
+export function apply(ctx: Context) {
+ ctx.provideModule('oauth', 'github', {
+ text: 'Login with Github',
+ callback,
+ get,
+ });
+ ctx.i18n.load('zh', {
+ 'Login With Github': '使用 Github 登录',
+ });
+}
+前置条件：NodeJS>=18
此教程将以编写剪贴板插件为例进行说明。
使用 hydrooj addon create 快速在 /root/addon 下初始化一个插件或是在一个空文件夹中运行 yarn init 并按照提示填写相关信息。
# 使用 yarn init 的样例
+/workspace/hydro-plugin $ yarn init
+yarn init v1.22.4
+question name (hydro-plugin): @hydrooj/pastebin
+question version (1.0.0): 0.0.1
+question description: HydroOJ的剪贴板组件
+question entry point (index.js): index.ts
+question repository url: https://github.com/hydro-dev/pastebin.git
+question author: undefined <i@undefined.moe>
+question license (MIT): MIT
+question private:
+success Saved package.json
+有时我们希望使用本机的 IDE 编写插件上传到服务器（我们也推荐这么做，编辑器提供的代码补全可以很大程度简化开发流程），可以进行如下操作：
yarn init 创建一个项目。yarn add hydrooj -D 安装相关开发组件。hydrooj addon add 插件绝对路径 启用上传的插件。分析：剪贴板组件需要以下功能：
在路由中定义所有的函数应均为异步函数，支持的函数有：prepare, get, post, post[Operation], cleanup
具体流程如下：
先执行 prepare(args) （如果存在）
+args 为传入的参数集合（包括 QueryString, Body, Path）中的全部参数，
+再执行 prepare(args) （如果存在）
+检查请求类型：
+
+为 GET ？
+ -> 执行 get(args)
+为 POST ?
+ -> 执行 post(args)
+ -> 含有 operation 字段？
+ -> 执行 post[Operation]
+
+执行 cleanup()
+如果在 this.response.template 指定模板则渲染，否则直接返回 this.response.body 中的内容。
如 <input type="hidden" name="operation" value="confirm_delete"> 对应 postConfirmDelete 函数。
应当提供 apply 函数，并与定义的 Handler 一同挂载到 global.Hydro.handler[模块名] 位置。 apply 函数将在初始化阶段被调用。
// @noErrors
+// @module: esnext
+// @filename: index.ts
+import {
+ db, definePlugin, Handler, NotFoundError, param, PermissionError, PRIV, Types,
+} from 'hydrooj';
+
+const coll = db.collection('paste');
+
+interface Paste {
+ _id: string;
+ owner: number;
+ content: string;
+ isPrivate: boolean;
+}
+
+declare module 'hydrooj' {
+ interface Model {
+ pastebin: typeof pastebinModel;
+ }
+ interface Collections {
+ paste: Paste; // 声明数据表类型
+ }
+}
+
+async function add(userId: number, content: string, isPrivate: boolean): Promise<string> {
+ const pasteId = String.random(16); // Hydro 提供了此方法，创建一个长度为16的随机字符串
+ // 使用 mongodb 为数据库驱动，相关操作参照其文档
+ const result = await coll.insertOne({
+ _id: pasteId,
+ owner: userId,
+ content,
+ isPrivate,
+ });
+ return result.insertedId; // 返回插入的文档ID
+}
+
+async function get(pasteId: string): Promise<Paste> {
+ return await coll.findOne({ _id: pasteId });
+}
+
+// 暴露这些接口，使得 cli 也能够正常调用这些函数；
+const pastebinModel = { add, get };
+global.Hydro.model.pastebin = pastebinModel;
+
+// 创建新路由
+class PasteCreateHandler extends Handler {
+ // Get请求时触发该函数
+ async get() {
+ // 检查用户是否登录，此处为多余（因为底部注册路由时已声明所需权限）
+ // 此方法适用于权限的动态检查
+ // this.checkPriv(PRIV.PRIV_USER_PROFILE);
+ this.response.template = 'paste_create.html'; // 返回此页面
+ }
+
+ // 使用 Types.Content 检查输入
+ @param('content', Types.Content)
+ @param('private', Types.Boolean)
+ // 从用户提交的表单中取出content和private字段
+ // domainId 为固定传入参数
+ async post(domainId: string, content: string, isPrivate = false) {
+ // 在HTML表单提交的多选框中，选中值为 'on'，未选中则为空，需要进行转换
+ const pasteid = await pastebinModel.add(this.user._id, content, !!isPrivate);
+ // 将用户重定向到创建完成的url
+ this.response.redirect = this.url('paste_show', { id: pasteid });
+ // 相应的，提供了 this.back() 方法用于将用户重定向至前一个地址（通常用于 Ajax 或是部分更新操作）
+ }
+}
+
+class PasteShowHandler extends Handler {
+ @param('id', Types.String)
+ async get(domainId: string, id: string) {
+ const doc = await pastebin.get(id);
+ if (!doc) throw new NotFoundError(id);
+ if (doc.isPrivate && this.user._id !== doc.owner) {
+ throw new PermissionError();
+ }
+ this.response.body = { doc };
+ this.response.template = 'paste_show.html';
+ }
+
+ @param('id', Types.String)
+ async postDelete(domainId: string, id: string) {
+ // 当提交表单并存在 operation 值为 delete 时执行。
+ // 本例中未实现删除功能，仅作为说明。
+ }
+}
+
+// Hydro会在服务初始化完成后调用该函数。
+export async function apply() {
+ // 注册一个名为 paste_create 的路由，匹配 '/paste/create'，
+ // 使用PasteCreateHandler处理，访问改路由需要PRIV.PRIV_USER_PROFILE权限
+ // 提示：路由匹配基于 path-to-regexp
+ ctx.Route('paste_create', '/paste/create', PasteCreateHandler, PRIV.PRIV_USER_PROFILE);
+ ctx.Route('paste_show', '/paste/show/:id', PasteShowHandler);
+}
+
+模板采用 nunjucks 语法。放置于 templates/ 文件夹下。
会在请求结束时根据 response.template 的值选择模板，并使用 response.body 的值进行渲染，存入 response.body 中。
若 response.template 为空或 request.headers['accept'] == 'application/json'，则跳过渲染步骤。
用于提供多国翻译。格式与 Hydro 的 locale 文件夹格式相同。
为什么使用 Hydro？
安全：使用 Linux 容器技术（只读文件系统，命名空间和 cgroup ）进行隔离，杜绝卡评测；
高效：Hydro 使用了沙箱复用技术，拥有极高的评测效率；
扩展：Hydro 支持安装额外模块进行扩展；
强大：配合 Judge 模块（或 HydroJudge 独立评测机），可支持 spj，交互题，提交答案题，文件IO 等多种特性；
自定：所有权限节点均可自由设置；
易上手：无需改动源代码，系统设置中预留了大量可自行修改的内容；管理逻辑简洁；
社区：Hydro 正在持续维护中；
如果您正在使用 HustOJ，可以导出题目为 FPS 文件后使用 fps-importer 插件 直接导入 Hydro。
如果您正在使用 QDUOJ， 可以导出题目为 QDUOJ-zip 格式后使用 import-qduoj 插件直接导入 Hydro。
如果您正在使用 Vijos / SYZOJ / HustOJ / UniversalOJ， 可以直接使用 migrate 插件 导入所有数据至 Hydro。
Hydro 支持很多其他系统无法支持的题型，可在 https://hydro.ac/d/system_test/p 中查看并免费下载使用样例。（需要登录）
下方对比了 Hydro 与其他主流 OJ 系统的功能。（只进行在不修改源代码情况下的对比）
+：支持
+=：部分支持
+?: 未知
+-：不支持
+| 功能 | Hydro | HustOJ | SYZOJ[1] | QDUOJ | Vijos |
|---|---|---|---|---|---|
| 安装 | 一键脚本 | 一键脚本 | 手动搭建 | docker | docker |
| 数据库 | MongoDB | MySQL | MariaDB | Postgres | MongoDB |
| 测试数据存储 | 本地/S3 [2] | 本地 | 本地 | 本地 | 数据库 |
| 多评测机 | + | =[3] | =[4] | = | + |
| 测试数据同步 | 按需抓取 | 全量同步 | 全量同步 | 全量同步 | 按需抓取 |
| 比赛 | ACM/OI/IOI/乐多 | ACM/OI | ACM/OI/IOI | ACM/OI/IOI | ACM/OI |
| 封榜 | + | + | - | - | - |
| 作业功能 | + | + | - | - | + |
| 修改编译命令/添加语言 | + | =[5] | - | - | + |
| 权限系统 [6] | + | = | - | - | + |
| 训练计划(题单) | + | + | -[7] | - | + |
| 团队 | + [8] | - | - | - | + |
| Hack | + | - | - | - | - |
| SpecialJudge | + [9] | + | + | - | = |
| Subtask | + | - | + | - | - |
| 交互题 | + | - | + | - | - |
| RemoteJudge | CF/SPOJ/UOJ/POJ/Luogu | HDU/PKU | - | - | - |
| 题目导入 | fps/syzoj/qduoj/hydro | fps/qduoj | syzoj | fps/qduoj | - |
点击 部署 ，开始部署您的 OJ 吧！
SYZOJ 和 Lyrio （曾用名 syzoj-ng，loj.ac 当前所用系统） 是两套不同的系统，这意味着使用 SYZOJ 无法再导入 loj.ac 的题目，同时 Lyrio 无比赛功能。 ↩︎
S3 指所有兼容 Amazon S3 协议的服务，包括腾讯COS，阿里OSS 等。 ↩︎
安装配置繁琐，且需要手动在服务器间同步数据。 ↩︎
需要手动在服务器间同步数据。 ↩︎
仅能修改部分编译参数，添加语言需要修改源代码。 ↩︎
此处的权限系统指 除用户/管理员二元化权限之外的 的更细粒度的权限划分。 ↩︎
部分二次开发版本有此功能。 ↩︎
通过域功能，允许用户创建域并在域内拥有管理员权限。域之间仅共享账号数据，也可使用域内小组进行权限控制。 ↩︎
支持所有主流 SPJ 格式。 ↩︎
从 2022/8/12 开始，Hydro 为了避免宿主机环境变化对于评测的影响，对于 此后新安装的实例 默认使用 nix 管理环境。
如果你是在这之前安装的 Hydro，请使用 apt 安装编译器后使用 pm2 restart hydro-sandbox 重启沙箱，并忽略本章节。
以下是 nix 的简要操作说明：
使用 nix-env -iA nixpkgs.编译器名 安装新编译器，后重启沙箱 pm2 restart hydro-sandbox 生效。
可以在 Nixos Search 中搜索你需要的编译器。
以下是常用编译器的示例：
nix-env -iA nixpkgs.busybox nixpkgs.bash nixpkgs.diffutils nixpkgs.unzip # 基础组件，已预装，不建议删除
+nix-env -iA nixpkgs.gcc nixpkgs.fpc # C/C++ 和 Pascal，已预装，不建议删除
+nix-env -iA nixpkgs.ghc # Haskell
+nix-env -iA nixpkgs.rustc # Rust
+nix-env -iA nixpkgs.python2 # Python2
+nix-env -iA nixpkgs.pythonPackages.numpy # Python2 Numpy 库
+nix-env -iA nixpkgs.python3Minimal
+nix-env -iA nixpkgs.python3Packages.numpy
+nix-env -iA nixpkgs.php # PHP
+nix-env -iA nixpkgs.go # Golang
+nix-env -iA nixpkgs.nodejs # NodeJS
+nix-env -iA nixpkgs.openjdk_headless # Java
+nix-env -iA nixpkgs.ruby # Ruby
+nix-env -iA nixpkgs.mono # C#
+nix-env -iA nixpkgs.julia_17-bin # Julia
+使用 nix-env -q 查看已安装的列表，后使用 nix-env -e 编译器名 即可删除对应的编译器。
请注意不要误删 Hydro 基础组件，且操作完成后需要重启沙箱 pm2 restart hydro-sandbox 生效。
如果你需要更加复杂的编译环境配置，我们建议使用编写单独的 nix 文件。
{
+ system ? builtins.currentSystem,
+ pkgs ? import <nixpkgs> { system = system; }
+}:
+
+pkgs.buildEnv {
+ name = "hydrojudge-rootfs";
+ paths = with pkgs; [
+ coreutils bash diffutils nix zip unzip gcc
+ # 上方包是评测所需要的，请勿删除，
+ # 在下方列出你所需要的包，查找方式同上文：
+ fpc python3 rustc
+ ];
+ ignoreCollisions = true;
+ pathsToLink = [ "/" ];
+ # 导出一些基本信息和部分编译器所需的 /etc/passwd
+ postBuild = ''
+ mkdir $out/buildInfo
+ echo 'root:x:0:0:root:/root:/bin/bash' >$out/etc/passwd
+ date >$out/buildInfo/timestamp
+ '';
+}
+复制以上文件，保存为 default.nix ，使用 nix-build 进行构建。
构建后会产生一个 result 文件夹，记住该文件夹所在的路径。
打开 ~/.hydro/mount.yaml 将其中 /root/.nix-profile 替换为编译出的 result 文件夹（切换到新的环境）
之后保存并重启沙箱。
后续若需更改环境配置，仅需要修改 default.nix 文件之后 nix-build 重新构建，再重启沙箱即可生效。
构建过程中的缓存文件可以使用 nix-collect-garbage 进行清理。
更详细的 nix 语言介绍，请参照 Nix Guide 和 Nix Manual。
这里提供了几套方案帮助您建立自己的站点，请选择适合您的方案并继续。
搭建过程中如果遇到问题欢迎 联系我们 提问。
不同服务商提供的 CPU 主频不同，下方数据仅供参考。
最低服务器配置： CPU: 1核 内存: 2G。（约可允许 100 人使用）
请尽量不要使用突发性能实例或共享型实例，这可能会导致评测时间计量不准确
CentOS 8 已于 2021-12-31 停止支持，后续不会为安全漏洞发布补丁，建议重装为其他操作系统。
Tips
兼容大部分 Linux 发行版，推荐使用 Debian 12 / Debian 11 / Ubuntu 22.04 （教程多，成功率高，上手简单），不支持 CentOS 及其各种变种：
如果你的机器内存较小（<=2GiB），请避免使用 Ubuntu 22.04，它会消耗较多的内存。建议使用 Debian 12 / Debian 11。
如果你有 Linux 运维经验，Hydro 同样支持在 Alpine Linux 上运行，Alpine Linux 系统启动后仅占用 ~100M 内存，是在低配置服务器上运行的更优方案。
Warning
虚拟机用户请注意：
Docker 用户请注意：
USER 环境变量为 root。--privileged 参数启动容器，否则评测机无法运行。Tips
Hydro 需要使用以下端口： 80, 443, 2019, 8888, 5050, 27017，请确保这些端口空闲。
安装和安装后的所有操作均需要在 root 权限下进行！（sudo su）。
宝塔面板已知出现多次高危漏洞，为防止数据丢失，请不要在生产环境中使用！
运行下面的脚本，等待几分钟即可（建议复制防止敲错）：
LANG=zh . <(curl https://hydro.ac/setup.sh)
+Tips
如果有特殊需求，安装脚本支持一些可选的高级选项，以此方式调用： . <(curl https://hydro.ac/setup.sh) --foo --bar
阿里云/腾讯云/华为云等等用户安装后如果不能访问 请百度搜索 xx云 放行80端口
脚本默认使用的为清华大学镜像。
安装完成后，从 http://服务器ip/ 访问网页端，注册一个账号，之后在终端中使用
hydrooj cli user setSuperAdmin 2
+将首个注册用户设置为超级管理员。之后刷新页面，您应当能在上方导航栏看到控制面板入口。
进入控制面板，右侧系统设置，验证管理员密码后按需修改配置，注意 Server BaseURL 一项需要填写访问网站用的完整的 URL，以 / 结尾。（重要，务必正确填写，样例：https://hydro.ac/）
系统安装后需要题库，可前往 https://hydro.ac/d/tk/p 免费专区进行下载，支持批量导入。 至此，基础功能安装已全部完成，另，如果你的服务部署在内网，且希望外网的用户可以访问，可以百度搜索 “端口映射” 相关教程。
~/.hydro/Caddyfile 的配置文件！Warning
若使用反向代理，请注意系统设置中的 server.xff 和 server.xhost 设置项需要填写正确（小写），分别对应反向代理所添加的标头名（通常为 x-forwarded-for 和 x-forwarded-host，部分反代工具会使用 x-real-ip 替代 x-forwarded-for）。
server.xhost 设置项配置错误会导致用户无法登录等问题。(CsrfTokenError)
server.xff 设置项配置错误会导致无法记录用户IP。
除一键安装脚本在安装 Caddy 后会自动配置设置项，其他工具请在使用工具前先配置好系统设置！否则将造成用户无法登录、无法记录用户IP等问题。
若您使用 Nginx，请注意配置 WebSocket 协议的反向代理，否则会导致评测状态无法自动刷新，在线 IDE 无法正常使用等问题。
Hydro 支持使用 Caddy, HaProxy 等工具进行反向代理，此处 提供了一些配置样例。
Hydro 推荐您使用 Caddy。以下为样例 Caddyfile。 提示：如果您的服务器位于国内，则需要进行备案后才能使用 80 和 443 端口。
hydro.ac {
+ log {
+ output file /data/access.log {
+ roll_size 1gb
+ roll_keep_for 72h
+ }
+ format json
+ }
+ root * /root/.hydro/static
+ @static {
+ file {
+ try_files {path}
+ }
+ }
+ handle @static {
+ file_server
+ }
+ handle {
+ reverse_proxy http://127.0.0.1:8888
+ }
+}
+Tips
使用一键安装脚本部署的 Hydro 一般已自动完成存储配置。
文件默认存储于本地的 /data/file/hydro 目录下，切换存储后端时需要手动复制或移动原有文件。
请根据你使用的存储端类型阅读对应教程。（同时欢迎使用其他存储类型的用户向我们提供详细的存储教程）
MinIO
Warning
新版本 MinIO 占用较大，如果您为轻量使用，我们不建议使用 MinIO 。旧版本 Hydro 用户大部分可直接切换至 file 模式，由 Hydro 代替读取。
安装 MinIO 后进入 控制面板>manage_config。
file.type: s3file.endPoint： http://127.0.0.1:9000（即 MinIO 启动时显示的 endPoint）file.accessKey： 参照 MinIO 配置file.secretKey： 参照 MinIO 配置file.bucket： hydro（MinIO 内部存储桶名称）file.region： us-east-1file.pathStyle： truefile.endPointForUser： /fs/file.endPointForJudge： /fs/保存后重启，已有文件请自行复制。
腾讯云COS
进入 控制面板>系统设置>存储桶设置。
file.type: s3file.endPoint： http://cos.<存储桶地域>.myqcloud.com （或是 https）file.accessKey： 您的腾讯云 API 密钥的 SecretIdfile.secretKey： 您的腾讯云 API 密钥的 SecretKeyfile.bucket： <存储桶名称>file.region： Autofile.pathStyle： truefile.endPointForUser： 给用户使用的 EndPoint，若填 /fs/ 则表示由服务器转发file.endPointForJudge： 给 judge 使用的 EndPoint，若填 /fs/ 则表示由服务器转发保存后重启，已有文件请自行复制。
阿里云OSS
// TODO & PRs Welcome
以 QQ 邮箱为例。
已知能够完整兼容的服务商有：
如果使用其他服务商且没有发现问题，欢迎向此列表 Pull Request。
如您希望改善 Hydro 的访问质量，在您的服务器带宽较小的情况下，您可以考虑使用内容分发网络，即 CDN ，通常情况下您仅需设置资源 CDN 即可大幅度改善访问质量，关于如何使用内容分发网络和使用中的任何问题请联系各大云厂商。
创建并配置好资源 CDN ，在控制面板中将 server.cdn 设置项修改为 CDN 域名。（如 https://cdn.hydro.ac/，以 / 结尾）。
如果您预算充足，可以使用全站 CDN。
Warning
全站 CDN 配置较为繁琐，如您没有相关使用经验请仅建立并配置资源 CDN ，配置资源 CDN 在大部分情况下即可大幅度改善访问质量。 因各服务商全站 CDN 配置方法不同，配置过程不同，需要配置的内容较多，以下仅为参考配置且配置补全，如果有任何问题建议先查阅云服务商文档及咨询云服务商工程师。
缓存设置可以参考以下设置：
| 类型 | 内容 | 缓存行为 |
|---|---|---|
| 全部文件 | 全部文件 | 遵循源站 |
| 文件后缀 | jpg,js,png,css,gif | 缓存一天 |
同时设置添加回源HTTP请求头
| 头部参数 | 头部取值 |
|---|---|
| X-Forward-For | 参考所使用服务商CDN文档来设置用户来源IP |
且您应当修改系统设置中的 server.xff 值为 X-Forwarded-For，该设置是为了能够让系统正确获取到用户的IP地址。
Tips
在使用 cli 之前，请完成数据库配置。
指令中使用 <> 括起来的参数必须给出，用 [] 括起来的参数可以给出，若不给出则按照默认设置。
用户请根据自己的情况替换掉用 <> 或是 [] 包括起来的部分（括号也应替换）
cli 可以帮助用户在控制台下快捷地进行一些操作。
这些命令需要以在终端以 root 用户执行（安装时执行命令的位置）。
下面给出了一些常用的例子。
Tips
很少使用。建议通过 控制面板>导入用户 功能代替
hydrooj cli user create <mail> <username> <password> <uid>
+# 该用户的邮箱、用户名和密码
+
+# 如创建邮箱为 hydro@hydro.local，用户名为 Hydro，密码为 hydrohydro ，UID 为 2 的用户：
+# 请确保 UID 为不小于 2 的正整数且未被占用，邮箱和用户名均不重复。
+hydrooj cli user create hydro@hydro.local Hydro hydrohydro 2
+若一切正常，运行该指令后您会从命令行窗口中看到该用户 uid。
hydrooj cli user setSuperAdmin <uid>
+
+# 如设置 uid 为 2 的用户为管理员：
+hydrooj cli user setSuperAdmin 2
+hydrooj cli user setPriv <uid> <priv>
+关于参数 [priv] ，可阅读 此处。
hydrooj cli user setPassword <uid> <password>
+
+# 如将 uid 为 1 的用户的密码改为 hydrohydro：
+hydrooj cli user setPassword 1 hydrohydro
+先 创建一个账号。
您需要留意运行此指令返回的数字，表示该用户的 uid，需要填入下面的指令中，然后给予该账号评测权限。
hydrooj cli user setJudge <uid>
+完成后将配置的用户名及密码写入评测机配置文件，评测机即可连接到网页端。
用户封禁：
hydrooj cli user setPriv <uid> 0
+IP/邮箱域名封禁：
# key 格式为 ip::xxx.xxx.xxx.xxx （封禁 IP 访问） 或是 mail::xxx.com （禁止 xxx.com 的邮箱注册）
+hydrooj cli blacklist add <key> [duration] # 将 <key> 拉入黑名单，时长为 [duration] （以月为单位的整数，默认为 12，若 duration=0 则永久封禁）
+hydrooj cli blacklist get <key> # 获取黑名单中有关 <key> 的信息
+hydrooj cli blacklist del <key> # 将 <key> 移出黑名单
+所有于 此文件夹 下的函数均可用 cli 调用。
这里并没有列出所有可以运行的指令，因为其中很多功能我们更推荐通过 Web 访问。
hydrooj cli user create <mail> <uname> <password> [uid] [regip] [priv]
+# 创建邮箱为 <mail>，用户名为 <uname>，密码为 <password>，ID 为 [uid]，注册 ip 为 [regip]，权限为 [priv] 的用户
+hydrooj cli user setUname <uid> <unmae> # 将 ID 为 <uid> 的用户的用户名设置为 <uname>
+hydrooj cli user setPriv <uid> <priv> # 将 ID 为 <uid> 的用户的权限设为 <priv>
+hydrooj cli user setPassword <uid> <password> # 将 ID 为 <uid> 的用户的密码设置为 <password>
+hydrooj cli user setEmail <uid> <mail> # 将 ID 为 <uid> 的用户的邮箱设置为 <mail>
+hydrooj cli user setSuperAdmin <uid> # 将 ID 为 <uid> 的用户设为全站管理员
+hydrooj cli problem import <domainId> <file/path> # 将 <file/path> 的Hydro格式题目包导入至 <domainId> 域中
+hydrooj cli problem export <domainId> # 将 <domainId> 域中的所有题目包导出
+hydrooj cli system set <key> <value> # 修改系统设置 <key> 值为 <value>
+Warning
非常不推荐直接操作数据库！
在绝大部分情况下均不需要/不可以直接操作数据库。若确需要，可使用 hydrooj db 命令打开数据库 shell，也可以从 ~/.hydro/config.json 查找数据库 connection string 并使用外部工具进行连接。
注：MongoDB 的用户是附加在特定数据库中的，使用外部工具连接请确保使用了正确的 authSource 选项。
为了保证数据安全，请定期备份。
若您使用自动脚本安装，可使用 hydrooj backup 快捷备份数据，备份完成后会在当前目录生成备份压缩包文件，您可使用 hydrooj restore <备份文件路径> 恢复之前备份的数据。
可使用 MongoDB 自带的 mongodump 进行数据库备份。并将 /data/file 文件夹备份即可。
对于数据库，请请不要在数据库运行时直接拷贝数据库文件夹。请每次备份后检查生成的备份文件的大小和内容，确保备份成功。
请不要把备份数据和 Hydro 系统放在同一台机器上，这样数据丢失的风险仍然较高。
使用 MongoDB 自带的 mongorestore 导入备份的数据库文件，并还原 /data/file 目录文件。
如果只是想不同机器之间迁移部署，只需要在停止 Hydro 和 MongoDB 服务后将相关文件夹（通常为 /data/db 与 /data/file 与 /root/.hydro/config.json ）复制即可。
此指南将教您修改前端文件。
如果您正在使用开发者模式，请直接修改 packages/ui-default/templates 下的文件。
如果您使用安装脚本部署：
请先使用 hydrooj addon create 创建一个本地插件（如果之前没有做过的话）。
~/addon/locales/zh.yaml 。通常的，在您访问的 url 前加上 view-source:（如 view-source:https://hydro.ac 即可查看页面源代码，在第二行的 <html data-page="xxx"> 中 data-page 值即为页面名（首页例外，为 main.html）。 在 默认 templates 中找到对应文件，将文件的全部内容 复制到 ~/addon/templates/ 文件夹下后进行修改即可。
特别的，创建题目时的默认模板位于 partials/problem_default.md，创建训练计划时的默认模板位于 partials/training_default.json，修改方式同上。
以上所有更改均会在重启 Hydro 后生效。
目前支持 csv 格式（用 , 分隔）或 Excel 格式（用 TAB 分隔） 导入用户数据, 数据既可以用文本编辑器创建，也可以用 Excel 等软件来辅助创建。
每行最少三列，最多五列，分别为: 邮箱，用户名，密码，显示名，用户信息。（显示名和用户信息为可选）
请使用 UTF-8 编码，否则中文可能会乱码。
如果使用 CSV 格式（逗号分隔），则用户信息列不可用。
foo@undefined.moe user1 password1
+bar@undefined.moe user2 password2 temp
+test@undefined.moe user3 password3 test {"group":"class1","studentId":"123","school":"Hydro School"}
+可以在粘贴后点击预览验证复制入的数据的有效性
这将创建三个用户：
user1 密码为 password1 , 邮箱 foo@undefined.moe；user2 密码为 password2 ，邮箱 bar@undefined.moe，显示名为 temp；user3 密码为 password3，邮箱 test@undefined.moe，显示名为 test，学校为 Hydro School，学号为 123，该用户将会被分配至当前域的 class1 小组内；Warning
用户创建后无法删除，请谨慎操作
使用一键安装脚本安装的 Hydro 使用 PM2 对进程进行管理。
可以通过下面的指令查看当前 PM2 正在管理的所有进程。
pm2 ls
+一键安装脚本默认会创建下面几个进程：
hydrooj： Hydro 主进程hydro-sandbox： Hydro 评测沙箱mongodb： MongoDB 数据库caddy： 反向代理后文的指令中将用 <name> 替代此处的进程名称，用 <id> 替代进程 ID（进程 ID 可通过 pm2 ls 查看）。（尖括号同样需要替换）
pm2 ls # 查看进程列表
+pm2 start <id> # 启动进程
+pm2 stop <id> # 关闭进程
+pm2 restart <id> # 重启进程
+pm2 del <id> # 删除进程
+pm2 log <id/name> --lines=100 # 查看该进程的后 100 行日志
+pm2 attach <id> # 与进程交互
+pm2 save # 保存对 PM2 进行的修改（在添加、修改、删除进程后需要执行该指令）
+在部分环境（常见于 lxc 容器或是精简版系统）下，服务器重启后 Hydro 可能不能正常自启动，这时请使用 pm2 resurrect 手动载入进程列表。
如果手动修改进程列表且已经覆盖掉保存的原列表，请使用 pm2 stop all && pm2 del all 清空所有进程之后重新运行安装脚本。原有数据不会丢失。
Hydro 主进程同样支持多进程启动，但在中低端服务器（不超过4核）中没有必要使用多进程启动 Hydro，会降低性能且成倍提高内存占用。
pm2 start hydrooj -i <n> # 以 n 进程启动 Hydro 主进程
+Hydro 系统会不定期发布更新，可以使用下面的命令获取更新。
无特殊情况请 不要更新PM2 ！此操作可能导致进程列表丢失！
yarn global upgrade-interactive --latest # 在交互式界面中选择想要更新的组件
+pm2 restart hydrooj # 更新完后需重启 hydrooj
+cd `yarn global dir` && yarn list --pattern hydrooj
+yarn cache clean && nix-collect-garbage
+域功能类似团队，允许在一套系统中创建多个环境（如不同班级，或是不同功能，等等）
用户可以创建多个域。（需要用户有 PRIV_CREATE_DOMAIN 权限，默认仅开放给管理员账户）。 域间数据完全独立，仅用户信息相通（注册账户后，在该实例的所有域中均有效）。
登录账号后，在“我的”选项卡中找到“我的域”，并点击“创建域”，填入以下信息：
gravatar:email 或 qq:id 或 github:name 或 url:link 的格式添加。将会在“我的域”界面内显示。创建域后，您将在此域中拥有管理员权限，可以在域内进行添加题目/创建比赛等操作。
您可以在“管理域”选项卡中点击“初始化讨论节点”按钮初始化讨论节点。
未登录用户将默认使用 guest 权限，登录用户将默认使用 default 权限。（所以将登陆用户设为 default 权限后并不会显示在“管理用户”页内，这也表示所有用户默认不会出现在管理列表中）
所以将一个用户的权限设为 default 和将用户移出该域是等价的。
对于不在列表中的用户，点击右上角“添加用户”，在左侧选中用户，右侧选择权限组，再点击“确定”即可。
若您想要创建比赛/作业，您可以在“比赛”或“作业”选项卡中，在页面右侧找到“创建”按钮， 题目一栏支持根据题目ID或是题目名自动筛选。设置完后可点击“创建”按钮创建比赛（描述这类的框不知道写啥就随便填，不能留空）。
Tips
若因为删除作业/比赛内题目导致无法打开，可以通过 /contest/<id>/edit 或 /homework/<id>/edit（即在无法打开的页面页面后加上 /edit）直接访问编辑页并修正。
若您想要创建训练，您可以在“训练” 项卡中点击“新建训练计划”，填写以下信息：
[
+ {章节详细信息},
+ {章节详细信息},
+ ...
+ {章节详细信息}
+]
+其中，“章节详细信息”的包含以下部分：
_id：章节数字编号；title：章节标题；requireNids：训练此章节之前需要完成的章节数字编号，若无要求则留空，若有多个则使用逗号分隔；pids：此章节中包含的题目的 ID，若有多个则使用逗号分隔。举例：若要在训练中创建三个章节，章节中分别有 ID 为 1，2，3 的题目。其中章节一、二无前置条件，章节三需要同时完成章节一、二后才能进行，则格式如下：
[
+ {
+ "_id": 1,
+ "title": "入门",
+ "requireNids": [],
+ "pids": [1]
+ },
+ {
+ "_id": 2,
+ "title": "精通",
+ "requireNids": [],
+ "pids": [2]
+ },
+ {
+ "_id": 3,
+ "title": "大师",
+ "requireNids": [1,2],
+ "pids": [3]
+ }
+]
+Tips
若因为删除训练计划内题目导致训练计划无法打开，可以通过 /training/<id>/edit（即训练计划页面后加上 /edit）直接访问训练计划编辑页并修正配置文件。
Hydro 中题目的难度，根据递交数、通过率以及每个递交的递交时间和评测结果，通过算法计算得出。
您可以在比赛的详细界面内点击“参与比赛”按钮进行参与。 比赛过程中“成绩表”会根据比赛规则显示排名。 在比赛截止之后，您仍然可以订正其中的题目，但“成绩表”将停止更新。
若您想发布一个讨论，请先进入一个讨论节点，之后点击“创建一个讨论”按钮并填写：
之后点击“创建”按钮进行发布。
您可以在作业的详情页面中，点击“认领作业”。
在作业开始之前，您无法查看作业中的题目。
在作业持续时间内，您与他人的做题情况会被实时统计在“成绩表”内。
在作业进入延期阶段后，您仍然可以提交题目，但成绩表内的分数将根据延期扣分规则按百分比折算。
在作业截止之后，您仍然可以订正其中的题目，但“成绩表”将停止更新。
Hydro 的权限系统使用双层结构，分别为 Privilege (PRIV) 和 Permission (PERM)。
权限在系统内部使用位运算表示，具体的定义与数值可以查看 源代码 。
Privilege 是用户在整套系统内拥有的权限，在所有域均生效。如创建用户，编辑系统设置，创建域，查看域等等。
特别地，PRIV.PRIV_USER_PROFILE 控制一个账号是否能够作为普通账号登录。若不具有此权限，该账号将无法登录（被封禁）。
Permission 是用户在单个域内拥有的权限，如创建题目/比赛，发布/删除讨论等等。
如果 PERM.PERM_VIEW 被禁用，则该用户无法查看此域。
通常我们需要给特定的一组用户分配相同的权限。在用户量较多的时候这会非常混乱难以管理，为此我们设计了【角色】，便于批量操作与管理。
角色是针对域内权限（PERM）的。在系统内置了三个角色：
通查情况下，如果需要对域做特殊的权限控制，应当新建一个用户组（例如 member）并将选定用户加入该用户组。
将角色移出域和将用户的角色设置为 default 是等价的。
若有需要，您也可以创建 teacher, admin 等其他角色。
考虑到系统中的用户可能非常多（数万甚至数十万），在用户列表中仅会显示权限不为 default 的用户。
加入域的过程实际上是 用户通过某种方式自助将自己的权限组由 default 变更到另一权限组（如member） 的过程。
因此在入域申请链接的权限组中选择 guest 和 default 是没有意义的。
作者: laomai
qq: 29985091
网址: http://82.157.98.222:8888/
日期: 2022/03/16
本文为作者使用hydro时的实验记录，希望对大家有帮助.包括如下内容
零. hydro题目存储格式
一. 制做最简单的oj题
二. 含有自定义头文件的oj题，即函数交互式的题目
三. 半自动对拍的oj题，即不需要录入预期输出的题
四. 完全对拍题，即不需要录入输入数据和输出数据的题
五. 指定输入文件和输出文件
六. 多个子任务
七. 客观题，即制做有标准答案的填空和选择题.
如果想在本地建立好题目，然后批量上传的话. 下面的格式应该对你有帮助
每个题目应自占一个目录，目录名为题目编号比如1 ，2，3，4等等.
每个题目目录下一般有下面的元素：problem_zh.md 这个文件是就是题目的内容，即题目的描述，是一个markdown格式的文档.probelm.yaml 文件.这个是题目的配置信息. 比如标题和标签等。
testdata 子目录，对应网站里的测试数据部分里的文件，
里面至少有一个config.yaml文件 用来说明测试的类型.具体内容见后面的例子
如果题目有测试用例，则每个用例至少要提供一个in文件和一个输出文件(但有些测试类型不用，详情见后)
additional_file子目录用来存放给做题者用的额外文件，比如头文件，图片，pdf文档等，在题目的 markdown 文档中可以用下面的格式为这些文件提供下载链接：[提示文字](file://xxx.txt)
下面为手工录入各种题型的步骤，即在网站登录后点创建题目之后的操作.如下图所示 
我们假定题目内容均为下面的markdown文档
# 要求
+
+输入两个整数，输出他们的和
+
+# 样例
+
+```input1
+123 500
+```
+
+```output1
+623
+```
+题目网址: http://82.157.98.222:8888/p/P10000
1.in, 表示用例 1 的输入1.in 的内容为两个整数比如 2 和 3 ，空格分开，如下图所示，然后点确定1.out 文件，内容为 5 ，注意数字编号必须和 in 文件一致，创建之后的文件列表和下面类似.
#include <iostream>
+using namespace std;
+int main(int argc,char* argv[]){
+ int a,b;
+ cin>>a>>b;
+ cout <<(a+b);
+ return 0;
+}
+题目网址: http://82.157.98.222:8888/p/P10001
本类型和类型一的区别在于出题者要向做题者提供一个额外的头文件，做题者的主函数里可以包含这个头文件以调用出题者提供的某些函数，或者实现头文件里指定的函数.
tools.h 和 config.yaml ，如下图所示
tools.h 的内容为
#include<iostream>
+using namespace std;
+
+int add(int x,int y); //留待做题者实现
+
+int main(int argc,char* argv[]){
+ int a,b;
+ cin>>a>>b;
+ cout << add(a,b);
+ return 0;
+}
+这个头文件里实现了一个主函数，并且声明了需要做题者实现的函数add，当然，出题者应该在题目要求里写明这个函数的原型以及把tools.h文件上传到附加文件列表中，以方便做题者.
题面里可以用如下格式为用户提供下载链接，中括号内的内容可以自己写，[tools.h](file://tools.h) 如下面所示
config.yaml文件的内容为
type: default
+filename: null
+user_extra_files:
+ - tools.h
+本题的ac代码为
#include "tools.h"
+int add(int x,int y){
+ return x+y;
+}
+可见本类型的题目，做题者包含给定的头文件后，可以不需要自己实现主函数，只需要专心实现给定的函数即可.
例题网址:http://82.157.98.222:8888/p/P10002
本题型的特点是不需要手工给出每个用例的预期输出，但是要自己编写一个样本程序,测试时会把用户的输出和样本程序的输出进行对比。
仍以两数求和为例
checker.cc，内容如下:#include "testlib.h"
+int main(int argc, char * argv[]) {
+ registerTestlibCmd(argc, argv);
+ int a = inf.readInt(); // 读取输入流的第一个整数
+ int b = inf.readInt(); // 读取输入流的下一个整数
+ int d = a+b;
+ int c = ouf.readInt(); // 读取输出流的下一个整数
+ if (a+b != c)
+ quitf(_wa, "%d + %d expected %d, found %d", a, b,d,c); //输出错误的具体信息,便于做题者调试
+ else
+ quitf(_ok, "answer of %d + %d is %d",a,b,c);
+}
+checker_type: testlib
+checker: checker.cc
+cases:
+ - input: 1.in
+ output: /dev/null # 无输出
+最终的测试文件列表如下所示:
当程序有错误时,输出的效果如下
可见这里输出了错误细节,便于做题者调试
本题的ac代码和类型一的一样,内容为
#include <iostream>
+using namespace std;
+int main(int argc,char* argv[]){
+ int a,b;
+ cin>>a>>b;
+ cout <<(a+b);
+ return 0;
+}
+如果不希望自己录入输入数据,而是在每次测试时自动动态生成的话,可以将题目类型设为interactive,并提供一个对拍程序.仍以求和为例
例题网址: http://82.157.98.222:8888/p/P10005
最后测试数据部分的文件列表如下图所示
checker.cc,内容为:#include "testlib.h"
+#include <iostream>
+using namespace std;
+
+int main(int argc, char* argv[]) {
+ setName("Interactor A+B");
+ registerInteraction(argc, argv);
+ //自动生成两个随机整数
+ rnd.setSeed(time(NULL));
+ int a = rnd.next(1000);
+ int b = rnd.next(1000);
+ // 本程序的输出将作为用户程序的输入
+ cout << a << " " << b << endl;
+ int c;
+ // 用户程序的最后输出将作为本程序的输入
+ cin >> c;
+ //对比用户结果和预期结果
+ if (a+b != c)
+ quitf(_wa, "%d + %d expected %d, found %d", a, b, a+b, c); //输出错误的具体信息,便于做题者调试
+ else
+ quitf(_ok, "answer of %d + %d is %d",a,b,c);
+}
+config.yaml 文件的内容为:type: interactive
+interactor: checker.cc
+cases:
+- input: /dev/null # no input and no output, dynamic generated
+ output: /dev/null
+- input: /dev/null # no input and no output, dynamic generated
+ output: /dev/null
+
AC 代码和类型一中的相同
例题网址:http://82.157.98.222:8888/p/P10003
有时希望指定输入和输出文件，此时测试文件 1.in 和 1.out 和类型一类似, 但是要提供config.yaml文件，内容类似于下
file: test
+则运行时测试环境会自动把每个输入文件复制到test.in中,输出内容和test.out的内容进行对比. ac的代码如下:
#include <fstream>
+using namespace std;
+int main(int argc,char* argv[]){
+ int a,b;
+ ifstream ifs("test.in");
+ ifs>>a>>b;
+ ofstream ofs("test.out");
+ ofs <<(a+b);
+ return 0;
+}
+例题网址: https://hydro.ac/d/system_test/p/7
data<id>-<数字> id为子任务编号time: 100ms
+memory: 8m
+subtasks:
+ - score: 20
+ id: 0
+ cases:
+ - input: data1-1.in
+ output: data1-1.ans
+ - input: data1-2.in
+ output: data1-2.ans
+ - input: data1-3.in
+ output: data1-3.ans
+ - input: data1-4.in
+ output: data1-4.ans
+ - input: data1-5.in
+ output: data1-5.ans
+ - score: 20
+ id: 1
+ cases:
+ - input: data2-1.in
+ output: data2-1.ans
+ - input: data2-2.in
+ output: data2-2.ans
+ - input: data2-3.in
+ output: data2-3.ans
+ - input: data2-4.in
+ output: data2-4.ans
+ - input: data2-5.in
+ output: data2-5.ans
+ - score: 20
+ id: 2
+ cases:
+ - input: data3-1.in
+ output: data3-1.ans
+ - input: data3-2.in
+ output: data3-2.ans
+ - input: data3-3.in
+ output: data3-3.ans
+ - input: data3-4.in
+ output: data3-4.ans
+ - input: data3-5.in
+ output: data3-5.ans
+ - score: 20
+ id: 3
+ if: [2]
+ cases:
+ - input: data4-1.in
+ output: data4-1.ans
+ - input: data4-2.in
+ output: data4-2.ans
+ - input: data4-3.in
+ output: data4-3.ans
+ - input: data4-4.in
+ output: data4-4.ans
+ - input: data4-5.in
+ output: data4-5.ans
+ - score: 20
+ id: 4
+ if: [1, 3]
+ cases:
+ - input: data5-1.in
+ output: data5-1.ans
+ - input: data5-2.in
+ output: data5-2.ans
+ - input: data5-3.in
+ output: data5-3.ans
+ - input: data5-4.in
+ output: data5-4.ans
+ - input: data5-5.in
+ output: data5-5.ans
+可以看出if 用来指定前置子任务.
此外,如果某个子任务没有提供cases部分时,测试时会自动寻找类似于 data<id>-x.in 和data<id>-x.out 的文件,id为子任务编号
上面的例子故意设计为子任务编号和用例文件中的编号不同,所有每个子任务都需要手工指定对应的cases.
注意新版的客观题，格式已经更新。
例题网址:http://82.157.98.222:8888/p/P10004
客观题只需要题面和config.yaml文件. 例子如下:
1. 填空题
+
+1+1 = {{ input(1) }}
+
+2. 选择题
+
+{{ select(2) }}
+- 1+1=2
+- 1+1=3
+- 1+1=4
+
+3. 多选题
+
+{{ multiselect(3) }}
+- A
+- B
+- C
+
+
上传的 config.yaml 内容为
type: objective # 表明该题为客观题
+answers: # 列举出每一题的正确选项与对应的得分
+ '1': ['2', 50]
+ '2': [['A', 'B'], 30] # 填空题支持多答案，满足其一得分
+ '3': [['A', 'B'], 20] # 多选题答案为数组，有部分分
+
+题目运行效果如下：
做完之后点提交,效果如下
可见评分结果正确.
对所有编程题目,题面是必须录入的,如果指定了测试程序时,可以不需要录入输出数据.
如果设置测试方式为interactive,输入数据也不需要手工录入.
想指特殊的测试方式时,一般需要上传一个config.yaml文件,并设置对应字段的值.
对编程题,本文档中用到的字段有
type字段一般为default, 对全自动对拍题,设为interactive
checker_type: testlib checker: checker.cc 用来指定自定义的测试程序,即对拍程序
filename: test用来指定对test.in文件和test.out文件进行读写.
cases:
用来指定测试用例.
更详细的介绍见 https://hydro.js.org/docs/user/testdata/
为了便于系统间进行数据交换，Hydro 定义了一种基于 zip 的标准格式用于题目传输。压缩包内文件结构如下：
喵? tree
+.
+├── 任意文件名的文件夹
+│ ├── problem.yaml
+│ ├── problem_zh.md
+│ ├── testdata
+│ │ ├── config.yaml
+│ │ ├── a1.in
+│ │ ├── a1.out
+│ │ ├── a2.in
+│ │ ├── a2.out
+│ │ ├── a3.in
+│ │ └── a3.out
+│ └── additional_file
+│ ├── a.png
+│ └── b.pdf
+└── ...
+其中 problem.yaml 内容如下：
title: 题目名
+tag:
+- 标签1
+- 标签2
+pid: 题号（字母+数字）
+problem_*.md 中为 markdown 格式的题面，语言代号支持完整形式（如 zh_CN），也支持短形式（如 zh）。若同时存在多个语言的题面，Hydro 将会自动识别并提供切换功能。
testdata 文件夹中存放所有测试数据文件，命名规则和配置文件格式请参照【测试数据格式】章节。
additional_file 中存储附加文件，通常用于存放图片，PDF 等文件。这些文件可以在题面中使用 file://文件名 的路径访问。
拥有 PERM_CREATE_PROBLEM 的用户均可以新建题目。
请点击题库页面右下角的 创建题目 按钮。
Tips
题目 ID 不能全为数字。若留空则使用自动分配的数字题号。
详见下方题面编辑部分，以及 laomai 编写的说明
上传 Hydro 导出的题目压缩包即可。
如果您的压缩包较大无法上传我们也提供cli导入方法：
hydrooj cli problem import <domainId> <file/path> # 将 <file(压缩文件)/path(解压后的文件夹)> 的Hydro格式题目包导入至 <domainId> 域中。
+Hydro 提供了一个小工具 loj-download，可从基于原版 SYZOJ/SYZOJ-NG 搭建的源站下载到符合Hydro格式的题目压缩包。
工具使用方法请前往使用教程查看，自行摸索并确保在网络通畅的环境下使用。
见插件 fps-importer。
见插件 import-qduoj。
题面使用 Markdown 语法，并进行了部分扩展。
支持对样例数据分组显示：
```input1
+1 2
+```
+
+```output1
+3
+```后接的数字为测试点编号，将自动合并，并左右分栏显示。
支持从附加文件引用资源。（您可以先创建题目，上传相关文件后再编辑该题目）
[file](file://input.in)@[pdf](file://foo.pdf) （部分情况下若无法使用，请尝试 @[pdf](file://foo.pdf?noDisposition=1) ）@[doc](file://foo.docx) （依赖 onlyoffice 插件）题面支持合并表格：
| 1 | 1 | 3 | 4 | 5 |
+| --- | --- | --- | --- | --- |
+| 1 | 1 | 2 | 2 | 6 |
+| 1 | 1 | 2 | 2 | 7 |
+| 1 | 4 | 3 | 5 | 5 |
+将被渲染为：
支持内嵌 HTML：（用来对付部分 Markdown 搞不定的东西）
<span bgcolor="red">foo</span>
+可点击右侧分类面板快速添加标签，也可以用英文半角逗号分隔多个标签。
您可以在题目右侧“文件”面板上传测试数据和附加文件。（支持拖拽文件至相应位置进行上传）
测试数据格式。
1. 填空题
+
+1+1 = {{ input(1) }}
+
+2. 选择题
+
+{{ select(2) }}
+- 1+1=2
+- 1+1=3
+- 1+1=4
+
+3. 多选题
+
+{{ multiselect(3) }}
+- A
+- B
+- C
+仅需要配置 config.yaml 即可，不需要上传其他文件。
type: objective # 表明该题为客观题
+answers: # 列举出每一题的正确选项与对应的得分
+ '1': ['2', 50] # 填空题/选择题，单答案
+ '2': # 填空题/选择题，多答案，不同答案对应不同分数，注意空格缩进
+ 'A': 30 # 也可以使用相同分数，即同时存在多个正确答案
+ 'B': 10
+ '3': [['A', 'B'], 20] # 多选题答案为数组，有部分分
+Tips
您可以直接选择文件（支持多选）上传或将文件拖拽至相应位置上传。
若上传文件为 zip 格式，将会自动进行解压操作。
对于一般的题目，您只需提供 .in 和 .out/.ans 文件，以下是一个例子。
请务必确保文件名中含有数字。形如 sample.in 的文件是不会被自动识别的。
喵? tree
+.
+├── a1.in
+├── a1.out
+├── a2.in
+├── a2.out
+├── a3.in
+└── a3.out
+测试数据将被自动识别，并使用 1S 256MB 的限制。
Tips
推荐您通过 评测设置 在线编辑题目配置，可以拥有更好的编辑体验。
上传 config.yaml 文件即可，文件格式如下（下方所有样例均为可选项，若无说明则预填写的内容即为默认值）：
# 题目类型，可以为 default(比对输出，可以含spj), objective(客观题), interactive(交互题)
+type: default
+
+# 全局时空限制（此处的限制优先级低于测试点的限制）
+time: 1s
+memory: 128m
+
+# 输入输出文件名（例：使用 foo.in 和 foo.out），若使用标准 IO 删除此配置项即可
+filename: foo
+
+# 此部分设置当题目类型为 default 时生效
+# 比较器类型，支持的值有 default（直接比对，忽略行末空格和文件末换行）, ccr, cena, hustoj, lemon, qduoj, syzoj, testlib(比较常用)
+checker_type: default
+# 比较器文件（当比较器类型不为 default 时填写）
+# 文件路径（位于压缩包中的路径）
+# 将通过扩展名识别语言，与编译命令处一致。在默认配置下，C++ 扩展名应为 .cc 而非 .cpp
+checker: chk.cc
+
+# 此部分设置当题目类型为interactive时生效
+# 交互器路径（位于压缩包中的路径）
+interactor: interactor.cc
+
+# Extra files 额外文件
+# These files will be copied to the working directory 这些文件将被复制到工作目录。
+# 提示：您无需手动上传 testlib.h。
+user_extra_files:
+ - extra_input.txt
+judge_extra_files:
+ - extra_file.txt
+
+# Test Cases 测试数据列表
+# If neither CASES or SUBTASKS are set(or config.yaml doesn't exist), judge will try to locate them automaticly.
+# 如果 CASES 和 SUBTASKS 都没有设置或 config.yaml 不存在， 系统会自动尝试识别数据点。
+# We support these names for auto mode: 自动识别支持以下命名方式：
+# 1. [name(optional)][number].(in/out/ans) RegExp: /^([a-zA-Z]*)([0-9]+).in$/
+# examples:
+# - c1.in / c1.out
+# - 1.in / 1.out
+# - c1.in / c1.ans
+# 2. input[number].txt / output[number].txt RegExp: /^(input)([0-9]+).txt$/
+# - example: input1.txt / input2.txt
+#
+# The CASES option has higher priority than the SUBTASKS option!
+# 在有 CASES 设置项时，不会读取 SUBTASKS 设置项！
+#
+# The CASES option has been deprecated in the new version, please use the more personalized SUBTASKS!
+# CASES 已于新版本中被废弃，请使用个性化程度更高的SUBTASKS！
+# score: 50 # 单个测试点分数
+# time: 1s # 时间限制
+# memory: 256m # 内存限制
+# cases:
+# - input: abc.in
+# output: def.out
+# - input: ghi.in
+# output: jkl.out
+# 或使用Subtask项：
+subtasks:
+ - score: 30
+ type: min # 可选 min/max/sum，分别表示取所有测试点最小值、所有测试点最大值、所有测试点之和
+ time: 1s
+ memory: 64m
+ cases:
+ - time: 0.5s
+ memory: 32m # 可对单个测试点单独设置时间限制和内存限制
+ input: a.in
+ output: a.out
+ - input: b.in
+ output: b.out
+ - score: 70
+ time: 0.5s
+ memory: 32m
+ if: [0] # 可选，传入数组，表示仅在subtask0通过时此subtask才计分
+ cases:
+ - input: c.in
+ output: c.out
+ - input: d.in
+ output: d.out
+
+# 提交语言限制
+# 列举出所有本题允许使用的语言对应的代码（需要和评测机 lang.yaml 内的语言代码相同）
+# 使用语言ID而非名称！对于有子类的选项，请详细至子分类！
+langs:
+ - c
+ - cc
+ - cc.cc11o2
+ - pas
+
+# 时间内存倍率
+# 对某语言设置时间或内存倍率（需要和评测机 lang.yaml 内的语言代码相同）
+# 部分语言默认已存在倍率，请前往控制面板中查看！
+# 使用语言ID而非名称！对于有子类的选项，请详细至子分类！
+time_limit_rate:
+ py.py3: 2
+memory_limit_rate:
+ java: 1.5
+可以在 此题库 中找到各种类型题目的配置示例。
使用 Linux 容器技术隔离用户程序
支持使用脚本一键搭建
提供了比赛 训练 讨论 题解 作业等功能，并可通过安装附加组件进行扩展
沙箱复用，延迟计算，提高运行效率
Hydro 是一个高效的信息学在线测评系统。特点：易于部署（且提供安装脚本），轻量，功能强大且易于扩展。
欢迎 star 本项目，这是对开发者的鼓励。
项目的开发与维护需要资金，欢迎进行捐助。
Hydro 提供收费的功能定制服务，如您需要可与我们联系。
相关文档若说明的不够详细，请提交 Pull Request 或联系开发组说明。
Bug 和功能建议请在 Issues 提出。
Email i@undefined.moe
Telegram @undefinedmoe
Hydro 用户群：1085853538
注1：Hydro 为开源框架，任何人均能够在遵守协议的情况下使用这套框架。
版权申诉相关问题请联系对应网站管理者，（通常为其 UID=2 的用户），与开发者无关。
注2：加入用户群请先阅读《提问的智慧》。
同时群内可能存在部分令您感到不适或感到冒犯的内容。若对此有顾虑请勿加群。
本项目中的 examples/ install/ packages/ui-default/ 下的内容仅采用 AGPL-3.0 进行授权。 项目其余部分使用双重许可：
基于 AGPL3 协议第七条，您在使用本项目时，需要遵守以下额外条款：
即：
在您部署 Hydro 时，需要保留底部的 Powered by Hydro 字样，其中的 Hydro 字样需指向 hydro.js.org/本仓库/fork 之一的链接。
若您对源码做出修改/扩展，同样需要以 AGPL-3.0-or-later 开源，您可以以 Powered by Hydro, Modified by xxx 格式在页脚注明。
此限制对以下模块仍然有效：
若您需要对这些模块闭源处理，请考虑联系我们以购买许可。
鉴于 Mirai 处的 不和谐事件 对此项目做如下声明：
如果您对以上条目感到不适，建议您停止使用本项目。
排名不分先后，按照链接字典序。
安装 Elasticsearch 后安装 @hydrooj/elastic-search 插件。
进入 HydroOJ 控制面板，在系统设置内正确填写endpoint。
然后在脚本管理中找到重建题目索引，点击运行，参数留空即可。
至此，搜索功能应当可以正常使用。
在题库右侧“创建题目”一栏中选择“从 FPS 文件导入”。
在打开的窗口中，您可以上传：
由于防止解析 fps 文件消耗大量内存，将拒绝导入超过 64MiB 的文件。
xml 文件需要为 UTF8 编码，否则可能出现中文题面乱码；
若您的文件超过大小限制，可考虑先在本地使用 Easy-Fps-Viewer 等工具进行拆分。
插件需要 MaxMind 的 Geolite2-City.mmdb 支持，在安装插件后需要将mmdb拷贝至插件同一目录下方可启用，如果你不知道这是什么，请勿安装。
Tips
您可以通过一键安装脚本快速安装独立评测机，详情请前往 部署Hydro 查看。
在配置评测机之前，请确认您的站点已经可以访问并正常登录/注册。
您应该预先下载您所要支持的语言的编译器，若您在配置完评测机后 升级/重新安装 了编译器，您需要重新启动沙箱。
关于编译器说明，请参照 编译器 章节。
如果不使用自动脚本，您需要按照如下方式手动安装沙箱服务：
前往 criyle/go-judge 下载对应 cpu 架构的 go-judge。 go-judge 需要在后台运行并监听 127.0.0.1:5050 。如果系统使用的 cgroup 版本为 1 或者使用的为非 systemd init 的发行版，请以 root 权限运行。 可使用 pm2 进行管理。
Tips
由于用附加组件安装的评测机与 Hydro 必须在同一台服务器上，每一个 Hydro 实例最多只能有一台评测机由附加组件安装。
在安装 Hydro 的机器上运行下面的指令安装 @hydrooj/hydrojudge：
yarn global add @hydrooj/hydrojudge
+hydrooj addon add @hydrooj/hydrojudge
+重启 Hydro 后 hydrojudge 即可正常运行。
Tips
该方法可以帮助您在任意服务器上部署评测机。
首先需要创建一个有 PRIV_JUDGE 权限的账户，具体方法参照 此处。（在部署 Hydro 的服务器上运行）
然后在运行评测机的服务器上安装 HydroJudge ：
. <(curl https://hydro.ac/setup.sh) --judge
+创建目录 ~/.config/hydro，在该目录下创建文件 judge.yaml，配置文件格式如下：
hosts:
+ localhost:
+ type: hydro # vj4 用户请在此处填写 vj4
+ server_url: http://localhost/ # Hydro 运行的网址
+ uname: judge # 评测账号用户名
+ password: abc123 # 评测账号密码
+ detail: true # 默认为 true
+设置完之后，使用下面的指令即可开始运行（可以使用 pm2 管理）：
hydrojudge
+HydroJudge 会发布不定期更新。您可以使用 yarn global upgrade-interactive --latest 来检测并进行更新。
在 系统设置>hydrojudge 中有一栏 Disable builtin judge，将它勾上，然后重启 Hydro 即可。
根据开启的方法关闭即可。
关闭后运行下面指令即可。
yarn global remove @hydrooj/hydrojudge
+hydrooj addon remove @hydrooj/hydrojudge
+在 系统设置>hydrojudge 修改对应的参数，然后重启 Hydro 和 hydrojudge 即可。
如果有需要修改单题测试点数量上限等设置，可以在 ~/.config/hydro/judge.yaml 的末尾添加下列内容：
testcases_max: 100 # 单题最多测试点数量
+total_time_limit: 120 # 单题最大总测试时长
+parallelism: 2 # 单评测机评测进程数量
+# 更多可选配置均可添加在此处，格式与前面的三排类似
+在 此处 的设置均可添加到此处。
对于已安装内置评测机的用户（无论内置评测机是否启动），在 控制面板>系统设置 中修改 judge.langs 配置项即可；对于没有安装内置评测机的用户，需要在 ~/.config/hydro/langs.yaml 中配置。
文件格式参照 此处 。
如果您添加了新的语言，您还需要前往 控制面板>系统设置 中修改 Language Highlight ID 与 Monaco language modes。
分别表示选择对应的语言后的高亮设置（基于 PrismJS）和 Monaco 编辑器语法规则设置。
修改完后请重启 Hydro 和 hydrojudge 。
参照 测试数据格式 配置。
Warning
如果不调整沙箱的空间大小，当您的评测使用文件 IO 且输入输出文件较大时可能会引发错误。
对于 2022/8/12 前安装的用户：
在服务器上运行下面的代码找到 hydro-sandbox 的运行目录：
pm2 info hydro-sandbox | grep "exec cwd"
+将 mount.yaml 下载并放置在 sandbox 的运行目录下。然后修改第 64 行和第 68 行的 size 和 nr_inodes 的大小至您想要的大小，保存后重启 sandbox 即可完成更改。
对于 2022/8/12 后安装的用户：
编辑 /root/.hydro/mount.yaml，修改 size 即可。
-fdiagnostics-color=always例：
c:
+ compile: /usr/bin/gcc -O2 -Wall -std=c99 -o ${name} foo.c -lm -fdiagnostics-color=always
+2022/8/12 后安装的实例默认已开启无限栈空间，无需手动操作
在很多时候系统默认为程序提供的栈空间并不能满足我们的需求，此时我们需要手动为用户程序提供更大的栈空间。
修改 pm2 中 hydro-sandbox 的启动参数为 ulimit -s unlimited && /usr/bin/hydro-sandbox ：
pm2 del hydro-sandbox
+pm2 start bash --name hydro-sandbox -- -c "ulimit -s unlimited && hydro-sandbox"
+禁用 CPU 频率缩放与 Intel 睿频加速技术，防止 CPU 频率波动。
禁用内存地址空间随机化，以使得存在内存寻址错误的代码能够得到更多可重复的结果，可以通过在 /etc/sysctl.conf 中添加下面这行并运行 sudo sysctl -p 应用：
kernel.randomize_va_space = 0
+在控制面板上出现内容为 You are using cgroup v2 without kernel 5.19+. This could result in inaccurate memory usage measurements. 警告时，意味着当前系统的内存消耗计量存在误差。
部分 Linux 设备默认使用 cgroup2，而在 5.19 版本前的内核的 cgroup2 中移除了精确计量内存消耗的接口。 若要获得更精确的内存计量，推荐启用 cgroup v1 (您可以通过检查 /sys/fs/cgroup/memory/memory.memsw.usage_in_bytes 是否存在来验证是否当前系统是否启用了 cgroup v1 )：
以 Ubuntu 的默认引导器 GRUB 2 为例，编辑 /etc/default/grub： 在其中
GRUB_CMDLINE_LINUX_DEFAULT="quiet splash"
+后，加入 `cgroup_enable=memory swapaccount=1 systemd.unified_cgroup_hierarchy=0，变为：
GRUB_CMDLINE_LINUX_DEFAULT="quiet splash cgroup_enable=memory swapaccount=1 systemd.unified_cgroup_hierarchy=0"
+运行以下命令更新 GRUB 2 的配置，然后重新启动。
update-grub && reboot
+Hydro 支持使用插件扩展自身所支持的功能。
Warning
插件对站点的所有内容具有完全的访问权限，请不要启用来历不明的插件。
Tips
部分插件（斜体标注）需配合第三方软件使用，如仅安装不配置会导致系统无法正常运行，详情请前往左侧插件详情查看。
Hydro 官方目前提供了以下附加组件：
| ID | 描述 |
|---|---|
| @hydrooj/blog | 博客功能 |
| @hydrooj/fps-importer | 导入 fps 格式的题目 |
| @hydrooj/geoip | 显示用户登录地（需要IP库支持） |
| @hydrooj/hydrojudge | 评测组件 |
| @hydrooj/import-qduoj | 导入 QDUOJ 导出的题库 |
| @hydrooj/login-with-github | 允许用户使用 GitHub 登录 |
| @hydrooj/login-with-google | 允许用户使用 Google 登录 |
| @hydrooj/migrate | 从 vijos4/HustOJ/SYZOJ/UniversalOJ 升级 |
| @hydrooj/recaptcha | 注册时启用 reCAPTCHA 验证码 |
| @hydrooj/ui-default | Hydro 的默认用户界面 |
| @hydrooj/onlyoffice | 显示 doc/docx 格式题目 |
| @hydrooj/sonic | 基于 sonic 的题目搜索增强 |
| @hydrooj/elastic-search | 基于 Elastic 的题目搜索增强 |
| @hydrooj/vjudge | Codeforces/SPOJ/UOJ/POJ/Luogu |
| @hydrooj/prom-client | 导出系统状态至 Prometheus |
大部分插件的配置均可在安装后于 控制面板>系统设置 中找到。
部分插件若安装后没有正确配置可能会影响系统正常使用！
先全局安装所需模块，再向 hydrooj 注册即可。例：安装 @hydrooj/geoip
yarn global add @hydrooj/geoip
+hydrooj addon add @hydrooj/geoip
+或者，如果你正在安装一个其他途径获取的插件（自行创建等），请直接使用文件夹 绝对路径： （文件夹路径即为 包含 package.json 的文件夹）
hydrooj addon add /root/xxx
+请不要将插件与插件嵌套摆放，否则可能会导致一些不可预知的问题。
安装完插件后需要重启 hydrooj 以使插件生效。
hydrooj addon list
+yarn global upgrade-interactive --latest
+yarn global remove @hydrooj/geoip
+hydrooj addon remove @hydrooj/geoip
+Warning
迁移会删除当前 Hydro 的所有数据（含用户账户信息）并移入 HUSTOJ 的数据。
请注意备份相关文件。
请先完成 Hydro 的部署并完成对文件服务的配置(setting_file)。 在迁移数据之前，请先停止正在运行的 HUSTOJ 服务，仅保留其数据库开启。 请注意 Hydro 所在的数据库不应和源 HUSTOJ 数据库相同。
安装插件后，您应当能够在 控制面板>脚本管理 中找到名为 migrateHustoj 的脚本。 其参数格式如下：
{"host":"localhost","port":3306,"name":"jol","username":"","password":"","domainId":"system","contestType":"","dataDir":"","uploadDir":""}
+jolsystemoi 或者 acm，视情况而定/home/judge/src/web/upload/ ，如果此路径与您路径相同，请不要填写此项）当脚本运行完成后，请重启 Hydro 实例，会自动完成之后的升级操作。 迁移后，请使用原 HUSTOJ 的管理员账号登录实例。
SYZOJ 与 HUSTOJ 迁移方法类似，迁移脚本应运行名为 migrateSyzoj 的脚本外，SYZOJ无需 contestType 参数。 其参数格式如下：
{"host":"localhost","port":3306,"name":"syzoj","username":"","password":"","domainId":"system","dataDir":""}
+syzojsystem由于SYZOJ脚本会将原站所有数据迁移，所以运行耗时较长。 当脚本运行完成后，请重启 Hydro 实例，会自动完成之后的升级操作。 迁移后，请使用原 SYZOJ 的管理员账号登录实例。
UniversalOJ （常称作UOJ社区版）与前两者迁移方法类似，迁移脚本应运行名为 migrateUniversalOJ 的脚本。
由于其升级过程较为麻烦，安装脚本已提供自动升级服务，如您需要可运行安装脚本一键迁移，手动迁移请在开发群中提问。
由于UniversalOJ脚本会将原站所有数据迁移，所以运行耗时较长。 当脚本运行完成后，请重启 Hydro 实例，会自动完成之后的升级操作。 迁移后，请使用原 UniversalOJ 的管理员账号登录实例。
Warning
迁移会删除当前 Hydro 的所有数据（含用户账户信息）并移入 vj4 的数据。
请注意备份相关文件。
请先完成 Hydro 的部署并完成对文件服务的配置(setting_file)。
在迁移数据之前，请先停止正在运行的 vj4 服务，仅保留其数据库开启。
请注意 Hydro 所在的数据库不应和源 vj4 数据库相同。
若您使用 vj4-docker ，可更改 docker-compose.yml 将数据库映射至其他本机端口。
安装插件后，您应当能够在 控制面板>脚本管理 中找到名为 migrateVijos 的脚本。
其参数格式如下：
{"host":"localhost","port":27017,"name":"vj4","username":"","password":""}
+Tips
vj4-docker 中数据库名为 vj4，无账号密码。
当脚本运行完成后，请重启 Hydro 实例，会自动完成之后的升级操作。 迁移后，请使用原 vj4 的管理员账号登录实例。
Warning
若您的 vj4 是由 vj2 或 tyvj 升级而来，在迁移完成后请不要卸载该插件，否则可能导致部分用户无法登录。
Tips
我们采用 reCAPTCHA v3 来检验注册者是否是人类，在注册过程中没有看见传统验证码属正常现象。
前往 https://www.google.com/recaptcha/admin/create 创建 reCAPTCHA 密钥。
reCAPTCHA 类型请选择“reCAPTCHA 第 3 版”。
创建成功后将客户端密钥和服务端密钥分别填入系统设置 recaptcha 栏下的 key 和 secret 中，重启 Hydro 后 reCAPTCHA 即可正常工作。
使用 root 用户执行如下命令：
nix-env -iA nixpkgs.sonic-server
+使用 root 用户执行如下命令：
yarn global add @hydrooj/sonic
+hydrooj addon add @hydrooj/sonic
+在 /root/.sonic/config.cfg（没有的自行建立，也可以换成其他的你喜欢的路径）按照以下配置示例写入配置。
配置示例：
# Sonic
+# Fast, lightweight and schema-less search backend
+# Configuration file
+# Example: https://github.com/valeriansaliou/sonic/blob/master/config.cfg
+
+
+[server]
+
+log_level = "error"
+
+
+[channel]
+
+inet = "127.0.0.1:1491" # 默认监听本机
+tcp_timeout = 300
+
+auth_password = "SecretPassword"
+
+[channel.search]
+
+query_limit_default = 10
+query_limit_maximum = 100
+query_alternates_try = 4
+
+suggest_limit_default = 5
+suggest_limit_maximum = 20
+
+
+[store]
+
+[store.kv]
+
+path = "/data/sonic/store/kv/"
+
+retain_word_objects = 1000
+
+[store.kv.pool]
+
+inactive_after = 1800
+
+[store.kv.database]
+
+flush_after = 900
+
+compress = true
+parallelism = 2
+max_files = 100
+max_compactions = 1
+max_flushes = 1
+write_buffer = 16384
+write_ahead_log = true
+
+[store.fst]
+
+path = "/data/sonic/store/fst/"
+
+[store.fst.pool]
+
+inactive_after = 300
+
+[store.fst.graph]
+
+consolidate_after = 180
+
+max_size = 2048
+max_words = 250000
+执行如下命令：
pm2 start sonic -- -c /root/.sonic/config.cfg
+pm2 save
+进入 HydroOJ 控制面板，配置 sonic 后端地址。
如果您直接复制配置示例，那么按照以下内容配置：
127.0.0.11491SecretPassword修改完成后，重启 HydroOJ。
执行命令 pm2 restart hydrooj。
进入 HydroOJ 控制面板，在脚本管理中找到重建题目索引，点击运行，参数留空即可。
至此，搜索功能应当可以正常使用。
请更新到 HydroOJ 最新版本后，再运行重建题目索引。
Warning
此文档已过时，仅作留存使用，以下教程仅为实力，请前往 FAQS(常用教程) 查看使用指南。
远程站点对提交数量和访问次数有相关限制，Hydro 不保证 VJudge 的 100% 可用性。
安装插件后创建名为 codeforces 的域，进入数据库 db.domain.updateOne({_id:'codeforces'},{$set:{mount:'codeforces'}});
在 codeforces 的域设置中，将 allowedLangs 如下配置（在新版即在允许提交的语言中选中所有 codeforces 开头的语言）：
codeforces,codeforces.43,codeforces.52,codeforces.50,codeforces.54,codeforces.59,codeforces.61,codeforces.65,codeforces.9,codeforces.28,codeforces.32,codeforces.12,codeforces.60,codeforces.36,codeforces.48,codeforces.19,codeforces.3,codeforces.4,codeforces.51,codeforces.13,codeforces.6,codeforces.7,codeforces.31,codeforces.40,codeforces.41,codeforces.67,codeforces.49,codeforces.20,codeforces.34,codeforces.55
+在 vjudge 表中插入如下条目：
{type:'codeforces', handle:'<codeforces login handle>', password:'<codeforces login password>'}
+将如下配置添加至 langs 设置末尾：
codeforces:
+ execute: none
+ display: Codeforces
+ domain:
+ - codeforces # Allow domain 'codeforces' to use these languages
+codeforces.43:
+ highlight: cpp astyle-c
+ monaco: cpp
+ display: GNU GCC C11 5.1.0
+ comment: //
+codeforces.52:
+ highlight: cpp astyle-c
+ monaco: cpp
+ display: Clang++17 Diagnostics
+ comment: //
+codeforces.50:
+ highlight: cpp astyle-c
+ monaco: cpp
+ display: GNU G++14 6.4.0
+ comment: //
+codeforces.54:
+ highlight: cpp astyle-c
+ monaco: cpp
+ display: GNU G++17 7.3.0
+ comment: //
+codeforces.59:
+ highlight: cpp astyle-c
+ monaco: cpp
+ display: Microsoft Visual C++ 2017
+ comment: //
+codeforces.61:
+ highlight: cpp astyle-c
+ monaco: cpp
+ display: GNU G++17 9.2.0 (64 bit, msys 2)
+ comment: //
+codeforces.65:
+ highlight: cpp astyle-cs
+ monaco: csharp
+ display: C# 8, .NET Core 3.1
+ comment: //
+codeforces.9:
+ highlight: cpp astyle-cs
+ monaco: csharp
+ display: C# Mono 6.8
+ comment: //
+codeforces.28:
+ highlight: d
+ monaco: plain
+ display: D DMD32 v2.091.0
+ comment: //
+codeforces.32:
+ highlight: go
+ display: Go 1.15.6
+ comment: //
+codeforces.12:
+ highlight: haskell
+ display: Haskell GHC 8.10.1
+ comment: --
+codeforces.60:
+ highlight: java astyle-java
+ monaco: java
+ display: Java 11.0.6
+ comment: //
+codeforces.36:
+ highlight: java astyle-java
+ monaco: java
+ display: Java 1.8.0_241
+ comment: //
+codeforces.48:
+ highlight: kotlin
+ display: Kotlin 1.4.0
+ comment: //
+codeforces.19:
+ highlight: ocaml
+ monaco: plain
+ display: OCaml 4.02.1
+ comment: ['(*','*)']
+codeforces.3:
+ highlight: pascal
+ display: Delphi 7
+ comment: //
+codeforces.4:
+ highlight: pascal
+ display: Free Pascal 3.0.2
+ comment: //
+codeforces.51:
+ highlight: pascal
+ display: PascalABC.NET 3.4.2
+ comment: //
+codeforces.13:
+ highlight: perl
+ display: Perl 5.20.1
+ comment: '#'
+codeforces.6:
+ highlight: php
+ display: PHP 7.2.13
+ comment: //
+codeforces.7:
+ highlight: python
+ display: Python 2.7.18
+ comment: '#'
+codeforces.31:
+ highlight: python
+ display: Python 3.9.1
+ comment: '#'
+codeforces.40:
+ highlight: python
+ display: PyPy 2.7 (7.3.0)
+ comment: '#'
+codeforces.41:
+ highlight: python
+ display: PyPy 3.7 (7.3.0)
+ comment: '#'
+codeforces.67:
+ highlight: ruby
+ display: Ruby 3.0.0
+ comment: '#'
+codeforces.49:
+ highlight: rust
+ display: Rust 1.49.0
+ comment: //
+codeforces.20:
+ highlight: scala
+ display: Scala 2.12.8
+ comment: //
+codeforces.34:
+ highlight: javascript
+ display: JavaScript V8 4.8.0
+ comment: //
+codeforces.55:
+ highlight: javascript
+ display: Node.js 12.6.3
+ comment: //
+之后再重启 Hydro 即可。
|
+ |
+ Priority | +Change Frequency | +Last Updated Time | +
|---|---|---|---|
|
+ |
+
+ |
+
+ |
+
+ |
+