AdGuardHome日志文件异常增长问题分析与解决方案

问题背景

在AdGuardHome v0.107.50版本中，部分Linux ARM64用户报告了一个严重的日志管理问题。系统日志文件AdguardHome.err会异常增长，在24小时内可达1.5GB，极端情况下甚至达到66GB。这种异常增长不仅占用大量存储空间，还会导致CPU使用率飙升至80-100%，严重影响设备性能，特别是资源有限的树莓派设备。

问题根源分析

经过技术团队深入调查，发现问题主要源于AdGuardHome的systemd服务脚本配置。当前实现中：

1. 标准输出(stdout)和标准错误(stderr)被分别重定向到/var/log/AdGuardHome.log和/var/log/AdGuardHome.err文件
2. 缺乏有效的日志轮转机制，导致日志文件持续增长
3. 在某些网络环境下，频繁的错误日志记录会加速文件增长

临时解决方案

在官方修复发布前，用户可采用以下临时解决方案：

1. 手动清理：定期停止服务，删除日志文件后重启
2. 符号链接到/dev/null：将日志文件重定向到空设备

   ln -sf /dev/null /var/log/AdGuardHome.err
   ln -sf /dev/null /var/log/AdGuardHome.log
   

3. 配置日志轮转：在AdGuardHome的配置文件中添加日志管理设置

   log:
     file: /var/log/AdGuardHome.log
     max_backups: 3
     max_size: 100  # MB
     max_age: 3     # days
     compress: false
     local_time: true
     verbose: false
   

官方修复方案

技术团队已确定更优的解决方案，将采用systemd的journal日志系统替代直接文件输出：

1. 修改systemd服务文件，移除预执行命令
2. 将StandardOutput和StandardError设置为journal
3. 日志将由journald服务统一管理，支持系统级的日志轮转和压缩

用户可手动应用此修复：

# 停止服务
systemctl stop AdGuardHome.service

# 编辑服务文件
nano /etc/systemd/system/AdGuardHome.service

# 修改以下内容：
# 移除ExecStartPre=行
# 将StandardOutput=file:/var/log/AdGuardHome.out改为StandardOutput=journal
# 将StandardError=file:/var/log/AdGuardHome.out改为StandardError=journal

# 重新加载并启动服务
systemctl daemon-reload
systemctl start AdGuardHome.service

未来改进方向

基于用户反馈，技术团队正在考虑以下增强功能：

1. 增加配置选项完全禁用日志记录
2. 提供更细粒度的日志级别控制
3. 优化错误日志记录策略，减少非关键错误的记录频率

最佳实践建议

对于生产环境部署，建议：

1. 定期监控日志文件大小
2. 为journald配置合理的存储限制
3. 对于资源受限设备，考虑禁用非必要日志
4. 保持AdGuardHome更新至最新版本

此问题的修复版本已包含在AdGuardHome的edge版本中，正式版本发布后建议所有用户及时更新以获得更稳定的日志管理体验。