Matomo Docker镜像（arm32v6架构）

1. 镜像概述

1.1 主要用途

Matomo（前身为Piwik）是领先的开源分析平台，提供强大的数据分析能力，同时确保100%数据所有权和用户隐私保护。本镜像为arm32v6架构专用版本，是官方Matomo镜像的特定架构构建，适用于ARM 32位v6架构的设备（如部分嵌入式系统、单板计算机）。

1.2 维护与支持

• 维护方：Matomo社区（Matomo社区贡献者）
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

2. 核心功能与特性

• 开源免费：基于开源许可协议，可自由使用和修改
• 数据主权：100%掌控用户数据，无需依赖第三方服务
• 隐私保护：内置隐私保护功能，符合GDPR等法规要求
• 用户洞察：以用户为中心的数据分析，提供详细用户行为报告
• 可定制扩展：支持插件扩展和自定义配置，适应多样化需求

3. 使用场景与适用范围

• 网站分析：跟踪网站访问量、用户行为、转化路径等关键指标
• 隐私敏感场景：对数据隐私要求高的组织或个人（如企业内部系统、医疗/教育机构）
• 自主数据管理：需完全控制数据存储和处理流程的场景
• ARM设备部署：适用于arm32v6架构的嵌入式设备或低功耗服务器

4. 快速参考

4.1 支持的标签及Dockerfile链接

4.2 支持的架构

官方Matomo镜像支持多架构，包括：amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x（本镜像为arm32v6架构专用）。

4.3 问题反馈与贡献

• 提交 issue：[***]
• 代码贡献：欢迎提交Pull Request至Matomo Docker仓库

5. 使用方法

5.1 基本运行

需先启动MySQL或MariaDB数据库容器（示例中命名为some-mysql），再运行Matomo容器并链接数据库：

docker run -d --link some-mysql:db arm32v6/matomo

5.2 持久化数据

使用Docker卷挂载/var/www/html目录，确保数据持久化：

docker run -d -p 8080:80 --link some-mysql:db -v matomo_data:/var/www/html arm32v6/matomo

• -p 8080:80：将容器80端口映射到主机8080端口，通过[***]访问Matomo
• -v matomo_data:/var/www/html：创建名为matomo_data的卷，持久化Matomo应用数据

5.3 Docker Compose部署

以下为最小化Compose配置示例（包含Matomo和MySQL服务）：

version: '3'
services:
  db:
    image: arm32v6/mysql:5.7
    volumes:
      - db_data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=matomo_root_pw
      - MYSQL_DATABASE=matomo_db
      - MYSQL_USER=matomo_user
      - MYSQL_PASSWORD=matomo_pw
    restart: always

  matomo:
    image: arm32v6/matomo
    ports:
      - "8080:80"
    depends_on:
      - db
    environment:
      - MATOMO_DATABASE_HOST=db
      - MATOMO_DATABASE_USERNAME=matomo_user
      - MATOMO_DATABASE_PASSWORD=matomo_pw
      - MATOMO_DATABASE_DBNAME=matomo_db
      - PHP_MEMORY_LIMIT=256M
    volumes:
      - matomo_data:/var/www/html
    restart: always

volumes:
  db_data:
  matomo_data:

启动命令：docker-compose up -d

5.4 Matomo安装配置

容器启动后，通过[***]访问Matomo，进入配置向导：

1. 数据库设置（若使用上述Compose配置）：

   • 数据库服务器：db（Compose中数据库服务名）
   • 登录名：MYSQL_USER（示例中为matomo_user）
   • 密码：MYSQL_PASSWORD（示例中为matomo_pw）
   • 数据库名：MYSQL_DATABASE（示例中为matomo_db）
   • 其余保持默认

2. 创建超级用户：按向导提示设置管理员账号密码，完成安装。

5.5 日志导入

如需导入服务器日志至Matomo，可运行以下命令（需替换实际参数）：

docker run --rm --volumes-from=matomo_matomo_1 --link matomo_matomo_1 python:3-alpine \
  python /var/www/html/misc/log-analytics/import_logs.py \
  --url=[***] \
  --login=管理员账号 \
  --password=管理员密码 \
  --idsite=1 \
  --recorders=4 \
  /var/www/html/logs/access.log

• --volumes-from=matomo_matomo_1：挂载Matomo容器的卷，访问日志文件
• --idsite=1：目标网站ID（在Matomo后台“网站”设置中获取）
• /var/www/html/logs/access.log：需分析的日志文件路径

6. 配置参数

6.1 数据库配置环境变量

6.2 PHP配置环境变量

7. 镜像变体

7.1 标准变体

arm32v6/matomo:<version>
基于 Debian 基础镜像，包含完整依赖，兼容性好，适合大多数场景。

7.2 Alpine变体

arm32v6/matomo:<version>-alpine
基于Alpine Linux，体积更小（约5MB基础镜像），适合对镜像大小敏感的场景。
注意：使用musl libc替代glibc，部分依赖glibc的软件可能存在兼容性问题。

8. 许可证信息

• 软件许可：镜像包含的Matomo软件许可信息见Matomo官方仓库。
• 镜像许可：本镜像可能包含其他软件（如基础系统组件、依赖库等），其许可信息需由用户自行确认合规性。
• 额外信息：可在repo-info仓库的matomo目录查看自动检测的许可信息。

使用本镜像即表示用户同意遵守所有包含软件的许可条款。