WGDashboard 日志目录位置修改指南

日志系统架构解析

WGDashboard 作为一款网络管理面板，其日志系统采用了多层次的记录机制。系统主要包含三类日志文件：

1. Gunicorn 服务日志：包括访问日志(access.log)和错误日志(error.log)，记录Web服务的运行状态
2. 安装日志：install.txt 文件记录安装过程中的详细信息
3. 应用日志：记录用户操作和系统事件

默认日志存储位置

默认情况下，WGDashboard 将日志存储在项目根目录下的 log/ 文件夹中，这种设计虽然简单，但在生产环境中可能存在以下不足：

• 不符合 Linux 系统的日志管理规范
• 不利于使用系统级的日志轮转工具
• 可能因权限问题导致日志写入失败

修改日志目录位置的方法

1. 修改 Gunicorn 日志路径

Gunicorn 的日志配置位于 gunicorn.conf.py 文件中，需要修改以下两个参数：

accesslog = "/var/log/wgdashboard/access.log"  # 访问日志路径
errorlog = "/var/log/wgdashboard/error.log"    # 错误日志路径

2. 修改安装日志路径

安装日志的路径定义在 wgd.sh 脚本中，搜索 install.txt 可以找到相关配置行，修改为：

log_file="/var/log/wgdashboard/install.txt"

3. 创建日志目录并设置权限

执行以下命令创建日志目录并设置适当权限：

sudo mkdir -p /var/log/wgdashboard
sudo chown -R www-data:www-data /var/log/wgdashboard
sudo chmod -R 755 /var/log/wgdashboard

日志轮转配置建议

修改日志位置到 /var/log 后，可以方便地使用 logrotate 进行日志管理。以下是推荐的 logrotate 配置示例：

/var/log/wgdashboard/*.log {
    daily
    missingok
    rotate 7
    compress
    delaycompress
    notifempty
    create 0640 www-data www-data
    sharedscripts
    postrotate
        systemctl reload wgdashboard > /dev/null
    endscript
}

最佳实践建议

1. 权限管理：确保Web服务用户(通常是www-data)对日志目录有写入权限
2. 磁盘空间监控：设置日志大小限制，避免日志文件占用过多磁盘空间
3. 日志分级：考虑将不同级别的日志分开存储，便于问题排查
4. 备份策略：重要的操作日志建议定期备份到其他存储介质

通过以上配置，WGDashboard 的日志系统将更加规范，便于维护和故障排查，同时也符合Linux系统的日志管理惯例。