Nginx Proxy Manager 日志分析与监控方案

一、日志文件位置与类型

Nginx Proxy Manager (NPM) 主要产生以下几类日志：

1. 访问日志：位于 /data/logs/proxy_host-*.log
2. 错误日志：位于 /data/logs/error.log
3. NPM应用日志：位于 /data/logs/manager.log
4. Let's Encrypt证书日志：位于 /data/logs/letsencrypt.log

二、基础日志分析方法

1. 实时查看日志

# 查看实时访问日志
tail -f /data/logs/proxy_host-*.log

# 查看错误日志
tail -f /data/logs/error.log

2. 常用日志分析命令

# 统计HTTP状态码
grep -o '" [0-9][0-9][0-9] ' /data/logs/proxy_host-*.log | sort | uniq -c | sort -rn

# 统计访问量最高的IP
awk '{print $1}' /data/logs/proxy_host-*.log | sort | uniq -c | sort -rn | head -20

# 统计访问量最高的URL
awk -F\" '{print $2}' /data/logs/proxy_host-*.log | awk '{print $2}' | sort | uniq -c | sort -rn | head -20

# 查找错误请求
grep -E ' 50[0-9] ' /data/logs/proxy_host-*.log

三、高级监控方案

1. 使用ELK Stack (Elasticsearch, Logstash, Kibana)

配置步骤： 1. 安装ELK Stack 2. 配置Logstash处理NPM日志：

input {
  file {
    path => "/data/logs/proxy_host-*.log"
    type => "nginx-access"
  }
  file {
    path => "/data/logs/error.log"
    type => "nginx-error"
  }
}

filter {
  if [type] == "nginx-access" {
    grok {
      match => { "message" => "%{IPORHOST:remote_ip} - %{DATA:user_name} \[%{HTTPDATE:access_time}\] \"%{WORD:http_method} %{DATA:url} HTTP/%{NUMBER:http_version}\" %{NUMBER:response_code} %{NUMBER:body_sent_bytes} \"%{DATA:referrer}\" \"%{DATA:user_agent}\"" }
    }
    date {
      match => [ "access_time", "dd/MMM/YYYY:HH:mm:ss Z" ]
    }
  }
}

output {
  elasticsearch {
    hosts => ["localhost:9200"]
    index => "nginx-logs-%{+YYYY.MM.dd}"
  }
}

2. 使用Prometheus + Grafana

配置步骤： 1. 安装Prometheus和Grafana 2. 使用nginx_exporter或prometheus-nginx-exporter收集指标 3. 导入Nginx Grafana仪表板（如ID 12708）

3. 使用GoAccess实时分析

# 安装GoAccess
apt-get install goaccess

# 生成HTML报告
goaccess /data/logs/proxy_host-*.log -o /path/to/report.html --log-format=COMBINED

四、常见问题排查

1. 502 Bad Gateway

检查： - 后端服务是否运行 - NPM到后端服务的网络连接 - 后端服务是否响应超时

2. 证书续签失败

检查： - /data/logs/letsencrypt.log中的错误信息 - 域名解析是否正确 - 防火墙是否阻止ACME挑战请求

3. 高流量导致性能问题

解决方案： - 启用NPM的缓存功能 - 调整client_max_body_size等参数 - 考虑升级服务器资源

五、日志轮转配置

在Docker环境中，可以通过修改docker-compose.yml添加日志轮转：

services:
  app:
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

六、最佳实践建议

1. 定期归档日志：设置日志轮转策略，避免日志文件过大
2. 敏感信息过滤：确保日志中不记录敏感数据如密码、API密钥
3. 监控关键指标：关注错误率、响应时间、流量突增等
4. 设置告警：对异常状态码、错误率突增等情况设置告警

通过以上方案，您可以全面监控和分析Nginx Proxy Manager的运行状态，及时发现并解决问题。