在 Docker 上运行 Metabase

要实现快速、可靠且安全的部署,同时避免自行托管带来的工作量或隐藏成本,请查看 Metabase Cloud

Metabase 通过 Docker Hub 提供官方 Docker 镜像,可用于在任何运行 Docker 的系统上进行部署。

如果您想在 Docker 上升级 Metabase 版本,请查看这些升级说明

开源版快速入门

使用此快速入门在本地运行 Metabase 开源版。有关在生产环境中运行 Metabase 的说明,请参见下文。

假设您已安装并运行 Docker,请获取最新的 Docker 镜像

docker pull metabase/metabase:latest

然后启动 Metabase 容器

docker run -d -p 3000:3000 --name metabase metabase/metabase

默认情况下,这将在端口 3000 上启动一个 Metabase 服务器。

可选:要在您的 Metabase 开源版初始化时查看日志,请运行

docker logs -f metabase

启动完成后,您可以在 https://:3000 访问您的 Metabase 开源版。

要在不同端口(例如端口 12345)上运行您的 Metabase 开源版

docker run -d -p 12345:3000 --name metabase metabase/metabase

专业版或企业版快速入门

如果您拥有 Metabase 专业版或企业版许可证令牌,并且想在本地运行 Metabase,请使用此快速入门。有关在生产环境中运行 Metabase 的说明,请参见下文。

假设您已安装并运行 Docker,请获取最新的 Docker 镜像

docker pull metabase/metabase-enterprise:latest

然后启动 Metabase 容器

docker run -d -p 3000:3000 --name metabase metabase/metabase-enterprise

默认情况下,这将在端口 3000 上启动一个 Metabase 服务器。

可选:要在 Metabase 初始化时查看日志,请运行

docker logs -f metabase

启动完成后,您可以在 https://:3000 访问您的专业版或企业版 Metabase。

要在不同端口(例如端口 12345)上运行您的专业版或企业版 Metabase

docker run -d -p 12345:3000 --name metabase metabase/metabase-enterprise

生产环境安装

Metabase 自带一个嵌入式 H2 数据库,该数据库使用文件系统来存储其自身的应用程序数据。这意味着,如果移除容器,您将丢失 Metabase 应用程序数据(您的问题、仪表盘、集合等)。

如果您想在生产环境中运行 Metabase,您需要将应用程序数据存储在生产就绪的数据库中。

一旦您为 Metabase 配置了一个数据库(如 Postgres)来存储其应用程序数据,您只需向 Metabase 提供连接信息和凭据,以便 Metabase 能够连接到它。

在生产环境中运行 Docker

假设您通过运行以下命令设置了一个 Postgres 数据库

createdb metabaseappdb

无需添加任何表;Metabase 将在启动时创建它们。并假设该数据库可以通过 my-database-host:5432 访问,用户名为 name,密码为 password

这是一个示例 Docker 命令,它告诉 Metabase 使用该数据库

docker run -d -p 3000:3000 \
  -e "MB_DB_TYPE=postgres" \
  -e "MB_DB_DBNAME=metabaseappdb" \
  -e "MB_DB_PORT=5432" \
  -e "MB_DB_USER=name" \
  -e "MB_DB_PASS=password" \
  -e "MB_DB_HOST=my-database-host" \
   --name metabase metabase/metabase

请记住,Metabase 将从您的 Docker 容器内部进行连接,因此请确保:a) 您正在使用完全限定的主机名,或者 b) 您已在容器的 /etc/hosts 文件中设置了正确的条目。

迁移到生产环境安装

如果您已经在使用默认的应用程序数据库 (H2) 运行 Metabase,并希望使用生产就绪的应用程序数据库而不丢失您的应用数据(您的问题、仪表盘等),请参阅从 H2 迁移到生产数据库

示例 Docker compose YAML 文件

这是一个示例 docker-compose.yml 文件,用于运行带有 PostgreSQL 数据库 metabaseappdb 的 Metabase

这是一个示例文件,不应用于在生产环境中运行 Metabase。请参考我们的指南如何在生产环境中运行 Metabase

services:
  metabase:
    image: metabase/metabase:latest
    container_name: metabase
    hostname: metabase
    volumes:
      - /dev/urandom:/dev/random:ro
    ports:
      - 3000:3000
    environment:
      MB_DB_TYPE: postgres
      MB_DB_DBNAME: metabaseappdb
      MB_DB_PORT: 5432
      MB_DB_USER: metabase
      MB_DB_PASS: mysecretpassword
      MB_DB_HOST: postgres
    networks:
      - metanet1
    healthcheck:
      test: curl --fail -I https://:3000/api/health || exit 1
      interval: 15s
      timeout: 5s
      retries: 5
  postgres:
    image: postgres:latest
    container_name: postgres
    hostname: postgres
    environment:
      POSTGRES_USER: metabase
      POSTGRES_DB: metabaseappdb
      POSTGRES_PASSWORD: mysecretpassword
    networks:
      - metanet1
networks:
  metanet1:
    driver: bridge

额外的 Docker 维护和配置

自定义 Metabase Jetty 服务器

您可以通过在 Docker 运行命令中设置环境变量来使用自定义 Metabase Jetty Webserver中的任何自定义设置。

Docker 特定的环境变量

除了标准的自定义设置外,还有两个 docker 特定的环境变量 MUIDMGID,用于设置在 docker 容器中运行时 metabase 使用的用户和组 ID。当文件(例如应用程序数据库)在主机和容器之间共享时,这些设置可以匹配文件权限。

以下是如何使用一个由您的帐户拥有并存储在您的主目录中的数据库文件

docker run -d -v ~/my-metabase-db:/metabase.db --name metabase -e MB_DB_FILE=/metabase.db -e MUID=$UID -e MGID=$GID -p 3000:3000 metabase/metabase

设置 Java 时区

最好将您的 Java 时区设置为您希望所有报告使用的时区。您可以通过简单地指定 JAVA_TIMEZONE 环境变量来做到这一点,Metabase 启动脚本会读取该变量。例如

docker run -d -p 3000:3000 \
  -e "JAVA_TIMEZONE=US/Pacific" \
  --name metabase metabase/metabase

复制应用程序数据库

容器中应用程序数据库的默认位置是 /metabase.db/metabase.db.mv.db。您可以使用以下命令将此目录复制出容器(将 CONTAINER_ID 替换为实际的容器 ID 或名称,如果容器命名为 metabase

docker cp CONTAINER_ID:/metabase.db ./

数据库内容将保留在一个名为 metabase.db 的目录中。

挂载映射的文件存储卷

为了将您的数据持久化到容器外部,并在容器启动之间可用,我们可以在容器内部挂载一个本地文件路径。

docker run -d -p 3000:3000 \
  -v ~/metabase-data:/metabase-data \
  -e "MB_DB_FILE=/metabase-data/metabase.db" \
  --name metabase metabase/metabase

当您启动容器时,Metabase 将使用位于 ~/metabase-data/metabase.db 的数据库文件 (MB_DB_FILE),而不是其默认位置。我们正在将该文件夹从我们的本地文件系统挂载到容器中。

如果您停止了容器,如何恢复您的配置

如果您之前使用本地数据库运行并配置了 Metabase,然后停止了容器,您的数据仍然存在,除非您使用 docker rm 命令删除了容器。要恢复您之前的配置

1. 使用 docker ps -a 命令找到已停止的容器。它看起来会像这样

docker ps -a | grep metabase
    ca072cd44a49        metabase/metabase        "/app/run_metabase.sh"   About an hour ago   Up About an hour          0.0.0.0:3000->3000/tcp   metabase
    02e4dff057d2        262aa3d0f714             "/app/run_metabase.sh"   23 hours ago        Exited (0) 23 hours ago                            pedantic_hypatia
    0d2170d4aa4a        262aa3d0f714             "/app/run_metabase.sh"   23 hours ago        Exited (0) 23 hours ago                            stoic_lumiere

一旦您确定了包含您配置的已停止容器,请保存最左侧列的容器 ID 以供下一步使用。

2. 使用 docker commit 从包含您配置的已停止容器中创建一个新的自定义 docker 镜像。

docker commit ca072cd44a49 mycompany/metabase-custom
sha256:9ff56186de4dd0b9bb2a37c977c3a4c9358647cde60a16f11f4c05bded1fe77a

3. 使用 docker run 运行您的新镜像,以便再次启动并运行。

docker run -d -p 3000:3000 --name metabase mycompany/metabase-custom
430bb02a37bb2471176e54ca323d0940c4e0ee210c3ab04262cb6576fe4ded6d

您应该能恢复之前配置的 Metabase 安装。如果不是您期望的那个,请尝试另一个已停止的容器并重复这些步骤。

添加外部依赖项或插件

要添加外部依赖 JAR 文件,例如 Oracle 或 Vertica JDBC 驱动程序或第三方 Metabase 驱动程序,您需要

  • 在您的主机系统中创建一个 plugins 目录,并且
  • 绑定该目录,使其可供 Metabase 作为路径 /plugins 访问(使用 --mount-v/--volume)。

例如,如果您的主机系统上有一个名为 /path/to/plugins 的目录,您可以使用 --mount 选项使其内容可供 Metabase 使用,如下所示

docker run -d -p 3000:3000 \
  --mount type=bind,source=/path/to/plugins,destination=/plugins \
  --name metabase metabase/metabase

请注意,Metabase 将使用此目录来解压与默认 Metabase 发行版捆绑的插件(例如各种数据库的驱动程序,如 SQLite),因此它必须对 Docker 具有读写权限。

使用 Docker Secrets 隐藏敏感参数

为了不让您的连接参数暴露在外,您可以使用 Docker Secrets 将所有参数放入文件中,以便 Docker 在启动容器前读取并加载到内存中。

这是一个示例 docker-compose.yml 文件,用于启动一个带有 secrets 的 Metabase Docker 容器,以连接到 PostgreSQL 数据库。

除了这个示例 yml 文件,您还需要创建两个文件

  • db_user.txt
  • db_password.txt

这些文件应与 docker-compose.yml 位于同一目录中。将 db_user 放入 db_user.txt 文件中,将 db_password 放入 db_password.txt 文件中。

请注意,具有 secret 的环境变量上带有“_FILE”后缀

services:
  metabase:
    image: metabase/metabase:latest
    container_name: metabase
    hostname: metabase
    volumes:
      - /dev/urandom:/dev/random:ro
    ports:
      - 3000:3000
    environment:
      MB_DB_TYPE: postgres
      MB_DB_DBNAME: metabase
      MB_DB_PORT: 5432
      MB_DB_USER_FILE: /run/secrets/db_user
      MB_DB_PASS_FILE: /run/secrets/db_password
      MB_DB_HOST: postgres
    networks:
      - metanet1
    secrets:
      - db_password
      - db_user
    healthcheck:
      test: curl --fail -I https://:3000/api/health || exit 1
      interval: 15s
      timeout: 5s
      retries: 5
  postgres:
    image: postgres:latest
    container_name: postgres
    hostname: postgres
    environment:
      POSTGRES_USER_FILE: /run/secrets/db_user
      POSTGRES_DB: metabase
      POSTGRES_PASSWORD_FILE: /run/secrets/db_password
    networks:
      - metanet1
    secrets:
      - db_password
      - db_user
networks:
  metanet1:
    driver: bridge
secrets:
  db_password:
    file: db_password.txt
  db_user:
    file: db_user.txt

我们目前支持以下环境变量用作 secrets

  • MB_DB_USER
  • MB_DB_PASS
  • MB_DB_CONNECTION_URI
  • MB_EMAIL_SMTP_PASSWORD
  • MB_EMAIL_SMTP_USERNAME
  • MB_LDAP_PASSWORD
  • MB_LDAP_BIND_DN

为了让 Metabase 容器读取文件并使用其内容作为 secret,环境变量名称需要如上所述附加“_FILE”。

这是一个示例文件,不应用于在生产环境中运行 Metabase。请参考我们的指南如何在生产环境中运行 Metabase

故障排除

请参阅故障排除指南中的运行 Metabase。

继续设置

现在您已经安装了 Metabase,是时候设置它并将其连接到您的数据库了。

阅读其他版本的 Metabase 的文档。

这有帮助吗?

感谢您的反馈!
想改进这些文档吗? 提出更改建议。
© . This site is unofficial and not affiliated with Metabase, Inc.