Metabase：BI 分析工具

Metabase 是一个快速、易用的开源商业智能工具，让您的团队无需 SQL 知识即可探索和可视化数据。

Metabase 提供友好的用户界面和丰富的图表类型，支持连接多种数据库，是企业数据分析的理想选择。

模板默认使用 metabase/metabase:v0.64.1.x，通过单一 METABASE_IMAGE 参数覆盖完整镜像名。2026-10-08 验证时该标签解析为 0.64.1.1，已在 PostgreSQL 18.6 上验证元数据库备份恢复后升级、登录和已有问题查询。

快速开始

在 Pigsty 软件模板目录中提供了 Metabase 的 Docker Compose 配置文件：

cd ~/pigsty/app/metabase

检查并修改 .env 配置文件：

vim .env    # 检查配置，建议修改默认凭据

启动前先创建专用 metabase 数据库及 dbuser_metabase 用户，并与 .env 中的连接信息保持一致；不要共用 Pigsty CMDB 数据库。

启动服务：

make up     # 使用 Docker Compose 启动 Metabase

访问 Metabase：

• 默认地址： http://mtbs.pigsty
• 备用地址： http://10.10.10.10:9004
• 首次访问需要完成初始化设置

管理命令

Pigsty 提供了便捷的 Makefile 命令来管理 Metabase 服务：

make up      # 启动 Metabase 服务
make run     # make up 的别名
make view    # 显示 Metabase 访问地址
make log     # 查看容器日志
make info    # 查看服务详细信息
make stop    # 停止服务
make clean   # 停止并移除容器
make pull    # 拉取配置指定的镜像
make rmi     # 移除 Metabase 镜像
make save    # 保存镜像到文件
make load    # 从文件加载镜像

连接 PostgreSQL

Metabase 可以连接到 Pigsty 管理的 PostgreSQL 数据库。

在 Metabase 初始化或添加数据库时，选择「PostgreSQL」，然后输入连接信息：

数据库类型：PostgreSQL
名称：自定义名称（如 "生产数据库"）
主机：10.10.10.10
端口：5432
数据库名：your_database
用户名：dbuser_meta
密码：DBUser.Meta

连接成功后，Metabase 会自动扫描数据库结构，您可以开始创建问题和仪表板。

功能特性

• 无需 SQL：通过可视化界面构建查询
• 丰富的图表类型：折线图、柱状图、饼图、地图等
• 交互式仪表板：创建美观的数据仪表板
• 自动刷新：定时更新数据和仪表板
• 权限管理：精细的用户和数据访问控制
• SQL 模式：高级用户可以直接编写 SQL
• 嵌入功能：将图表嵌入到其他应用
• 告警功能：数据变化自动通知

配置说明

Metabase 的配置在 .env 文件中：

# 镜像与宿主机端口
METABASE_IMAGE=metabase/metabase:v0.64.1.x
MB_PORT=9004

# Metabase 元数据库
MB_DB_TYPE=postgres
MB_DB_DBNAME=metabase
MB_DB_PORT=5432
MB_DB_USER=dbuser_metabase
MB_DB_PASS=DBUser.Metabase
MB_DB_HOST=10.10.10.10

建议：为 Metabase 使用独立的 PostgreSQL 数据库存储元数据。

数据持久化

Metabase 的元数据（用户、问题、仪表板等）存储在配置的数据库中。

当前模板默认使用外部 PostgreSQL 元数据库，没有为 H2 配置 /data/metabase 持久化目录。容器健康检查通过 /api/health 同时检查应用与元数据库；首次迁移期间请等待服务变为 healthy。

从 Metabase 63 升级到 64 会自动迁移元数据库。升级前备份数据库并记录旧镜像 digest，先在备份恢复副本上验证。回滚需要配套的数据库备份与旧镜像，仅替换镜像不能撤销数据库迁移。参见 升级指南。

性能优化

• 使用 PostgreSQL：为元数据库分配独立资源并监控负载
• 增加内存：如需调整 JVM 内存，在 Compose 的 environment 中显式传入 JAVA_OPTS；仅向 .env 添加该变量不会自动传入容器
• 数据库索引：为常查询的字段创建索引
• 结果缓存：启用 Metabase 的查询结果缓存
• 定时更新：合理设置仪表板的自动刷新频率

安全建议

1. 修改默认凭据：修改元数据库的用户名和密码
2. 启用 HTTPS：生产环境配置 SSL 证书
3. 配置认证：启用 SSO 或 LDAP 认证
4. 限制访问：通过防火墙限制访问
5. 定期备份：备份 Metabase 元数据库

相关链接

• Metabase 官网： https://metabase.com/
• 官方文档： https://www.metabase.com/docs/
• GitHub 仓库： https://github.com/metabase/metabase
• Pigsty 软件模板： https://github.com/pgsty/pigsty/tree/main/app/metabase