Skip to main content

插件


插件

Hydro 支持使用插件扩展自身所支持的功能。

Warning

插件对站点的所有内容具有完全的访问权限,请不要启用来历不明的插件。

附加组件列表

Tips

使用安装脚本安装时会自动安装下方加粗的插件。 部分插件(斜体标注)需配合第三方软件使用,如仅安装不配置/不安装第三方软件会导致系统无法正常运行,详情请前往左侧插件详情查看。

Hydro 官方目前提供了以下附加组件:

ID描述
@hydrooj/a11y一些小功能
@hydrooj/onsite-toolkit现场赛工具包
@hydrooj/blog博客功能
@hydrooj/fps-importer导入 fps 格式的题目
@hydrooj/geoip显示用户登录地(需要IP库支持)
@hydrooj/hydrojudge评测组件
@hydrooj/import-qduoj导入 QDUOJ 导出的题库
@hydrooj/import-hoj导入 HOJ 导出的题库
@hydrooj/login-with-github允许用户使用 GitHub 登录
@hydrooj/login-with-google允许用户使用 Google 登录
@hydrooj/migrate从 vijos4/HustOJ/SYZOJ/UniversalOJ 升级
@hydrooj/recaptcha注册时启用 reCAPTCHA 验证码
@hydrooj/ui-defaultHydro 的默认用户界面
@hydrooj/onlyoffice显示 doc/docx 格式题目
@hydrooj/sonic基于 sonic 的题目搜索增强(需安装 sonic)
@hydrooj/elastic-search基于 Elastic 的题目搜索增强(需安装 Elastic)
@hydrooj/vjudgeCodeforces/SPOJ/UOJ/POJ
@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