Matomo Docker镜像文档

镜像概述

本镜像基于Alpine Linux和Nginx构建，包含Matomo（原Piwik）开源网站分析平台。Matomo是一款功能完备的开源网站分析工具，支持数据本地存储，注重用户隐私，可作为Google Analytics的替代方案，适用于需要自主掌控分析数据的场景。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小、资源占用低，运行高效
• 完整运行环境：集成Nginx作为Web服务器，搭配PHP环境，满足Matomo运行需求
• 数据持久化：支持通过数据卷挂载Matomo配置文件、用户数据及日志，确保数据不丢失
• 易扩展性：可灵活配置环境变量，适配不同数据库（MySQL/MariaDB）及运行参数
• 隐私优先：遵循开源协议，数据完全存储在用户自有服务器，保障数据隐私安全

使用场景

• 个人网站或博客的流量分析与用户行为追踪
• 企业内部网站的访问数据统计与分析
• 对数据隐私有严格要求，需避免第三方数据分析服务的场景
• 需自定义分析指标、报表的个性化数据分析需求

使用方法

前置要求

• 已安装Docker Engine（20.10+推荐）
• 需搭配MySQL或MariaDB数据库（5.5.3+或10.0.0+）

快速启动（单容器模式）

需先启动数据库容器（以MariaDB为例）：

docker run -d \
  --name matomo-db \
  -e MYSQL_ROOT_PASSWORD=rootpass \
  -e MYSQL_DATABASE=matomo \
  -e MYSQL_USER=matomo \
  -e MYSQL_PASSWORD=matomopass \
  -v matomo-db-data:/var/lib/mysql \
  mariadb:10.6

启动Matomo容器并链接数据库：

docker run -d \
  --name matomo \
  --link matomo-db:db \
  -p 8080:80 \
  -e DB_HOST=db \
  -e DB_NAME=matomo \
  -e DB_USER=matomo \
  -e DB_PASSWORD=matomopass \
  -v matomo-data:/var/www/html \
  crazy-max/docker-matomo

访问 http://localhost:8080 完成Matomo初始化配置。

Docker Compose示例

创建 docker-compose.yml：

version: '3'

services:
  db:
    image: mariadb:10.6
    volumes:
      - matomo-db-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_DATABASE=matomo
      - MYSQL_USER=matomo
      - MYSQL_PASSWORD=matomopass
    restart: always

  matomo:
    image: crazy-max/docker-matomo
    depends_on:
      - db
    ports:
      - "8080:80"
    environment:
      - DB_HOST=db
      - DB_NAME=matomo
      - DB_USER=matomo
      - DB_PASSWORD=matomopass
      - TZ=Asia/Shanghai
    volumes:
      - matomo-data:/var/www/html
    restart: always

volumes:
  matomo-db-data:
  matomo-data:

启动服务：

docker-compose up -d

配置说明

数据卷挂载

环境变量

注意事项

• 首次启动需通过Web界面完成Matomo初始化向导，配置网站、用户及数据收集设置
• 数据库需提前创建，且用户需具备足够权限（CREATE、ALTER等）
• 生产环境建议配置HTTPS，可通过反向代理（如Nginx、Traefik）实现
• 定期备份数据卷中的Matomo配置及数据库数据，防止数据丢失

更多详细配置及高级用法，请参考GitHub仓库。