matomo自托管安装需要可运行php的web服务和独立数据库:上传官方发行文件,完成系统检查、数据库连接、超级管理员与站点设置,再把生成的跟踪代码加入目标网站。以下按当前matomo 5安装指南说明,matomo 6 beta有更高的环境要求,不能把两者混成同一最低版本。
准备PHP和独立数据库
Matomo 5要求PHP 8及MySQL 5.5或更高版本、或MariaDB;官方更推荐仍获支持的PHP 8.x和MySQL 8以上环境。数据库驱动需pdo与pdo_mysql或mysqli,并按系统检查补齐curl、GD、XML、mbstring等扩展。给Matomo单独创建数据库和只访问该库的用户,准备好主机、端口、库名与凭据。
wget https://builds.matomo.org/matomo.zip unzip matomo.zip
从官方获取并按官方签名说明核对发行包,通过SSH/SFTP放入专用站点或analytics子目录,再把Web根目录配置到相应位置。文件应可读,写权限限于实际需要的目录;不要给整站统一设置777。

Matomo当前官方指南沿用的安装欢迎页示例
完成系统检查与数据库连接
浏览器打开部署地址进入安装向导。系统检查未通过时先按其具体提示修复PHP扩展、路径或权限,再继续;若没有欢迎页,检查Web站点、PHP处理器和文件位置。

官方安装向导中的独立数据库配置示例
填写独立数据库信息。非默认端口可按向导要求随主机指定,例如localhost:3307。创建表失败时检查该专用用户的建表和修改表权限,不借用业务数据库的超级账号长期运行。
立即学习“PHP免费学习笔记(深入)”;
创建管理账户并登记站点

官方安装指南展示超级管理员创建步骤
设置超级管理员及可用邮箱,凭据不要写入源码或统计代码。然后填写首个被统计网站的名称和准确URL;以后可在管理页添加其他站点,不需要重复安装一套Matomo。

官方向导中的首个站点名称与地址设置
加入跟踪代码并验证访问
复制向导为该站点生成的JavaScript跟踪代码,放到被统计页面的公共头部、结束head标签之前。打开目标站点产生正常访问,再登录Matomo看实时记录;没有数据时检查代码是否加载、站点ID与统计服务地址是否匹配,以及浏览器或隐私设置是否阻止请求。
安装向导图是官方示例,界面随版本可能不同。高流量站点还应设置自动归档;安装成功不等于已经完成定时归档、备份和生产容量规划。



















