保姆级 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 界面，这是核心配置步骤，逐一项讲清楚：
- 进入服务添加页面
在你的 Zeabur 项目页 → 点击「添加服务」→ 选择「Docker 镜像」→ 进入「自定义 Prebuilt」页面。
- 基础配置（镜像/用户名）
配置项 填写内容 说明
镜像 matomo:latest 官方最新镜像，无需修改
用户名 （留空） 仅私有镜像需要，公共镜像不用填
密码 （留空） 仅私有镜像需要，公共镜像不用填
- 环境变量（关键！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 再填
- 卷配置（数据持久化！截图里的关键项）
对应你第二张截图的「卷」配置，必须添加，否则 Matomo 数据会随容器重启丢失：
点击「添加卷」，填写 2 组（分别存 Matomo 代码+数据）：
卷 1（Matomo 主数据）
卷 ID 路径
matomo-data /var/www/html
卷 2（可选，备份用）
卷 ID 路径
matomo-backup /var/www/html/config
说明： /var/www/html 是 Matomo 核心文件存储路径，持久化后数据不会丢。
- 端口配置
默认已填 80:80 ，无需修改（Matomo 内置 Nginx，监听 80 端口）。
- 启动命令
留空！Matomo 镜像内置启动脚本，无需额外配置。
- 先别保存！先添加 MariaDB 数据库
Matomo 必须依赖数据库，Zeabur 一键添加更简单：
- 返回项目页 → 点击「添加服务」→ 选择「MariaDB」。
- 配置默认即可：
- 用户名： root （自动生成，可改）。
- 密码：自定义（记下来，后续填到 Matomo 环境变量）。
- 数据库名： matomo （自动生成）。
- 等待 MariaDB 部署完成（状态「运行中」）。
- 补全 Matomo 环境变量
回到 Matomo 服务的「环境变量」页，补全之前留空的 2 项：
Key Value 获取方式
MATOMO_DATABASE_HOST 你的 MariaDB 服务连接地址 进入 MariaDB 服务页 → 「网络」→ 复制「内部端点」（格式： mariadb-xxx.zeabur.internal ）
MATOMO_DATABASE_PASSWORD 你的 MariaDB 密码 MariaDB 服务「环境变量」里的 MARIADB_ROOT_PASSWORD 值
- 保存并部署
点击页面右上角「保存」→ 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。
五、第四步：完成 Matomo 安装初始化
1. 打开你的 Zeabur 分配的域名/自定义域名（如 https://xxx.zeabur.app ）。
2. 进入 Matomo 安装向导，关键配置直接填：
- 语言：选「简体中文」。
- 数据库服务器：填刚才的 MATOMO_DATABASE_HOST 值（如 mariadb-xxx.zeabur.internal ）。
- 数据库登录名： root 。
- 数据库密码：你的 MariaDB 密码。
- 数据库名： matomo 。
- 表前缀：默认 matomo_ 。
3. 点击「下一步」→ 创建管理员账号（自定义账号密码）。
4. 完成安装，进入 Matomo 后台，添加你的网站域名，获取统计代码嵌入即可。
六、常见问题解决（避坑指南）
- 数据库连接失败
- 检查 MATOMO_DATABASE_HOST 是否填对（必须是 MariaDB 内部端点，不是公网 IP）。
- 检查密码是否和 MariaDB 一致，可去 MariaDB 服务页重置密码。
- 页面 502 错误
- 等待 MariaDB 完全启动（比 Matomo 慢 1 分钟，可重启 Matomo 服务）。
- 检查端口是否被占用（Zeabur 已独占端口，无需担心）。
- 数据丢失
- 确认卷配置正确（ /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 还是扩容，都能减钱，性价比直接拉满～
感谢阅读