UnifiOS实用工具中AdGuardHome磁盘空间管理指南

问题背景

在UnifiOS实用工具环境中运行AdGuardHome时，用户可能会遇到磁盘空间被大量占用的情况。这通常表现为Unifi Network应用服务无法正常启动，系统日志显示服务长时间处于"activating (start)"状态。通过排查发现，AdGuardHome的查询日志文件(querylog.json)会持续增长，单个文件可能达到2.5GB以上，最终导致系统存储空间耗尽。

问题根源

AdGuardHome默认会记录所有DNS查询日志，这些日志包含：

1. 原始查询记录(querylog.json)
2. 历史日志备份(querylog.json.1)
3. 会话数据(sessions.db)
4. 统计数据库(stats.db)

其中查询日志文件会随时间不断累积，如果不加以限制，可能占用数GB的磁盘空间，特别是在网络设备较多或查询量大的环境中。

解决方案

1. 调整日志保留周期

通过AdGuardHome管理界面进行配置：

1. 登录AdGuardHome Web控制台
2. 进入"设置"→"常规设置"
3. 找到"查询日志保留"选项
4. 将保留时间调整为合理值（如24小时）

2. 定期维护建议

对于已部署的系统，建议采取以下维护措施：

1. 定期检查/data/custom/machines/debian-custom/opt/AdGuardHome/data/目录
2. 手动删除过期的日志备份文件（如querylog.json.1）
3. 考虑设置定时任务自动清理旧日志

3. 高级配置选项

对于技术熟练的用户，还可以通过修改AdGuardHome配置文件实现更精细的控制：

1. 日志轮转策略
2. 日志压缩设置
3. 按类型过滤日志记录

预防措施

为避免类似问题再次发生，建议：

1. 部署监控系统，对关键目录进行磁盘空间监控
2. 在AdGuardHome安装完成后立即配置合理的日志保留策略
3. 定期检查系统服务状态和存储使用情况

总结

在UnifiOS环境中使用AdGuardHome时，合理的日志管理是保证系统稳定运行的关键。通过适当的配置和定期维护，可以有效避免因日志膨胀导致的磁盘空间问题，确保网络服务持续可用。