Bitnami Matomo 镜像

Matomo 是什么？

Matomo（前身为Piwik）是一款实时网络分析程序，可提供详细的网站访问者报告。

Matomo 概述
商标说明：本软件列表由Bitnami打包。产品中提及的 respective 商标归各自公司所有，使用这些商标并不意味着任何关联或认可。

快速启动

console
docker run --name matomo bitnami/matomo:latest

警告：此快速设置仅适用于开发环境。建议您更改不安全的默认凭据，并查看环境变量部分中的可用配置选项，以进行更安全的部署。

⚠️ 重要通知：Bitnami 目录即将变更

自2025年8月28日起，Bitnami将改进其公共目录，在新的Bitnami Secure Images计划下提供精选的强化、安全聚焦镜像。作为此次过渡的一部分：

• 首次向社区用户提供流行容器镜像的安全优化版本。
• Bitnami将开始在免费层中弃用对非强化、基于Debian的软件镜像的支持，并将逐步从公共目录中移除非最新标签。因此，社区用户将只能访问数量减少的强化镜像，这些镜像仅以“latest”标签发布，适用于开发目的。
• 从8月28日开始，在两周内，所有现有容器镜像（包括旧版本或带版本号的标签，如2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移到“Bitnami Legacy”仓库（docker.io/bitnamilegacy），迁移后将不再接收更新。
• 对于生产工作负载和长期支持，建议用户采用Bitnami Secure Images，包括强化容器、更小的***面、CVE透明度（通过VEX/KEV）、SBOM以及企业支持。

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，提高所有Bitnami用户的安全态势。更多详情，请访问Bitnami Secure Images公告。

为什么使用 Bitnami Secure Images？

• Bitnami Secure Images和Helm图表旨在使开源软件更安全且适合企业使用。
• 通过行业标准漏洞可利用性交换（VEX）、KEV和EPSS评分，更快地分类安全漏洞，并透明了解CVE风险。
• 我们的强化镜像使用最小化操作系统（Photon Linux），减少***面，同时通过行业标准包格式保持可扩展性。
• 通过持续构建的镜像（在上游补丁发布后数小时内更新），保持更高的安全性和合规性。
• Bitnami容器、虚拟机和云镜像使用相同的组件和配置方法——便于根据项目需求在不同格式之间切换。
• 强化镜像附带证明签名（Notation）、SBOM、病毒扫描报告和其他元数据，这些元数据在符合SLSA-3标准的软件工厂中生成。

仅有部分BSI应用程序可免费使用。希望访问完整的应用程序目录以及企业支持？立即尝试Bitnami Secure Images商业版。

为什么使用非root容器？

非root容器镜像增加了额外的安全层，通常推荐用于生产环境。但是，由于它们以非root用户运行，通常无法执行特权任务。在我们的文档中了解更多关于非root容器的信息。

支持的标签及相应的 Dockerfile 链接

了解Bitnami标签策略以及滚动标签和不可变标签之间的区别，请参阅我们的文档页面。

您可以通过查看分支文件夹中的tags-info.yaml文件（即bitnami/ASSET/BRANCH/DISTRO/tags-info.yaml）来了解不同标签之间的对应关系。

通过关注bitnami/containers GitHub仓库订阅项目更新。

前提条件

要运行此应用程序，您需要Docker Engine >= 1.10.0。建议使用Docker Compose，版本1.6.0或更高。

如何获取此镜像

获取Bitnami Matomo Docker镜像的推荐方式是从Docker Hub Registry拉取预构建镜像。要使用特定版本，您可以拉取带版本的标签。在Docker Hub Registry中找到可用版本列表。

console
docker pull bitnami/matomo:[TAG]

如果您愿意，也可以通过克隆仓库、切换到包含Dockerfile的目录并执行docker build命令来自行构建镜像。请记住在下面的示例命令中用正确的值替换APP、VERSION和OPERATING-SYSTEM路径占位符。

console
git clone [***]
cd bitnami/APP/VERSION/OPERATING-SYSTEM
docker build -t bitnami/APP:latest .

如何使用此镜像

Matomo需要访问MySQL数据库或MariaDB数据库来存储信息。它使用我们的MariaDB镜像满足数据库要求。

使用Docker命令行运行应用程序

如果您想手动运行应用程序而不使用docker-compose，您需要执行以下基本步骤：

1. 为应用程序和数据库创建新网络：

   console
   docker network create matomo_network
   

2. 创建MariaDB持久化卷并创建MariaDB容器

   console
   docker volume create --name mariadb_data
   docker run -d --name mariadb \
     -e ALLOW_EMPTY_PASSWORD=yes \
     -e MARIADB_USER=bn_matomo \
     -e MARIADB_DATABASE=bitnami_matomo \
     --net matomo_network \
     --volume mariadb_data:/bitnami \
     bitnami/mariadb:latest
   

3. 创建Matomo持久化卷并启动容器

   console
   docker volume create --name matomo_data
   docker run -d --name matomo -p 80:8080 -p 443:8443 \
     -e ALLOW_EMPTY_PASSWORD=yes \
     -e MATOMO_DATABASE_USER=bn_matomo \
     -e MATOMO_DATABASE_NAME=bitnami_matomo \
     --net matomo_network \
     --volume matomo_data:/bitnami \
     bitnami/matomo:latest
   

然后您可以通过[***]访问应用程序。

使用Docker Compose运行应用程序

console
curl -sSL [***] > docker-compose.yml
docker-compose up -d

请注意，此文件未经内部测试。因此，建议仅将其用于开发或测试目的。对于生产就绪部署，强烈建议使用其关联的Bitnami Helm图表。

如果您在docker-compose.yaml文件中发现任何问题，请随时报告或按照我们的贡献指南贡献修复。

持久化您的应用程序

如果您删除容器，所有数据和配置都将丢失，下次运行镜像时数据库将重新初始化。为避免数据丢失，您应该挂载一个卷，该卷在容器被删除后仍会保留。

为了持久化，您应该在/bitnami路径挂载一个卷。此外，您还应该为MariaDB数据持久化挂载一个卷。

上述示例定义了名为mariadb_data和matomo_data的docker卷。只要这些卷未被删除，Matomo应用程序状态就会持久化。

要避免意外删除这些卷，您可以将主机目录挂载为数据卷。或者，您可以使用卷插件来托管卷数据。

使用Docker Compose将主机目录挂载为数据卷

这需要对此仓库中的docker-compose.yml文件进行 minor 修改：

yaml
services:
  mariadb:
  ...
    volumes:
      - /path/to/mariadb-persistence:/bitnami
  ...
  matomo:
  ...
    volumes:
      - /path/to/matomo-persistence:/bitnami
  ...

注意：由于这是一个非root容器，挂载的文件和目录必须对UID 1001具有适当的权限。

使用Docker命令行将主机目录挂载为数据卷

在这种情况下，您需要在运行命令时指定要挂载的目录。过程与前面显示的相同：

1. 创建网络（如果不存在）：

   console
   docker network create matomo_network
   

2. 使用主机卷创建MariaDB容器：

   console
    docker run -d --name mariadb \
     -e ALLOW_EMPTY_PASSWORD=yes \
     -e MARIADB_USER=bn_matomo \
     -e MARIADB_DATABASE=bitnami_matomo \
     --net matomo_network \
     --volume /path/to/mariadb-persistence:/bitnami \
     bitnami/mariadb:latest
   

   注意：您需要给容器命名，以便Matomo能够解析主机

3. 使用主机卷创建Matomo容器：

   console
   docker run -d --name matomo -p 80:80 -p 443:443 \
     -e ALLOW_EMPTY_PASSWORD=yes \
     -e MATOMO_DATABASE_USER=bn_matomo \
     -e MATOMO_DATABASE_NAME=bitnami_matomo \
     --net matomo_network \
     --volume /path/to/matomo-persistence:/bitnami \
     bitnami/matomo:latest
   

备份您的容器

要备份您的数据、配置和日志，请按照以下简单步骤操作：

步骤1：停止当前运行的容器

console
docker stop matomo

或使用Docker Compose：

console
docker-compose stop matomo

步骤2：运行备份命令

我们需要在用于创建备份的容器中挂载两个卷：主机上用于存储备份的目录，以及我们刚刚停止的容器的卷，以便我们可以访问数据。

console
docker run --rm -v /path/to/matomo-backups:/backups --volumes-from matomo busybox \
  cp -a /bitnami/matomo /backups/latest

恢复备份

恢复备份就像将备份作为卷挂载到容器中一样简单。

对于MariaDB数据库容器：

diff
 $ docker run -d --name mariadb \
   ...
-  --volume /path/to/mariadb-persistence:/bitnami/mariadb \
+  --volume /path/to/mariadb-backups/latest:/bitnami/mariadb \
   bitnami/mariadb:latest

对于Matomo容器：

diff
 $ docker run -d --name matomo \
   ...
-  --volume /path/to/matomo-persistence:/bitnami/matomo \
+  --volume /path/to/matomo-backups/latest:/bitnami/matomo \
   bitnami/matomo:latest

升级Matomo

Bitnami提供MariaDB和Matomo的最新版本，包括安全补丁，在上游发布后很快就会更新。建议您按照以下步骤升级容器。这里我们将介绍Matomo容器的升级。关于MariaDB的升级，您可以查看<[***]>

1. 获取更新的镜像：

   console
   docker pull bitnami/matomo:latest
   

2. 停止您的容器

   • 对于docker-compose：$ docker-compose stop matomo
   • 对于手动执行：$ docker stop matomo

3. 拍摄应用程序状态快照

   console
   rsync -a /path/to/matomo-persistence /path/to/matomo-persistence.bkp.$(date +%Y%m%d-%H.%M.%S)
   

   此外，拍摄MariaDB数据快照

   如果升级失败，您可以使用这些快照恢复应用程序状态。

4. 删除当前运行的容器

   • 对于docker-compose：$ docker-compose rm -v matomo
   • 对于手动执行：$ docker rm -v matomo

5. 运行新镜像

   • 对于docker-compose：$ docker-compose up matomo
   • 对于手动执行（如果需要，挂载目录）：docker run --name matomo bitnami/matomo:latest

配置

环境变量

可自定义环境变量