Skip to content

Commit 058d1c0

Browse files
authored
update hydrojudge doc & fix dead links (#71)
1 parent a73143d commit 058d1c0

File tree

10 files changed

+43
-22
lines changed

10 files changed

+43
-22
lines changed

content/docs/Hydro/FAQ/debug.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ title: 排障指南
99
检查各个进程是否已经启动( status 为 online 且 uptime 至少一分钟)
1010

1111
如果 caddy 无法启动,通常是端口被占用或 `~/.hydro/Caddyfile` 配置错误,可尝试 `cd ~/.hydro && caddy run` 查看详情。
12-
如果 hydro-sandbox 无法启动,通常是权限不足 / 内核版本过低,使用 `pm2 logs hydro-sandbox --lines 100` 查看详情。
12+
如果 hydro-sandbox 无法启动,通常是权限不足 / 内核版本过低,使用 `pm2 logs hydro-sandbox --lines 100` 查看详情。
1313
如果 hydrooj 无法启动 / 启动后没有正常运行,请看下方章节。
1414

1515
## hydrooj

content/docs/Hydro/FAQ/index.mdx

+5-5
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ title: 常见问题集合
44

55
## 好消息!本页和各大浏览器均达成了合作,使用 Ctrl-F 即可快速搜索关键词!
66

7-
## 更多教程请点击右上角的常用教程查看
7+
## 更多教程请点击[常用教程](https://hydro.ac/d/faqs/p)查看
88

99
## 用户QQ群 1085853538
1010

@@ -45,7 +45,7 @@ title: 常见问题集合
4545

4646
## 为什么我配置完反向代理(caddy/nginx)之后无法登录(出现CsrfTokenError)?
4747

48-
反向代理时请确保设置了正确的 Host Header。[详细说明](/docs/install/proxy.md)
48+
反向代理时请确保设置了正确的 Host Header。[详细说明](./install/proxy.md)
4949

5050
## 怎么备份/还原备份/迁移数据?
5151

@@ -59,7 +59,7 @@ title: 常见问题集合
5959

6060
## 更新升级
6161

62-
[升级指南](/FAQ/upgrade.md)
62+
[升级指南](./FAQ/upgrade)
6363

6464
## 怎么导入题目/创建题目?
6565

@@ -107,7 +107,7 @@ cd `yarn global dir` && rm -rf node_modules yarn.lock && yarn install
107107
## 我想让 Python 支持 numpy 等等库,怎么办?
108108

109109
如果你是 2022/8/12 日前安装,使用 `pip3 install numpy``pm2 restart hydro-sandbox`
110-
否则参照请参照 [编译器](/docs/install/compiler) 章节。
110+
否则参照请参照 [编译器](./install/compiler) 章节。
111111

112112
## 使用安装脚本后忘记 MongoDB 的账号密码怎么办?
113113

@@ -177,7 +177,7 @@ cd `yarn global dir` && rm -rf node_modules yarn.lock && yarn install
177177
不要钱,我们是 AGPL 的。如果你钱多,可以 [给我发个红包](https://pay.undefined.moe)
178178

179179
## execve: no such file or directory
180-
脚本安装默认只装了一小部分编译器。请参照 [编译器](/docs/install/compiler) 章节安装配置其他编译器。
180+
脚本安装默认只装了一小部分编译器。请参照 [编译器](./install/compiler) 章节安装配置其他编译器。
181181

182182
## 怎么自定义用户标签?
183183

content/docs/Hydro/dev/PERM_PRIV.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,4 @@ Hydro 的权限使用位运算处理。
77

88
可以看 [代码](https://github.com/hydro-dev/Hydro/blob/master/packages/hydrooj/src/model/builtin.ts) 中关于此部分的内容。
99

10-
扩展阅读:[权限结构](/docs/user/permission)
10+
扩展阅读:[权限结构](../user/permission)

content/docs/Hydro/dev/frontend-modify.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,4 @@
22
title: 前端修改
33
---
44

5-
参考 [前端修改](/docs/system/frontend-modify/)
5+
参考 [前端修改](../system/frontend-modify/)

content/docs/Hydro/dev/index.mdx

+2-2
Original file line numberDiff line numberDiff line change
@@ -40,8 +40,8 @@ title: 开发环境部署
4040
- 系统要求:Hydro开发环境目前仅支持 Linux 系统,如您使用 Windows 请使用 WSL2 。
4141
- MongoDB:Hydro 需要 [MongoDB](https://www.mongodb.com/try/download/community) 提供数据库服务。
4242
- NodeJS:请安装 NodeJS >=18 版本。(若使用 apt 请使用 nodesource 提供的源替代官方源) (推荐使用 nix ,可通过`. <(curl https://hydro.ac/nix.sh)` 快速安装)
43-
- yarn:安装 yarn 前请先完成 NodeJS 安装。 `nix-env -iA nixpkgs.yarn``npm install -g yarn`
44-
- 若需要使用 hydrojudge 请参照 hydrojudge 插件说明部分完成沙箱的安装配置
43+
- yarn:安装 `yarn` 前请先完成 NodeJS 安装。 `nix-env -iA nixpkgs.yarn``npm install -g yarn`
44+
- 若需要使用 `hydrojudge` 请参照 [hydrojudge 插件说明](./plugins/hydrojudge) 部分完成沙箱的安装配置
4545

4646
## 安装 Hydro
4747

content/docs/Hydro/index.mdx

+3-3
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@ description: 为什么使用 Hydro?
1111
- 易上手:无需改动源代码,系统设置中预留了大量可自行修改的内容;管理逻辑简洁;
1212
- 社区:Hydro 正在持续维护中;
1313

14-
- 如果您正在使用 HustOJ,可以导出题目为 FPS 文件后使用 [fps-importer 插件](/plugins/fps-importer) 直接导入 Hydro。
14+
- 如果您正在使用 HustOJ,可以导出题目为 FPS 文件后使用 [fps-importer 插件](/docs/Hydro/plugins/fps-importer) 直接导入 Hydro。
1515
- 如果您正在使用 QDUOJ, 可以导出题目为 QDUOJ-zip 格式后使用 import-qduoj 插件直接导入 Hydro。
16-
- 如果您正在使用 Vijos / SYZOJ / HustOJ / UniversalOJ, 可以直接使用 [migrate 插件](/plugins/migrate) 导入所有数据至 Hydro。
16+
- 如果您正在使用 Vijos / SYZOJ / HustOJ / UniversalOJ, 可以直接使用 [migrate 插件](/docs/Hydro/plugins/migrate) 导入所有数据至 Hydro。
1717

1818
## 功能对比
1919

@@ -71,7 +71,7 @@ Hydro 支持很多其他系统无法支持的题型,可在 https://hydro.ac/d/
7171

7272
## 现在开始
7373

74-
点击 [部署](/docs/install/) ,开始部署您的 OJ 吧!
74+
点击 [部署](/docs/Hydro/install/) ,开始部署您的 OJ 吧!
7575

7676

7777
<Cards>

content/docs/Hydro/install/compiler.mdx

+5
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,11 @@ javac -d /w -encoding utf8 ./Main.java && jar cvf Main.jar *.class
4949
请调整系统设置中对应语言选项下的 `compile_time_limit` 项(单位 ms)。
5050
</Callout>
5151

52+
<Callout>
53+
在使用 `sh nix-env -iA nixpkgs.python3Packages.xxxxx` 安装 `pyhton` 包后,如果在沙箱环境中无法找到依赖。
54+
请参照 [在沙箱中引入 Python 包](https://hydro.ac/d/faqs/p/15) 教程更新环境变量。
55+
</Callout>
56+
5257
## 进阶
5358

5459
如果你需要更加复杂的编译环境配置,我们建议使用编写单独的 nix 文件。

content/docs/Hydro/plugins/hydrojudge.mdx

+21-5
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,15 @@ title: hydrojudge
33
---
44

55
<Callout>
6-
您可以通过一键安装脚本快速安装独立评测机,详情请前往 [部署Hydro](/docs/install/#部署) 查看。
6+
您可以通过一键安装脚本快速安装独立评测机,详情请前往 [部署Hydro](../install/#部署) 查看。
77
</Callout>
88

99
## 准备
1010

1111
在配置评测机之前,请确认您的站点已经可以访问并正常登录/注册。
1212

1313
您应该预先下载您所要支持的语言的编译器,若您在配置完评测机后 升级/重新安装 了编译器,您需要重新启动沙箱。
14-
关于编译器说明,请参照 [编译器](/docs/install/compiler) 章节。
14+
关于编译器说明,请参照 [编译器](../install/compiler) 章节。
1515

1616
如果不使用自动脚本,您需要按照如下方式手动安装沙箱服务:
1717
前往 [criyle/go-judge](https://github.com/criyle/go-judge/releases) 下载对应 cpu 架构的 go-judge。
@@ -41,7 +41,7 @@ hydrooj addon add @hydrooj/hydrojudge
4141
该方法可以帮助您在任意服务器上部署评测机。
4242
</Callout>
4343

44-
首先需要创建一个有 PRIV_JUDGE 权限的账户,具体方法参照 [此处](/docs/system/cli/#创建评测账号)。(在部署 Hydro 的服务器上运行)
44+
首先需要创建一个有 PRIV_JUDGE 权限的账户,具体方法参照 [此处](../system/cli/#创建评测账号)。(在部署 Hydro 的服务器上运行)
4545

4646
然后在运行评测机的服务器上安装 HydroJudge :
4747

@@ -122,7 +122,7 @@ parallelism: 2 # 单评测机评测进程数量
122122

123123
## 测试数据格式
124124

125-
参照 [测试数据格式](/docs/user/problem/#测试数据格式) 配置。
125+
参照 [测试数据格式](../user/problem/#测试数据格式) 配置。
126126

127127
## 调整沙箱空间大小
128128

@@ -137,7 +137,8 @@ parallelism: 2 # 单评测机评测进程数量
137137
pm2 info hydro-sandbox | grep "exec cwd"
138138
```
139139

140-
[mount.yaml](https://github.com/criyle/go-judge/blob/master/mount.yaml) 下载并放置在 sandbox 的运行目录下。然后修改第 64 行和第 68 行的 `size``nr_inodes` 的大小至您想要的大小,保存后重启 sandbox 即可完成更改。
140+
参照 [沙箱文件系统挂载文档](https://docs.goj.ac/cn/mount#自定义挂载) 中的自定义挂载的配置,保存配置内容到运行目录并命名为 `mount.yaml`
141+
修改配置文件中 `work dir``tmp dir` 所对应 `size``nr_inodes` 的挂载参数至您想要的大小,保存后重启 `hydro-sandbox` 即可完成更改。
141142

142143
对于 2022/8/12 后安装的用户:
143144

@@ -203,3 +204,18 @@ GRUB_CMDLINE_LINUX_DEFAULT="quiet splash cgroup_enable=memory swapaccount=1 syst
203204
```sh
204205
update-grub && reboot
205206
```
207+
208+
## 内存控制器未开启
209+
210+
在控制面板上出现内容为 `The memory cgroup controller is not enabled. This could result in inaccurate memory usage measurements.` 警告时,意味着当前系统并没有开启内存 cgroup 控制器。
211+
212+
部分 Linux (如 Raspbian) 并不会默认开启内存 cgroup 控制器,启用内存控制器可以获得更精确的内存限制和计量。
213+
214+
以 Raspbian 为例,编辑 `/boot/firmware/cmdline.txt` (如果不存在则 `/boot/cmdline.txt`):
215+
在末尾添加(注意空格)
216+
217+
```
218+
cgroup_enable=memory cgroup_memory=1
219+
```
220+
221+
重启之后检查 `/proc/cgroups` 确认内存控制器 `memory` 已开启。

content/docs/Hydro/system/cli.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ hydrooj cli user setSuperAdmin 2
4444
hydrooj cli user setPriv <uid> <priv>
4545
```
4646

47-
关于参数 `[priv]` ,可阅读 [此处](/dev/PERM_PRIV/)
47+
关于参数 `[priv]` ,可阅读 [此处](../dev/PERM_PRIV/)
4848

4949
## 更改用户密码
5050

content/docs/Hydro/user/problem.mdx

+3-3
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ title: 题目
1111
题目 ID 不能全为数字。若留空则使用自动分配的数字题号。
1212
</Callout>
1313

14-
详见下方题面编辑部分,以及 [laomai 编写的说明](./problem-create.md)
14+
详见下方题面编辑部分,以及 [laomai 编写的说明](./problem-create)
1515

1616
## 导入题目
1717

@@ -32,7 +32,7 @@ Hydro 提供了一个小工具 [loj-download](https://github.com/hydro-dev/loj-d
3232

3333
### 从 FPS 文件导入
3434

35-
见插件 [fps-importer](/plugins/fps-importer/)
35+
见插件 [fps-importer](../plugins/fps-importer/)
3636

3737
### 从 QDUOJ 导入
3838

@@ -100,7 +100,7 @@ Hydro 提供了一个小工具 [loj-download](https://github.com/hydro-dev/loj-d
100100
## 文件
101101

102102
您可以在题目右侧“文件”面板上传测试数据和附加文件。(支持拖拽文件至相应位置进行上传)
103-
[测试数据格式](/docs/user/testdata)
103+
[测试数据格式](../user/testdata)
104104

105105
## 客观题
106106

0 commit comments

Comments
 (0)