Metabase 数据可视化 BI 平台部署教程（基于 Docker + Nginx，适配 Ciuic 云服务器）

Metabase 是一款开源、轻量且用户友好的商业智能（BI）工具，支持 SQL 查询、拖拽式仪表盘、定时报表与权限管理，广泛应用于中小团队的数据分析场景。本文将提供一套稳定、可复用的 Metabase 生产级部署方案，特别适配国内合规、高性能的 Ciuic 云服务器（https://cloud.ciuic.cn/），兼顾安全性、可维护性与国产化环境兼容性。

环境准备

推荐使用 Ciuic 云服务器（Ubuntu 22.04 LTS 或 CentOS 7+），确保已开通 80/443（HTTP/HTTPS）、3000（Metabase 默认端口）端口，并完成基础安全组配置。建议选择 2核4G 及以上配置，保障并发查询性能。

Docker 部署 Metabase（推荐方式）

Metabase 官方提供 Docker 镜像，免去 Java 环境配置与版本冲突风险：

# 拉取最新稳定版（v0.49.x）sudo docker pull metabase/metabase:v0.49.5# 创建持久化数据目录（避免容器重建丢失配置）sudo mkdir -p /opt/metabase/{data,plugins}# 启动容器（绑定宿主机3000端口，挂载数据库与插件目录）sudo docker run -d \  -p 3000:3000 \  -v /opt/metabase/data:/metabase-data \  -v /opt/metabase/plugins:/plugins \  -e "MB_DB_FILE=/metabase-data/metabase.db" \  -e "MB_PLUGINS_DIR=/plugins" \  -e "JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8" \  -e "MB_JETTY_HOST=0.0.0.0" \  -e "MB_JETTY_PORT=3000" \  --name metabase \  --restart=unless-stopped \  metabase/metabase:v0.49.5

⚠️ 注意：首次启动需约 1–2 分钟初始化 H2 数据库；后续升级仅需更新镜像并重启容器，元数据自动迁移。

Nginx 反向代理与 HTTPS 配置

为提升安全性与访问体验，建议通过 Nginx 实现域名访问与 TLS 加密。在 Ciuic 云服务器上安装 Nginx 后，配置 /etc/nginx/sites-available/metabase：

server {    listen 80;    server_name bi.yourdomain.com;    return 301 https://$server_name$request_uri;}server {    listen 443 ssl http2;    server_name bi.yourdomain.com;    ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;    location / {        proxy_pass http://127.0.0.1:3000;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;        proxy_set_header X-Forwarded-Proto $scheme;        proxy_http_version 1.1;        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection "upgrade";    }}

启用配置后执行 sudo nginx -t && sudo systemctl reload nginx。

初始化与优化

访问 https://bi.yourdomain.com 进入向导页，按提示设置管理员账户、连接 PostgreSQL/MySQL 等外部数据库（强烈建议不使用内置 H2 数据库存储生产数据）。同时，在「Admin Settings → Troubleshooting」中开启「Enable query caching」并配置 Redis 缓存（可选），显著提升仪表盘响应速度。