如何使用 AWStats 生成 Nginx 网站流量统计报告-Nginx-PHP中文网

awstats需nginx日志格式匹配（如log_format awstats含$remote_addr、$time_local等字段）且配置中指定正确logfile路径、logformat=1，再通过awstats.pl -update生成报告并配合cron每日自动更新。

如何使用 awstats 生成 nginx 网站流量统计报告

AWStats 是一款开源的网站日志分析工具，支持 Nginx 日志解析并生成直观的流量统计报告（如访问量、IP 分布、热门页面、搜索引擎关键词等）。要让它正确工作，关键在于：Nginx 日志格式需匹配 AWStats 解析规则，且 AWStats 配置需指向正确的日志路径与时间范围。

1. 确保 Nginx 日志格式兼容 AWStats

AWStats 默认识别 Apache 的 Common Log Format（CLF），而 Nginx 默认日志格式接近但不完全一致。推荐在 /etc/nginx/nginx.conf 或站点配置中显式定义兼容格式：

log_format awstats '$remote_addr - $remote_user [$time_local] '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent" '
                    '$request_time $upstream_response_time';

然后在 server 块中使用该格式记录访问日志：

access_log /var/log/nginx/example.com.access.log awstats;

⚠️ 注意：不要包含 $http_x_forwarded_for 或其他非标准字段（除非你自定义 AWStats 配置解析）；时间格式必须为 [28/Jan/2024:10:22:34 +0800] 这类，即 log_format 中的 $time_local 已满足。

2. 安装并配置 AWStats

以 Ubuntu/Debian 为例：

安装 AWStats：sudo apt install awstats
生成对应站点的配置文件：sudo cp /etc/awstats/awstats.conf /etc/awstats/awstats.example.com.conf
编辑新配置文件：sudo nano /etc/awstats/awstats.example.com.conf

重点修改以下参数：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

LogFile="/var/log/nginx/example.com.access.log"
LogType=W
LogFormat=1
SiteDomain="example.com"
HostAliases="example.com www.example.com"
DNSLookup=1
DirData="/var/lib/awstats"
DirCgi="/usr/lib/cgi-bin"
DirIcons="/icons"

✅ LogFormat=1 表示使用标准 CLF 格式（与上面定义的 awstats log_format 兼容）；若你添加了请求耗时等扩展字段，需改为 LogFormat=4 并手动调整 LogSeparator 和字段映射。

3. 生成首次统计并验证结果

运行命令构建初始数据库：

sudo /usr/lib/cgi-bin/awstats.pl -config=example.com -update

成功后会显示类似 Processed records: 12482。若报错，常见原因有：

权限问题：确保 AWStats 进程可读取日志文件（如 sudo chmod 644 /var/log/nginx/*.log 或将 www-data 加入 adm 组）
日志为空或路径错误：用 head -5 /var/log/nginx/example.com.access.log 检查格式是否符合预期
时区不一致：AWStats 默认按服务器本地时间解析，若日志时间含时区（如 +0800），无需额外设置；否则可在配置中加 TimeZone=8

4. 配置 Web 访问与自动更新

启用 CGI 支持（Nginx 需配合 fcgiwrap）或改用 Apache 提供 CGI 服务更简单。若坚持用 Nginx：

安装 fcgiwrap，配置 Nginx 将 /awstats/ 路径转发给 fcgiwrap
在 /usr/lib/cgi-bin/ 下创建软链接：sudo ln -s /etc/awstats/awstats.example.com.conf awstats.example.com.conf
浏览器访问 http://your-server/awstats/awstats.pl?config=example.com

自动每日更新（推荐用 cron）：

0 2 * * * /usr/lib/cgi-bin/awstats.pl -config=example.com -update >/dev/null

这样每天凌晨 2 点刷新统计，报告实时性足够一般运营需求。