digitalist/matomo

Matomo Docker镜像及Helm Chart文档

概述

本镜像及Helm Chart由Digitalist Open Cloud提供，旨在简化Matomo（原Piwik）开源Web分析平台的部署流程。Matomo是一款功能完备的Web分析工具，支持数据自托管，可替代Google Analytics，保障用户数据隐私与控制权。通过Docker镜像和Helm Chart，用户可快速在容器化环境（单机Docker或Kubernetes集群）中部署Matomo服务。

核心功能与特性

• 容器化部署：预配置的Docker镜像，包含Matomo运行所需的基础环境（PHP、Web服务器等），简化安装流程。
• Helm Chart支持：提供Helm Chart，支持在Kubernetes集群中一键部署，包含资源配置、服务暴露、持久化存储等最佳实践。
• 配置灵活性：通过环境变量自定义Matomo参数（如数据库连接、管理员账户、时区等），无需修改镜像内部文件。
• 官方维护：由Digitalist Open Cloud持续更新，同步Matomo官方版本，确保安全性与功能完整性。
• 数据持久化：支持挂载外部卷存储Matomo配置、日志及用户数据，避免容器重启导致数据丢失。

使用场景

• 企业内部Web分析：部署在私有环境中，分析内部系统或客户网站流量，满足数据隐私合规要求（如GDPR）。
• 开发/测试环境：快速搭建Matomo测试实例，验证分析配置或插件功能。
• Kubernetes集群部署：通过Helm Chart在生产级K8s环境中部署高可用Matomo服务，结合Ingress、ConfigMap等K8s资源实现灵活管理。

使用方法

1. Docker镜像部署

前提条件

• Docker Engine 19.03+
• 已部署MySQL/MariaDB数据库（Matomo依赖外部数据库存储数据）

基本运行命令

bash
docker run -d \
  --name matomo \
  -p 8080:80 \
  -e MATOMO_DATABASE_HOST=mysql-host \
  -e MATOMO_DATABASE_USER=matomo-user \
  -e MATOMO_DATABASE_PASSWORD=matomo-password \
  -e MATOMO_DATABASE_NAME=matomo \
  -v matomo-data:/var/www/html \
  digitalistopencloud/matomo:latest

参数说明

• -p 8080:80：将容器内80端口映射到主机8080端口，通过http://localhost:8080访问Matomo
• 环境变量：
  • MATOMO_DATABASE_HOST：数据库主机地址
  • MATOMO_DATABASE_USER：数据库用户名
  • MATOMO_DATABASE_PASSWORD：数据库密码
  • MATOMO_DATABASE_NAME：数据库名称（需提前创建）
• -v matomo-data:/var/www/html：挂载卷存储Matomo配置及数据

2. Helm Chart部署

前提条件

• Kubernetes集群（1.19+）
• Helm 3.x
• 已部署数据库（可通过Helm Chart联动部署或使用外部数据库）

部署步骤

1. 添加Helm仓库：

   bash
   helm repo add digitalist-open-cloud https://digitalistopencloud.github.io/helm-charts/
   helm repo update
   

2. 安装Chart（使用外部数据库）：

   bash
   helm install matomo digitalist-open-cloud/matomo \
     --set database.host=mysql-host \
     --set database.user=matomo-user \
     --set database.password=matomo-password \
     --set database.name=matomo \
     --set service.type=NodePort \
     --set persistence.enabled=true
   

3. 自定义配置（通过values.yaml）：

   yaml
   # 示例values.yaml片段
   database:
     host: "mysql-service"
     port: 3306
     user: "matomo"
     password: "secure-password"
     name: "matomo_db"
   service:
     type: LoadBalancer
   persistence:
     size: 10Gi
   

环境变量配置

持久化存储

• Docker部署：建议通过-v挂载命名卷或主机目录至/var/www/html，确保数据持久化。
• Kubernetes部署：启用persistence.enabled=true，通过PVC管理存储，默认使用ReadWriteOnce访问模式。

访问与初始化

部署完成后，通过映射的端口或K8s服务地址访问Matomo，首次访问将进入初始化向导，验证数据库连接并创建管理员账户。完成后即可登录系统配置网站分析目标。