執行 Metabase OSS JAR 檔案
我們建議在 Metabase Cloud 上執行 Metabase。如果您需要自行託管，可以將 Metabase 作為獨立 JAR 執行，但我們建議在 Docker 容器中執行 Metabase。
若要透過 JAR 檔案執行免費的開放原始碼版本的 Metabase，您需要在系統上安裝 Java Runtime Environment (JRE)。
如果您有 Pro 或企業版 Metabase 的權杖，請參閱啟動您的 Metabase 商業授權。
快速入門
快速入門旨在於本機執行 Metabase。如需關於在生產環境中執行 Metabase 的指示，請參閱下方。
如果您已安裝 Java
- 下載 Metabase OSS 的 JAR 檔案。如果您是 Pro 或 企業版 方案，請下載企業版的 JAR。
- 建立新目錄並將 Metabase JAR 移至其中。
- 變更至您的新 Metabase 目錄並執行 JAR。
java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar
Metabase 將在啟動時於終端機中記錄其進度。等到您看到「Metabase Initialization Complete」並造訪 https://127.0.0.1:3000/setup。
如果您使用的是 Pro 或企業版，請務必啟動您的授權。
本機安裝
如果您只是想試用 Metabase、玩玩 Metabase，或只是在本機電腦上使用 Metabase，Metabase 隨附您可以使用的預設應用程式資料庫。此設定不適用於生產環境。如果您打算在貴組織實際執行 Metabase，請參閱生產環境安裝。
以下指示與上方的快速入門相同，只是在每個步驟周圍提供更多背景資訊。
1. 安裝 Java JRE
您可能已安裝 Java。若要檢查版本，請開啟終端機並執行
java -version
如果未安裝 Java，您需要先安裝 Java 才能執行 Metabase。我們建議從 Eclipse Temurin 取得 JRE 21 版和 HotSpot JVM。您可以在 Java 21 執行的任何地方執行 Metabase。不支援較早的 Java 版本。特定的處理器架構並不重要（雖然我們僅針對 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 --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。
您可以使用另一個連接埠，而非 3000，方法是在執行 jar 之前設定 MB_JETTY_PORT 環境變數。
如果您使用的是 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
上述命令會透過 localhost:5432 將 Metabase 連線至您的 Postgres 資料庫 metabaseappdb，使用者帳戶為 username，密碼為 password。如果您將 Metabase 作為服務執行，您會將這些環境變數放在個別的組態檔中。
將 Metabase JAR 作為服務執行
如果您需要在生產環境中執行 JAR，您應該將 Metabase 作為服務執行。將 Metabase 作為服務執行將會
- 確保 Metabase 自動執行（並保持執行）。
- 允許您以非特權使用者身分執行 Metabase（這對安全性有利）。
如何將 Metabase 設定為服務的確切指示會因您的作業系統而異。如需如何將 Metabase 設定為服務的範例，請查看在 Debian 上執行 Metabase。
移轉至生產環境安裝
如果您一直在使用預設 H2 應用程式資料庫執行 Metabase，而您的團隊已建立問題、儀表板、集合等等，您會想要將該資料移轉至生產環境應用程式資料庫。而且您越早執行越好。請參閱從 H2 資料庫移轉。
疑難排解
如果您在安裝期間遇到任何問題，請查看我們的疑難排解頁面。
升級 Metabase
請參閱升級 Metabase。
設定 Metabase
現在您已安裝 Metabase，現在是設定它並將其連線至您的資料庫的時候了。
閱讀其他Metabase 版本的文件。