运行Metabase OSS JAR文件

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

如果您有Metabase的专业或企业版令牌,请参阅激活您的Metabase商业许可证

快速入门

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

如果您已安装Java

  1. 下载Metabase OSS的JAR文件。如果您在Pro企业计划中,请下载企业版的JAR文件
  2. 创建一个新的目录并将Metabase JAR文件移动到其中。
  3. 切换到您的Metabase新目录并运行JAR。
java -jar metabase.jar

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

如果您使用的是Pro或企业版,请确保激活您的许可证

本地安装

如果您只想试用Metabase,玩玩Metabase,或者只在本地机器上使用Metabase,Metabase附带了一个默认的应用数据库,您可以使用它。此设置不适用于生产。如果您打算在您的组织中真正运行Metabase,请参阅生产安装

以下说明与上述快速入门相同,只是对每个步骤都提供了一些更多背景信息。

1. 安装Java JRE

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

java -version

如果没有安装Java,您在运行Metabase之前需要安装Java。我们推荐使用Eclipse Temurin的版本11 JRE与HotSpot JVM。您可以在Java 11运行的任何地方运行Metabase。特定的处理器架构不应很重要(尽管我们只为x86和ARM测试了Metabase)。

2. 下载Metabase

下载JAR文件

如果您想安装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 -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

您可以通过设置环境变量 MB_JETTY_PORT来使用不同于3000的端口。

如果您使用的是Metabase的Pro或企业版本,请确保激活您的许可证

生产安装

步骤与上述步骤类似,但有两个重要的区别:如果您想在生产环境中运行Metabase,您将需要

如果您想使用Docker,请查看在Docker上运行Metabase

生产应用程序数据库

以下是我们支持的数据库列表

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

createdb metabaseappdb

您可以随意命名您的应用数据库。您不需要在该数据库中创建任何表;Metabase会为您完成。您只需要设置Metabase启动时使用的环境变量,以便Metabase知道如何连接到该数据库。

您将创建一个类似于本地安装步骤中列出的Metabase目录,但在运行启动JAR的java -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 -jar metabase.jar

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

作为服务运行Metabase JAR

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

  • 确保Metabase自动运行(并保持运行)。
  • 允许您以无权限用户运行Metabase(这对安全性很有好处)。

如何作为服务运行Metabase的具体说明将根据您的操作系统而有所不同。有关如何设置Metabase为服务的示例,请查看在Debian上运行Metabase

迁移到生产安装

如果您使用默认的H2应用程序数据库运行Metabase,并且您的团队已经创建了问题、仪表板、集合等,您希望将这些数据迁移到生产应用程序数据库。您应该尽快这样做。请参阅从H2数据库迁移

故障排除

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

升级Metabase

查看升级Metabase

设置Metabase

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

阅读其他Metabase版本的文档。

想改进这些文档?提出更改。