justb4/awstats

awstats Docker镜像文档

镜像概述

本镜像为Awstats的一体化Docker解决方案，用于多域名的定时日志处理，配置简单且可通过内置网页访问统计结果。镜像旨在最小化主机依赖，支持自包含的日志分析流程，适合需要集中管理多个网站访问统计的场景。

核心功能与特性

• 多站点支持：可配置多个(web)站点的awstats统计
• 灵活配置：通过.env文件（简单变量）或完整awstats配置文件(.conf)定义站点
• 自动更新：内置aw-update.sh脚本，一键更新所有站点统计
• 定时处理：容器内集成cron服务，自动定时执行日志分析
• GeoIP支持：包含IP地理位置解析，可查看访问者国家/地区信息
• 内置Web服务：集成Apache2 HTTP服务器，提供自托管访问
• 站点着陆页：自动生成包含所有配置站点链接的汇总页面
• 反向代理兼容：支持通过AWSTATS_PATH_PREFIX环境变量配置子路径前缀
• 便捷部署：提供docker-compose配置示例，简化部署流程

使用场景与适用范围

• 需要集中分析多个网站访问日志的场景
• 希望最小化主机依赖，实现自包含日志统计的部署（如Kubernetes环境）
• 需通过网页直观查看多站点访问统计数据的需求
• 对访问者地理位置分布有分析需求的场景

使用方法与配置说明

目录结构要求

容器内部依赖以下目录结构：

• /etc/awstats/sites/：存放站点配置文件，支持两种格式
  • .env文件：简易变量配置（推荐）
  • .conf文件：完整awstats配置（高级需求）
• /var/local/log/：存放日志文件（可通过配置自定义路径/文件名）
• /var/lib/awstats/：awstats数据存储目录（需持久化，建议映射为Docker卷）

持久化数据卷

awstats数据存储在/var/lib/awstats/，为避免容器重启后数据丢失，需将此目录映射为持久卷：

bash
# 示例：使用本地目录作为持久卷
docker run -v /host/path/to/awstats-data:/var/lib/awstats ...

快速启动示例

Docker Run命令

bash
docker run -d \
  -p 8080:80 \
  -v /host/logs:/var/local/log \
  -v /host/awstats-sites:/etc/awstats/sites \
  -v /host/awstats-data:/var/lib/awstats \
  --name awstats \
  justb4/awstats

Docker Compose配置

yaml
# docker-compose.yml示例
version: '3'
services:
  awstats:
    image: justb4/awstats
    ports:
      - "8080:80"
    volumes:
      - ./logs:/var/local/log
      - ./awstats-sites:/etc/awstats/sites
      - awstats-data:/var/lib/awstats
    environment:
      - AWSTATS_PATH_PREFIX=/awstats  # 可选，配置反向代理子路径

volumes:
  awstats-data:

站点配置示例

使用.env文件（简易配置）

在/etc/awstats/sites/目录下创建example.com.env：

ini
SITE_DOMAIN=example.com
LOG_FILE=/var/local/log/example.com-access.log
SITE_ALIAS=www.example.com

使用.conf文件（完整配置）

在/etc/awstats/sites/目录下创建example.com.conf，内容遵循awstats配置规范：

conf
LogFile="/var/local/log/example.com-access.log"
SiteDomain="example.com"
HostAliases="www.example.com"

高级配置

处理旧日志文件

Awstats仅处理日志中比最新已知记录更新的行，因此需按时间顺序从旧到新处理历史日志。处理前建议清除已有数据：

bash
docker exec -it awstats rm /var/lib/awstats/*

批量处理历史日志脚本示例

bash
#!/bin/bash
# 处理压缩的历史Apache日志（从.log.60到.log.2）
LOGDIR="/var/local/log"
LOGNAME="access.log"
END=60

# 从60到2反向循环处理
for i in $(seq $END -1 2)
do
  logFile="${LOGDIR}/${LOGNAME}.${i}"
  echo "处理日志: ${logFile}"
  docker exec -it awstats gunzip ${logFile}.gz
  docker exec -it awstats awstats -config=example.com -update -LogFile="${logFile}"
  docker exec -it awstats gzip ${logFile}
done

# 处理未压缩的最近日志
docker exec -it awstats awstats -config=example.com -update -LogFile="${LOGDIR}/${LOGNAME}.1"
docker exec -it awstats awstats -config=example.com -update -LogFile="${LOGDIR}/${LOGNAME}"

设计说明

本镜像基于debian-slim（buster版本）构建，旨在实现高度自包含：

• 使用supervisord管理服务进程：
  • aw-setup.sh：初始化配置
  • Apache2：提供Web访问
  • cron：定时执行日志分析
• 避免依赖主机工具（如外部cron），适合容器化部署（如Kubernetes）
• 设计目标是简化多站点配置，同时保持awstats功能完整性

相关文档

• Awstats官方配置文档
• Ubuntu 16.04下安装Awstats指南

致谢

本Docker镜像基于https://github.com/pabra/docker_awstats%E9%A1%B9%E7%9B%AE%E5%BC%80%E5%8F%91%EF%BC%8C%E5%8E%9F%E9%A1%B9%E7%9B%AE%E4%BD%BF%E7%94%A8Alpine Linux。因GeoIP、bash脚本等高级特性需求，本镜像改为基于debian-slim构建。