Hydro Cli


# Hydro Cli

Tips

在使用 cli 之前,请完成数据库配置。
指令中使用 <> 括起来的参数必须给出,用 [] 括起来的参数可以给出,若不给出则按照默认设置。
用户请根据自己的情况替换掉用 <> 或是 [] 包括起来的部分(括号也应替换)

cli 可以帮助用户在控制台下快捷地进行一些操作。

下面给出了一些常用的例子。

# 创建用户

Tips

很少使用。建议通过 控制面板>导入用户 功能代替

hydrooj cli user create <mail> <username> <password>
# 该用户的邮箱、用户名和密码

# 如创建邮箱为 hydro@hydro.local,用户名为 Hydro,密码为 hydrohydro 的用户:
hydrooj cli user create hydro@hydro.local Hydro hydrohydro
1
2
3
4
5

若一切正常,运行该指令后您会从命令行窗口中看到该用户 uid。

# 设置全站管理员

hydrooj cli user setSuperAdmin <uid>

# 如设置 uid 为 2 的用户为管理员:
hydrooj cli user setSuperAdmin 2
1
2
3
4

# 设置用户权限

hydrooj cli user setPriv <uid> <priv>
1

关于参数 [priv] ,可阅读 此处

# 更改用户密码

hydrooj cli user setPassword <uid> <password>

# 如将 uid 为 1 的用户的密码改为 hydrohydro:
hydrooj cli user setPassword 1 hydrohydro
1
2
3
4

# 创建评测账号

先创建一个账号。

hydrooj cli user create <mail> <username> <password>
1

您需要留意运行此指令返回的数字,表示该用户的 uid,需要填入下面的指令中,然后给予该账号评测权限。

hydrooj cli user setJudge <uid>
1

完成后将配置的用户名及密码写入评测机配置文件,评测机即可连接到网页端。

# 黑名单相关

用户封禁:

hydrooj cli user setPriv <uid> 0
1

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> 移出黑名单
1
2
3
4

# 命令列表

所有于 此文件夹 下的函数均可用 cli 调用。

这里并没有列出所有可以运行的指令,因为其中很多功能我们更推荐通过 Web 访问。

hydrooj cli user create <mail> <uname> <password> [uid] [regip] [priv]
# 创建邮箱为 <mail>,用户名为 <uname>,密码为 <password>,ID 为 [uid],注册 ip 为 [regip],权限为 [priv] 的用户
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 system set <key> <value> # 修改系统设置 <key> 值为 <value>
1
2
3
4
5
6
7