marvambass/piwik

Docker Piwik容器（marvambass/piwik）

由MarvAmBass维护

FAQ - 关于marvambass容器的所有须知

镜像概述

此Docker镜像（镜像名：marvambass/piwik）提供了一个完全安全的Piwik（现更名为Matomo）网站分析工具。它基于https://registry.hub.docker.com/u/marvambass/nginx-ssl-php/镜像构建，支持无头安装（无需手动交互配置）。

可在Docker Registry查看：https://registry.hub.docker.com/u/marvambass/piwik/
可在GitHub查看源码：https://github.com/MarvAmBass/docker-piwik

核心功能

1. 无头安装支持：通过环境变量完成自动化配置，无需手动操作
2. 安全传输：基于nginx-ssl-php镜像，确保HTTPS传输安全
3. 灵活配置：支持数据库、管理员账户、站点参数及跟踪规则的环境变量配置
4. 隐私保护：内置IP***化、Do Not Track（DNT）等隐私功能
5. 高级扩展：支持反向代理、HSTS头部、插件激活等高级设置

使用场景

• 个人网站/博客的流量统计与用户行为分析
• 企业内部站点的访问数据监控与优化
• 开发/测试环境中快速部署网站分析工具

配置说明

无头安装必填环境变量

数据库设置

• PIWIK_MYSQL_USER：无默认值，为空则进入初始配置模式
• PIWIK_MYSQL_PASSWORD：无默认值，为空则进入初始配置模式
• PIWIK_MYSQL_HOST：默认mysql，数据库主机名
• PIWIK_MYSQL_PORT：默认3306，数据库端口
• PIWIK_MYSQL_DBNAME：默认piwik，数据库名（禁止使用-符号）
• PIWIK_MYSQL_PREFIX：默认piwik_，表前缀

管理员设置

• PIWIK_ADMIN：默认admin，管理员用户名
• PIWIK_ADMIN_PASSWORD：默认随机10位字符，管理员密码
• PIWIK_ADMIN_MAIL：默认no@no.tld，通讯订阅***
• PIWIK_SUBSCRIBE_NEWSLETTER：1/0，默认0（不订阅）
• PIWIK_SUBSCRIBE_PRO_NEWSLETTER：1/0，默认0（不订阅专业版）

站点设置

• SITE_NAME：默认My local Website，站点名称
• SITE_URL：默认http://localhost，站点URL
• SITE_TIMEZONE：默认Europe/Berlin，站点时区
• SITE_ECOMMERCE：1/0，默认0（不启用电商跟踪）

跟踪设置

• ANONYMISE_IP：1/0，默认1（***化IP）
• DO_NOT_TRACK：1/0，默认1（跳过DNT浏览器跟踪）

其他设置

• PIWIK_RELATIVE_URL_ROOT：默认/piwik/，自定义访问路径
• PIWIK_NOT_BEHIND_PROXY：设置则移除反向代理配置
• PIWIK_PROXY_HEADER：默认HTTP_X_FORWARDED_FOR，获取原始IP的代理头部
• PIWIK_HSTS_HEADERS_ENABLE：设置则启用SSL通道HSTS
• PIWIK_PLUGINS_ACTIVATE：空格分隔的插件列表，设置则激活指定插件
• PIWIK_ENABLE_TRUSTED_HOST_CHECK：0/1，默认0（禁用可信主机检查）

继承变量

• DH_SIZE：默认2048，SSL密钥长度（继承自nginx-ssl-secure镜像）

部署示例

需先运行MySQL容器（推荐https://registry.hub.docker.com/u/marvambass/mysql/），并链接到Piwik容器：

bash
docker run -d -p 80:80 -p 443:443 --link mysql:mysql --name piwik docker.xuanyuan.run/marvambass/piwik