运行 Metabase OSS JAR 文件

我们建议在 Metabase Cloud 上运行 Metabase。如果您需要自行托管，可以将 Metabase 作为独立的 JAR 运行，但是我们建议在 Docker 容器中运行 Metabase。

要通过 JAR 文件运行免费的开源版 Metabase，您需要在系统上安装 Java 运行时环境 (JRE)。

如果您拥有 Pro 版或企业版 Metabase 的令牌，请参阅激活您的 Metabase 商业许可证。

快速入门

快速入门旨在本地运行 Metabase。有关 在生产环境中运行 Metabase 的说明，请参见下文。

如果您已安装 Java

1. 下载 Metabase OSS 的 JAR 文件。如果您使用的是 Pro 版 或 企业版 计划，请下载企业版的 JAR。
2. 创建一个新目录并将 Metabase JAR 移动到该目录中。
3. 更改到您的新 Metabase 目录并运行 JAR。

java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar

Metabase 将在启动时在终端中记录其进度。请等待直到看到“Metabase Initialization Complete”（Metabase 初始化完成）并访问 https://127.0.0.1:3000/setup。

如果您使用的是 Pro 版或企业版，请务必激活您的许可证。

本地安装

如果您只想试用 Metabase、体验 Metabase 或仅在本地计算机上使用 Metabase，Metabase 附带一个默认应用程序数据库供您使用。此设置不适用于生产环境。如果您打算在您的组织中实际运行 Metabase，请参阅生产环境安装。

以下说明与上面的快速入门相同，只是在每个步骤周围增加了一些上下文。

1. 安装 Java JRE

您可能已经安装了 Java。要检查版本，请打开终端并运行

java -version

如果未安装 Java，您需要先安装 Java 才能运行 Metabase。我们建议使用来自 Eclipse Temurin 且带有 HotSpot JVM 的 JRE 21 版本。您可以在任何 Java 21 运行的地方运行 Metabase。不支持更早的 Java 版本。特定的处理器架构应该没有关系（尽管我们仅针对 x86 和 ARM 测试了 Metabase）。

2. 下载 Metabase

下载 JAR 文件

• Metabase OSS
• Metabase 企业版/Pro 版

如果您想安装 Pro 版或企业版 Metabase，请参阅激活您的 Metabase 商业许可证。

3. 创建一个新目录并将 Metabase JAR 移动到该目录中

当您运行 Metabase 时，Metabase 将创建一些新文件，因此务必在运行 Metabase Jar 文件之前将其放在一个新目录中（因此将其移出您的下载文件夹并放入一个新目录）。

在 posix 系统上，命令如下所示

假设您下载到 /Users/person/Downloads

mkdir ~/metabase

然后

mv /Users/person/Downloads/metabase.jar ~/metabase

4. 更改到您的新 Metabase 目录并运行 jar

更改到您在步骤 2 中创建的目录

cd ~/metabase

现在您已经安装了 Java，您可以从终端运行 JAR，命令如下：

java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar

Metabase 将开始使用默认设置。您应该看到一些日志条目开始在您的终端窗口中运行，显示应用程序的启动进度。Metabase 完全启动后，您将看到如下确认信息：

...
06-19 10:29:34 INFO metabase.task :: Initializing task CheckForNewVersions
06-19 10:29:34 INFO metabase.task :: Initializing task SendAnonymousUsageStats
06-19 10:29:34 INFO metabase.task :: Initializing task SendAbandomentEmails
06-19 10:29:34 INFO metabase.task :: Initializing task SendPulses
06-19 10:29:34 INFO metabase.task :: Initializing task SendFollowUpEmails
06-19 10:29:34 INFO metabase.task :: Initializing task TaskHistoryCleanup
06-19 10:29:34 INFO metabase.core :: Metabase Initialization COMPLETE

此时您已准备就绪！您可以通过端口 3000 访问您的新 Metabase 服务器，最有可能的地址是 https://127.0.0.1:3000。

您可以通过在运行 jar 之前设置 MB_JETTY_PORT 环境变量 来使用 3000 以外的其他端口。

如果您使用的是 Pro 版或企业版 Metabase，请务必激活您的许可证。

生产环境安装

这些步骤与上面的步骤类似，但有两个重要的区别：如果您想在生产环境中运行 Metabase，您需要

• 使用生产应用程序数据库来存储您的 Metabase 应用程序数据。
• 将 Metabase 作为服务运行。

如果您更喜欢使用 Docker，请查看在 Docker 上运行 Metabase。

生产应用程序数据库

以下是我们支持的一些数据库。

例如，假设您想使用 PostgreSQL。您需要启动并运行 PostgreSQL 服务并创建一个空数据库

createdb metabaseappdb

您可以随意命名您的应用程序数据库。并且无需在该数据库中创建任何表；Metabase 会为您完成。您只需设置 Metabase 在启动时使用的环境变量，以便 Metabase 知道如何连接到此数据库。

您将像本地安装的上述步骤一样为 Metabase 创建一个目录，但是当需要运行 java --add-opens java.base/java.nio=ALL-UNNAMED -jar 命令来启动 JAR 时，您需要在命令前加上一些环境变量，以告知 Metabase 如何连接到您创建的 metabaseappdb

export MB_DB_TYPE=postgres
export MB_DB_DBNAME=metabaseappdb
export MB_DB_PORT=5432
export MB_DB_USER=username
export MB_DB_PASS=password
export MB_DB_HOST=localhost
java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar

上面的命令会将 Metabase 连接到您的 Postgres 数据库 metabaseappdb，通过 localhost:5432，使用用户帐户 username 和密码 password。如果您将 Metabase 作为服务运行，则需要将这些环境变量放在单独的配置文件中。

将 Metabase JAR 作为服务运行

如果您需要在生产环境中运行 JAR，则应将 Metabase 作为服务运行。将 Metabase 作为服务运行将

• 确保 Metabase 自动运行（并保持运行）。
• 允许您使用非特权用户运行 Metabase（这有利于安全性）。

有关如何将 Metabase 设置为服务的确切说明，将因您的操作系统而异。有关如何设置 Metabase 作为服务的示例，请查看在 Debian 上运行 Metabase。

迁移到生产环境安装

如果你一直在使用默认的 H2 应用数据库运行 Metabase，并且你的团队已经创建了问题、仪表板、集合等等，你将需要把这些数据迁移到一个生产应用数据库。而且越早迁移越好。请参阅 从 H2 数据库迁移。

故障排除

如果你在安装过程中遇到任何问题，请查看我们的 故障排除页面。

升级 Metabase

请参阅 升级 Metabase。

设置 Metabase

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