openmicroscopy/awstats

Awstats Docker

![Build Status]([***]

镜像概述

本镜像用于在Docker环境中运行Awstats工具，生成Web服务器访问统计数据。统计生成功能与Web展示界面相互解耦，需将/var/lib/awstats目录作为持久化卷存储统计结果。

核心功能

• 解析Web日志文件生成多维度统计报告
• 提供Web界面可视化展示统计数据
• 自动跳过重复日志条目，支持增量更新
• 通过环境变量灵活自定义配置参数

使用场景

适用于网站管理员监控服务器访问流量、用户来源、设备类型等场景，帮助优化网站性能与内容策略。

配置说明

环境变量配置

若容器启动时/etc/awstats/awstats.SITE_DOMAIN.conf不存在，将自动生成默认配置，可通过以下环境变量调整：

• SITE_DOMAIN：站点域名（默认localhost），修改后需在Web界面URL添加config=域名参数（支持多域名统计）
• SKIP_USER_AGENTS：需过滤的用户代理列表（空格分隔，默认Travis Hudson）
• SKIP_HOSTS：需过滤的IP正则匹配（空格分隔，默认包含私有IP及Travis IP）
• SKIP_HOSTS_ADDITIONAL：额外过滤的IP正则（空格分隔，补充默认规则）
• LOG_FORMAT：日志格式（需引号时由调用者添加，如-e LOG_FORMAT=\"%h %l %u %t \\\"%r\\\" %s %b\"）

自定义配置文件

可挂载/etc/awstats目录到容器，提供完整自定义配置文件。若未传入日志文件参数，将使用配置中的LogFile选项。

部署示例

创建持久化卷

bash
docker volume create --name awstats-db

生成统计数据

处理/data/web-logs下的压缩日志：

bash
docker run --rm -v /data/web-logs:/web-logs:ro -v awstats-db:/var/lib/awstats \
    openmicroscopy/awstats /web-logs/access.log-*.gz

启动Web界面

暴露8080端口访问统计页面：

bash
docker run --rm -p 8080:8080 -v awstats-db:/var/lib/awstats openmicroscopy/awstats httpd

访问地址：http://localhost:8080（未启用Apache认证）

更新统计数据

处理新增日志文件（自动去重）：

bash
docker run --rm -v /data/web-logs-new:/web-logs-new:ro -v awstats-db:/var/lib/awstats \
    openmicroscopy/awstats '/web-logs-new/access.log-*.gz'