Hydro 系统配置修改与反向代理问题排查指南

问题背景

在使用 Hydro 在线评测系统时，有时会遇到因配置错误导致无法通过 Web 界面登录的情况。这种情况通常发生在反向代理配置不当或系统设置被错误修改后。本文将详细介绍如何通过命令行修改系统配置，以及排查反向代理相关问题的完整流程。

命令行修改系统配置

当 Web 界面无法访问时，可以通过服务器终端直接修改系统配置：

1. 查看当前系统配置
   使用 hydrooj cli system get 命令可以查看当前的所有系统设置项及其值。

2. 修改特定配置项
   使用 hydrooj cli system set <key> <value> 命令可以修改指定的系统配置。例如，要修改反向代理相关的配置，可以执行：

   hydrooj cli system set reverseProxy true
   

3. 重启服务生效
   修改配置后，需要重启 Hydro 服务使更改生效：

   pm2 restart hydrooj
   

反向代理问题排查

当遇到反向代理配置导致无法登录的问题时，可以按照以下步骤排查：

1. 检查 Caddy 配置
   确保 Caddy 配置文件与官方文档要求一致，特别注意以下几点：

   • 是否正确配置了代理路径
   • 是否启用了必要的 HTTP 头
   • SSL 证书配置是否正确

2. 禁用自定义插件
   有时插件冲突会导致反向代理问题，可以尝试临时禁用所有自定义插件：

   hydrooj cli plugin disable <插件名>
   

3. 清除浏览器缓存
   很多登录问题实际上是浏览器缓存导致的，尝试以下操作：

   • 清除浏览器缓存和 Cookie
   • 使用隐身模式访问
   • 尝试不同的浏览器

4. 检查服务状态
   使用 PM2 检查服务运行状态：

   pm2 list
   

   如果服务异常，可以尝试重启：

   pm2 restart all
   

常见问题解决方案

1. 登录状态不保持
   这通常是由于会话配置或跨域问题导致的，检查：

   • 确保 session 相关配置正确
   • 检查域名配置是否一致
   • 验证 Cookie 设置是否正确

2. 安装脚本卡死
   如果安装脚本运行异常：

   • 检查服务器资源使用情况
   • 查看日志文件获取详细错误信息
   • 尝试手动执行安装步骤

3. 无效响应错误
   当出现"发送无效的响应"时：

   • 检查后端服务是否正常运行
   • 验证反向代理配置是否正确传递了所有必要参数
   • 查看服务日志定位具体问题

最佳实践建议

1. 修改配置前备份
   在修改任何系统配置前，建议先备份当前配置：

   hydrooj cli system get > system_backup.json
   

2. 逐步验证更改
   每次只修改一个配置项，并立即验证是否解决问题，便于定位问题源头。

3. 监控日志文件
   实时监控日志可以帮助快速发现问题：

   tail -f /var/log/hydrooj.log
   

4. 保持系统更新
   定期更新 Hydro 系统可以避免许多已知问题：

   git pull
   npm install
   pm2 restart hydrooj
   

通过以上方法和步骤，大多数因配置错误导致的反向代理和登录问题都可以得到有效解决。如果问题仍然存在，建议收集详细的日志信息以便进一步分析。