保姆级 Zeabur 部署 Matomo 教程，从买服务器→加服务→精准配置→使用一步到位，还包含专属优惠！

🌟 前置说明

Zeabur 已取消免费共享主机，当前提供托管 VPS 服务，最低 2 美元/月（腾讯云/新加坡等节点折扣），配置 2vCPU+2GB 内存完全满足 Matomo 运行；全程可视化操作，无需手动敲 Docker 命令，自动 SSL、自带数据库，新手也能 10 分钟搞定。

🎁 专属优惠

Zeabur 购买服务器/AI Hub 额度时，结账输入推荐码： maoyiren ，立享 10% 折扣！
👉 官网入口：https://zeabur.com

一、前期准备

1. 注册/登录 Zeabur：支持 GitHub/Google 一键登录，无需实名认证。
2. 准备域名（可选，也可先用 Zeabur 分配的免费域名）：解析到 Zeabur 自动生成的 IP（后续会教你绑定）。
3. 确认服务器需求：Matomo 仅需 2vCPU+2GB 内存，选新加坡/韩国节点(国内访问快，不用ICP备案)。

二、第一步：购买 Zeabur 托管 VPS(如有跳过)

1. 登录后进入「创建新项目」→ 点击「购买新服务器」。
2. 选择服务商/区域：

• 国内用户：选 Tencent（腾讯云） → 区域选「中国北京/上海」（国内访问最快）(需ICP备案)。
• 国际用户：选 Hetzner/AWS → 区域选「新加坡/韩国首尔/日本东京」(不用ICP备案)。

3. 选择配置：

最低配：2vCPU + 2GB 内存 + 40GB 存储（2 美元/月，折扣后更低）。

其他默认（出站流量 0.5TB/1TB 足够个人站使用）。
4. 确认订单，结账页面输入推荐码  maoyiren ，完成支付（支持信用卡/PayPal）。
5. 等待服务器创建完成（状态显示「运行中」），进入项目页。

三、第二步：添加 Matomo 服务（Docker 镜像部署）

对应你第二张截图的自定义 Prebuilt 界面，这是核心配置步骤，逐一项讲清楚：

1. 进入服务添加页面

在你的 Zeabur 项目页 → 点击「添加服务」→ 选择「Docker 镜像」→ 进入「自定义 Prebuilt」页面。

2. 基础配置（镜像/用户名）

配置项 填写内容 说明
镜像  matomo:latest  官方最新镜像，无需修改
用户名 （留空） 仅私有镜像需要，公共镜像不用填
密码 （留空） 仅私有镜像需要，公共镜像不用填

3. 环境变量（关键！Matomo 数据库连接配置）

点击「环境变量」→ 「添加环境变量」，共添加 5 组，严格对应 key/value：

Key（变量名） Value（值） 说明
 MATOMO_DATABASE_ADAPTER   PDO_MYSQL  数据库类型，固定填这个
 MATOMO_DATABASE_HOST  （后续填，先留空） 数据库服务连接地址，等下加完 MariaDB 再填
 MATOMO_DATABASE_DBNAME   matomo  数据库名，固定
 MATOMO_DATABASE_USERNAME   root  数据库用户名（Zeabur MariaDB 默认可用）
 MATOMO_DATABASE_PASSWORD  （后续填，先留空） 数据库密码，加完 MariaDB 再填

4. 卷配置（数据持久化！截图里的关键项）

对应你第二张截图的「卷」配置，必须添加，否则 Matomo 数据会随容器重启丢失：
点击「添加卷」，填写 2 组（分别存 Matomo 代码+数据）：

卷 1（Matomo 主数据）

卷 ID 路径
 matomo-data   /var/www/html 

卷 2（可选，备份用）

卷 ID 路径
 matomo-backup   /var/www/html/config 

说明： /var/www/html  是 Matomo 核心文件存储路径，持久化后数据不会丢。

5. 端口配置

默认已填  80:80 ，无需修改（Matomo 内置 Nginx，监听 80 端口）。

6. 启动命令

留空！Matomo 镜像内置启动脚本，无需额外配置。

7. 先别保存！先添加 MariaDB 数据库

Matomo 必须依赖数据库，Zeabur 一键添加更简单：

• 返回项目页 → 点击「添加服务」→ 选择「MariaDB」。
• 配置默认即可：
• 用户名： root （自动生成，可改）。
• 密码：自定义（记下来，后续填到 Matomo 环境变量）。
• 数据库名： matomo （自动生成）。
• 等待 MariaDB 部署完成（状态「运行中」）。

1. 补全 Matomo 环境变量

回到 Matomo 服务的「环境变量」页，补全之前留空的 2 项：

Key Value 获取方式
 MATOMO_DATABASE_HOST  你的 MariaDB 服务连接地址 进入 MariaDB 服务页 → 「网络」→ 复制「内部端点」（格式： mariadb-xxx.zeabur.internal ）
 MATOMO_DATABASE_PASSWORD  你的 MariaDB 密码 MariaDB 服务「环境变量」里的  MARIADB_ROOT_PASSWORD  值

9. 保存并部署

点击页面右上角「保存」→ Zeabur 自动构建并部署 Matomo 容器，等待 1-2 分钟，状态显示「运行中」即部署成功。

四、第三步：绑定域名 + 自动 HTTPS（必做）

Zeabur 支持自动签发 SSL 证书，无需手动配置，步骤如下：

1. 进入 Matomo 服务页 → 点击「网络」。
2. 开启「公网访问」：

• 方式 1（免费）：使用 Zeabur 分配的免费域名（格式： xxx.zeabur.app ），自动生成 SSL，直接访问。
• 方式 2（自定义域名）：
• 先将你的域名（如  stats.xxx.com ）解析到 Zeabur 显示的「外部 IP」（网络页复制）。
• 在网络页「自定义域名」处输入你的域名，点击「添加」。
  3. 等待 SSL 证书签发（状态显示「已启用」），此时访问域名会自动跳转到 HTTPS。

1. 打开你的 Zeabur 分配的域名/自定义域名（如  https://xxx.zeabur.app ）。
2. 进入 Matomo 安装向导，关键配置直接填：

• 语言：选「简体中文」。
• 数据库服务器：填刚才的  MATOMO_DATABASE_HOST  值（如  mariadb-xxx.zeabur.internal ）。
• 数据库登录名： root 。
• 数据库密码：你的 MariaDB 密码。
• 数据库名： matomo 。
• 表前缀：默认  matomo_ 。
  3. 点击「下一步」→ 创建管理员账号（自定义账号密码）。
  4. 完成安装，进入 Matomo 后台，添加你的网站域名，获取统计代码嵌入即可。

六、常见问题解决（避坑指南）

1. 数据库连接失败

• 检查  MATOMO_DATABASE_HOST  是否填对（必须是 MariaDB 内部端点，不是公网 IP）。
• 检查密码是否和 MariaDB 一致，可去 MariaDB 服务页重置密码。

1. 页面 502 错误

• 等待 MariaDB 完全启动（比 Matomo 慢 1 分钟，可重启 Matomo 服务）。
• 检查端口是否被占用（Zeabur 已独占端口，无需担心）。

1. 数据丢失

• 确认卷配置正确（ /var/www/html  已挂载持久化卷）。
• 定期备份卷数据（Zeabur 支持一键备份）。

七、方案对比（Docker 自建 vs Zeabur）

对比项 Docker 自建（有服务器） Zeabur 托管 VPS（2 美元/月）
运维成本 高（配 Nginx/SSL/备份） 0（Zeabur 全自动）
部署速度 10 分钟 5 分钟
国内访问 取决于服务器带宽 腾讯云节点秒开
成本 服务器 30 元/月起 2 美元/月（约 14 元）+ 10% 折扣
适合人群 有运维经验、想完全掌控 新手、个人站长、不想折腾

🎁 zeabur优惠

通过 Zeabur 官网购买服务器/AI Hub 额度，结账输入推荐码  maoyiren ，立享 10% 折扣！
不管是买 2 美元的 VPS 还是扩容，都能减钱，性价比直接拉满～

感谢阅读