HydroOJ 从入门到入土（1）狡猾的分布式官方文档(24.1.8更新)

本系列旨在记录使用HydroOJ时的一些坑点，更全的说明文档请查看官方文档。
欢迎联系本人 QQ 补充: 2422609586. HydroOJ 官方QQ群: 1085853538.

入门第一坑：官方文档不止一处！

都说学习项目要先认真读文档，HydroOJ的文档使用了分布式阅读系统，并异地多中心部署（bushi），所以需要汇总一下：

官方文档汇总目录

目录

• 入门第一坑：官方文档不止一处！
  • 官方文档汇总目录
• 下边对官方文档主要目录进行整合索引, 可以使用 CTRL+F / CMD+F
• 1. 官方文档: https://docs.hydro.ac/docs/
  • 1.1 FAQ#1: https://docs.hydro.ac/FAQ/ (常见问题解答 / 常见问题集合)
  • 1.2 [半官方]Hydro常见题型的制做心得(by laomai)
• 2. FAQ#2: https://hydro.ac/d/faqs/p/
• 3. 测试题域: https://hydro.ac/d/system_test/p/
• 4.OJ 使用帮助: https://hydro.ac/wiki/help
• 题库相关
  • （免费rmj）一本通启蒙篇v2.0 (适用于4.9.17 ~ 4.9.27, 修正了公式格式错误, QQ 群下载, 一定要阅读压缩包内说明!)
  • （免费rmj）一本通启蒙插件(v3) by HydroOJ (>=4.10.1)
  • （免费rmj）BZOJ 远程评测插件 by 小蛐蛐
  • （免费rmj）洛谷深入浅出程序设计竞赛 - 基础篇(>=4.10.2)
  • 免费 / 付费题库下载(0.5 元一道题, 自造数据): https://hydro.ac/d/tk/
  • 自带的 vjudge 插件自动爬题目+远程评测: https://hydro.ac/d/faqs/p/13
  • 洛谷付费远程评测服务: https://docs.lgapi.cn/open/project/hydro
  • 群内有一些免费题库包

下边对官方文档主要目录进行整合索引, 可以使用 CTRL+F / CMD+F

1. 官方文档: https://docs.hydro.ac/docs/

总览

• 介绍
  • 功能对比
  • 截图
  • 现在开始

部署

• 部署 Hydro
  • 服务器选择
  • 部署
• 存储
• 反向代理 / SSL 配置
• 编译器
  • 进阶

站点管理员文档

• 维护
  • PM2
    • 进程名称
    • PM2 基本指令
  • 更新
  • 查看已安装版本
  • 清除缓存
• Hydro Cli
  • 创建用户
  • 设置全站管理员
  • 设置用户权限
  • 更改用户密码
  • 创建评测账号
  • 黑名单相关
  • 命令列表
• 导入用户
• 使用内容分发网络
  • 资源 CDN
  • 全站 CDN
• 数据库备份和恢复
  • 进入数据库
  • 快速备份与恢复
  • 手动备份
  • 手动恢复备份
• 前端修改
  • 修改页面翻译或是添加新语言：
  • 修改页面模板：
• 常见问题
  • 已移动至 此处

用户文档

• 用户文档

  • 题目难度
  • 参与比赛
  • 发布讨论
  • 认领作业

• 域

  • 简介
  • 创建域
  • 初始化讨论节点
  • 访问控制
  • 创建比赛/作业
  • 创建训练

• 权限系统

  • Privilege
  • Permission
  • 角色
  • 加入域

• 题目

  • 创建题目
  • 导入题目
    • 从 Hydro 导入
    • 从 SYZOJ 导入
    • 从 FPS 文件导入
    • 从 QDUOJ 导入
  • 编辑
    • 题面
    • 标签
  • 文件
  • 客观题
    • 题面
    • 测试数据

• 测试数据格式

  • 自动模式
  • 使用配置文件

• Hydro Problem Format

• 复制题目

  • 操作流程
  • 限制

1.1 FAQ#1: https://docs.hydro.ac/FAQ/ (常见问题解答 / 常见问题集合)

• 如何快速上手了解系统功能？
• 什么是 OJ？
• Arch Linux 开发模式安装时出现 ERR_STREAM_PREMATURE_CLOSE: Premature close 错误
• 为什么我安装完成之后仍然无法访问？
• 为什么我配置完反向代理(caddy/nginx)之后无法登录(出现CsrfTokenError)？
• 怎么备份/还原备份/迁移数据？
• 恢复备份时出现 '/data/file/hydro': Directory not empty
• 更新升级
• 怎么导入题目/创建题目？
• 如何限制未登录用户访问？
• 比赛作业里面的时间是什么含义，OI排名跟普通排名有何区别？
• 脚本把 OJ 装在哪里了？
• 题目的限时和内存限制的精度是怎样的？
• 我想让 Python 支持 numpy 等等库，怎么办？
• 使用安装脚本后忘记 MongoDB 的账号密码怎么办？
• 如何关闭、打开用户注册？
• 用户名为 Hydro 的用户是干什么的？密码是什么？可以登录么？
• 如何修改网站图标？ (favicon)
• 如何重置数据？
• 评测显示“总时限超过 60s，评测取消”
• 如何在背景中添加线条特效？
• 使用 Hydro 要花多少钱？
• execve: no such file or directory
• 怎么自定义用户标签？(MOD, Badge, 徽章)
• 为什么我无法批量下载多个文件？
• 为什么我的提交页面没有语言可选？
• The 'yarn global' commands have been remove in 2.x - consider using 'yarn dlx' or a third-party plugin instead
• 我是机房用户，大量用户同 IP 操作触发了频率限制，怎么解决？

1.2 [半官方]Hydro常见题型的制做心得(by laomai)

• 零. hydro题目存储格式
• 一 制做最简单的OJ题目
• 二、函数交互型题目
• 三,半对拍-自己指定评测程序并修改测试输出格式
• 五.文件读写测试
• 六,子任务测试.
• 七,客观题制做
• 八.小结

2. FAQ#2: https://hydro.ac/d/faqs/p/

• P1 坏脾气的在线评测系统——OJ是什么？

• P2 如何修改网站图标？

• P3 我应该如何在域之间复制题目？

• P4 Hydro 目前导入 SYZOJ/SYZOJ-NG 题目方法

• P5 如何贡献文档

• P6 如何配置测试数据

• P7 Markdown & LaTeX 完全指南

• P8 如何正确地在 HydroOJ 出题

• P9 文件存储 （ MinIO / COS / OSS ） 配置指南

• P10 如何连接 Hydro 的数据库

• P11 想要创建一个属于自己的OJ吗？

• P12 自部署 Hydro 如果遇到问题该如何上报？

• P13 Hydro Judge - Vjudge 正确食用方法

• P14 添加插件后 favicon 未更新该如何处理?

• P15 在沙箱中引入 Python 包

• P16 如何限制同一账号多端登录？

• P17 如何卸载 Hydro

• P18 NodeJS >= xx required 报错如何处理？

• P19 如何为题目配置 hack

• P20 Your sandbox version is tooooooo low!

3. 测试题域: https://hydro.ac/d/system_test/p/

• P1 函数交互测试
• P2 输入测试
• P3 输出测试
• P4 客观题测试
• P5 交互题（IO通信）测试
• P6 文件 IO 测试
• P7 子任务测试
• P8 Special Judge 测试
• P9 题面测试
• P10 C++ Benchmark
• P11 Python With Error Trace
• P12 提交答案题测试（SPJ）
• P13 提交答案题测试（无SPJ）
• P14 函数题 (Leetcode 风格)
• P15 Hack 测试
• P16 Python3 Turtle
• P17 Quine
• P18 C Turtle
• P19 SQL test

4.OJ 使用帮助: https://hydro.ac/wiki/help

• 域
• 编译器版本及参数
• 限制
• 输入输出
• 评测状态
• 编译错误
• 训练
• 比赛
• 通过率
• RP 算法
• 难度算法
• 测试数据集格式
• 忘记密码和/或用户名
• Markdown

题库相关

HydroOJ 自带了很多题库支持, 包括免费 / 付费题库(含数据), 免费 / 付费远程评测, 其他 OJ 到 HydroOJ 的平台迁移, 题库迁移等等.

（免费rmj）一本通启蒙篇v2.0 (适用于4.9.17 ~ 4.9.27, 修正了公式格式错误, QQ 群下载, 一定要阅读压缩包内说明!)

qq群的群文件有搜索功能, 压缩文件名是一本通编程启蒙题库v2【见压缩包内导入说明】.zip 直接搜索下载就行.

安装过程群里太多人问, 我把说明贴在这, 好好阅读, 有事没事多重启, 省得在群里浪费时间, 还要被骂 hhh

---

这是 Hydro 格式的《一本通编程启蒙》题库。此功能承诺永久免费开放使用。详情可加群 1085853538 了解。
如果使用题目包过程中遇到任何问题，也可加群反馈。
https://docs.hydro.ac

导入说明

1. 升级 hydrooj 至最新版本（v4.9.17 ~ 4.9.27，更新说明 https://docs.hydro.ac/FAQ/#更新升级 ）。
2. 使用 hydrooj install https://hydro.ac/hydroac-client-0.0.1.tgz 安装相关模块。
3. 重启 hydrooj 。
4. 使用 【从 Hydro 导入】功能导入该题库。
5. 重启 hydrooj 。

至此，题目已经可以正常提交了。

注：此功能不使用 ssoier 提供的评测接口，无需申请教师账号，可直接使用。

（免费rmj）一本通启蒙插件(v3) by HydroOJ (>=4.10.1)

• 安装:

  hydrooj install https://hydro.ac/hydroac-client.zip
  

• 如果一直waiting, 可以试试执行:

  hydrooj cli system set hydroac-client.remotejudge-endpoint https://ws.hydrooj.com
  

• 系统更新之后, 本插件需要同步更新

• 压缩包地址: QQ 群(1085853538)文件

• 注意仔细压缩包内的阅读安装说明, 有问题就多重启几次

（免费rmj）BZOJ 远程评测插件 by 小蛐蛐

• 项目地址: Hydro4LVJ
• 安装: hydrooj install https://img.zshfoj.com/Plugins/judge-client-bzoj.zip
• 压缩包地址: QQ 群(1085853538)文件
• 注意仔细压缩包内的阅读安装说明, 有问题就多重启几次

（免费rmj）洛谷深入浅出程序设计竞赛 - 基础篇(>=4.10.2)

• 压缩包地址: QQ 群(1085853538)文件
• 注意仔细压缩包内的阅读安装说明, 有问题就多重启几次
• 注：此功能由洛谷提供数据支持，题目来自洛谷编写教材《深入浅出程序设计竞赛 - 基础篇》，并带有详细的教程和讲解，点击下列链接了解本书详情。
  【官方网店绝赞热卖中！】>>>(https://item.taobao.com/item.htm?id=637730514783)

免费 / 付费题库下载(0.5 元一道题, 自造数据): https://hydro.ac/d/tk/

几大板块: 免费专区 CCF真题 USACO题库 一本通题库 蓝桥杯

注意, 免费区题目大多测试数据规模较小或是缺少测试数据。

自带的 vjudge 插件自动爬题目+远程评测: https://hydro.ac/d/faqs/p/13

• 自带插件(vjudge)使用说明: https://docs.hydro.ac/plugins/
• 目前(2023.12)支持的远程评测: Codeforces, Luogu(收费, 见下面), POJ, SPOJ, UOJ

洛谷付费远程评测服务: https://docs.lgapi.cn/open/project/hydro

kkk 倾情代言, 1500元 / 季度, 支持 P 系列和 B 系列题库, 更新及时 可以 py 交易, 童叟无欺!

群内有一些免费题库包

如一本通提高篇等, 或者找群友交流