Hydro Cli

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>