AWStats 8.1 - Advanced Web Statistics Tool (Community Enhanced Edition)

This project is a modernized refactored version of the original AWStats (1997-2025), and is the first release maintained by the community.

The original AWStats was archived in November 2025 after 25 years of maintenance. We have fully refactored and enhanced it.

---

简体中文文档

繁体中文文档

📦 Download & Installation

Get the latest version from the links below (auto-redirect):

System/Format	Download Link
Debian/Ubuntu
RHEL/CentOS/Fedora
Source Code
Windows

---

✨ Refactoring Features

• Full UTF-8 Support: Completely solves character encoding issues
• Internationalization Translation System: Replaces numeric indices $Message[169] with semantic keys _t('key')
• Dark/Light Theme Switching: One-click toggle between light and dark themes
• Modernized UI: Responsive design, pure CSS charts, Emoji icons

📊 Comparison with Original

Feature	Original AWStats	Refactored Version
Encoding	GBK	UTF-8
Translation Method	Numeric Index	Semantic Keys
UI Style	Fixed	Light/Dark Toggle
Maintenance Status	Archived	Actively Maintained

---

Introduction

AWStats (Advanced Web Statistics) is a powerful open-source log analyzer that generates detailed and intuitive statistical reports for web, FTP, mail, and streaming media servers.

• License: GNU GPL v2+
• Version: 8.1
• Release Date: April 2026
• Supported Platforms: Linux, Windows, BSD, Solaris, macOS, etc.
• Original Author: Laurent Destailleur (1997-2025)
• Community Maintenance: HestiaCP Community

---

✨ Key Features

Category	Features
📊 Traffic Statistics	Unique visitors, visit count, visit duration, authenticated user tracking
🌍 Geolocation	DB-IP free database, country/region/city level, IPv4/IPv6 support
💻 Client Information	Browser, OS, screen resolution, device type (desktop/mobile)
🤖 Bot Detection	500+ search engine crawlers, AI/ML bots (ClaudeBot, GPTBot, etc.)
🔍 Referrer Analysis	Search engines, keywords/phrases, external links, direct access
📁 File Statistics	File types, downloads (resume support), compression (mod_gzip/mod_deflate)
⚠️ Error Analysis	HTTP errors (404, etc.), error sources, worm attack detection
🌐 Multi-language	20+ languages, gettext standard, new Chinese/Traditional/Portuguese (Brazil)
🎨 Modern UI	Responsive design, dark/light themes, pure CSS charts, Emoji flag icons

---

📋 System Requirements

Basic Requirements

• ✅ Access to server log files (Web/FTP/mail) to be analyzed
• ✅ Perl 5.20 or higher (Perl 5.32+ recommended)
• ✅ Command line and/or CGI environment
• ✅ Perl module: Encode

Supported Operating Systems

• 🐧 Linux/Unix (Ubuntu, Debian, CentOS, RHEL, etc.)
• 🪟 Windows (Windows 10/11, Windows Server)
• 🍎 macOS
• 🔵 FreeBSD, OpenBSD

Supported Servers

• 🌐 Web: Apache, Nginx, IIS, Caddy, Lighttpd
• 📁 FTP: ProFTPd, vsFTPd, Pure-FTPd
• 📧 Mail: Postfix, Sendmail, QMail, Exim
• 🎥 Streaming: RealMedia, Windows Media Server

---

🔄 Pre-upgrade Conversion (Upgrade from an older version only)

If a site upgrade is involved, please first execute tools/awstats_convert-en.pl to convert the format of the historical data file (*.txt) (7.0-7.9 → 8.1). If your site version is lower than 7.0, please adjust the matching parameters in the regular expression s/AWSTATS DATA FILE on lines 245-250 of the script according to the actual version number. After the conversion is complete, then perform the data update operation; otherwise, the update will fail due to format incompatibility.

🚀 Quick Start

1. Installation

HestiaCP Users (Recommended)

HestiaCP comes with AWStats pre-installed, you only need to update it with the enhanced deb package.

Supports official Debian and enthusiast RHEL

Files you need to modify:

• Template file: /usr/local/hestia/data/templates/web/awstats/awstats.tpl
• Domain configuration: under /etc/awstats/ directory
• Update script: /usr/local/hestia/bin/v-update-web-domain-stat
• Reference script template: v-update-web-domain-stat
• Reference configuration template: awstats.tpl

# If prompted during installation whether to update configuration files, choose N (keep original configuration)
wget https://github.com/hestiacn/vstats/releases/latest/download/awstats_8.1_all.deb
sudo dpkg -i awstats_8.1_all.deb

Debian / Ubuntu Linux Distribution

# Debian / Ubuntu
wget https://github.com/hestiacn/vstats/releases/latest/download/awstats_8.1_all.deb
apt install -y ./awstats_8.1_all.deb

RHEL Linux Distribution

# RHEL/CentOS/Fedora
wget https://github.com/hestiacn/vstats/releases/latest/download/awstats-8.1-1.noarch.rpm
dnf localinstall -y awstats-8.1-1.noarch.rpm

2. Configuration

Edit the configuration file /etc/awstats/awstats.yourdomain.conf:

LogFile="/var/log/apache2/domains/yourdomain.log"  # Log file path
LogFormat=1                                        # Use combined log format
SiteDomain="yourdomain.com"                        # Website domain
HostAliases="localhost 127.0.0.1"                  # Host aliases

3. Update Statistics

awstats.pl -config=yourdomain -update

4. View Reports

• HestiaCP Environment: Visit https://yourdomain.com/vstats/
• Generate Static Report: perl awstats.pl -config=yourdomain -output > report.html

---

📖 Command Line Help

View Help in Your Language

# 繁體中文
dnf install -y glibc-langpack-zh
localectl set-locale LANG=zh_TW.UTF-8
# RHEL 請使用以下命令
source /etc/locale.conf
# Debian 請使用以下命令
source /etc/default/locale
awstats -h

# English (US)
dnf install -y glibc-langpack-en
localectl set-locale LANG=en_US.UTF-8
# For RHEL/CentOS/Fedora:
source /etc/locale.conf
# For Debian/Ubuntu:
source /etc/default/locale
awstats -h

# 日本語
dnf install -y glibc-langpack-ja
localectl set-locale LANG=ja_JP.UTF-8
# RHEL では以下のコマンドを使用
source /etc/locale.conf
# Debian では以下のコマンドを使用
source /etc/default/locale
awstats -h

# 简体中文
dnf install -y glibc-langpack-zh wget
localectl set-locale LANG=zh_CN.UTF-8
# RHEL 使用以下命令
source /etc/locale.conf
# Debian 请使用以下命令
source /etc/default/locale
awstats -h

# English (UK)
dnf install -y glibc-langpack-en 
localectl set-locale LANG=en_GB.UTF-8
# For RHEL/CentOS/Fedora:
source /etc/locale.conf
# For Debian/Ubuntu:
source /etc/default/locale
awstats -h

# Português (Brasil)
dnf install -y glibc-langpack-pt
localectl set-locale LANG=pt_BR.UTF-8
# Para RHEL/CentOS/Fedora:
source /etc/locale.conf
# Para Debian/Ubuntu:
source /etc/default/locale
awstats -h

Common Commands

Command	Description
awstats.pl -config=xxx -update	Update statistics
awstats.pl -config=xxx -output > report.html	Generate static report
awstats -h	Display help
awstats -v	Display version
awstats.pl -config=xxx -update -debug=2	Debug mode

---

📚 Documentation

Document	Link
Changelog (Chinese)	docs/CHANGELOG-zh_CN.md
Changelog (English)	docs/CHANGELOG.md
Setup Guide	docs/awstats_setup.html
Configuration Guide	docs/awstats_config.html
FAQ	docs/awstats_faq.html

---

🤝 Contributing & Feedback

• Repository: GitHub - hestiacn/vstats
• Issue Tracking: GitHub Issues

---

📄 License

AWStats is open source software released under the GNU General Public License v2.

---

👨‍💻 About the Author & Maintenance

Original Author: Laurent Destailleur (1997-2025)

• Project founder, announced end of maintenance in November 2025
• Project leader of Dolibarr ERP CRM
• Recipient of the 2016 Turing Award (for contributions to web technology)

Community Maintenance: hestiacn

• Version 8.1 modernization refactoring
• Ongoing maintenance and updates

---

🔗 Related Links

• Original Project Website: https://www.awstats.org
• GitHub Repository: https://github.com/hestiacn/vstats
• DB-IP Database: https://db-ip.com

---

© 1997-2026 AWStats Team | Community Edition Continuously Maintained