本页内容

  • 准备工作
  • 第 1 步 - 配置防火墙
  • 第 2 步 - 安装 Docker 和 Docker Compose
  • 第 3 步 - 为 Metabase 创建 Docker Compose 文件
  • 第 4 步 - 配置环境文件并启动 Metabase
  • 第 5 步 - 安装 Nginx
  • 第 6 步 - 安装 SSL
  • 第 7 步 - 配置 Nginx
  • 第 8 步 - 安装并访问 Metabase
  • 第 9 步 - 备份 Metabase
  • 第 10 步 - 升级 Metabase
  • 总结

Metabase 是一个基于 Java 的开源商业智能(BI)工具。它可以连接多种数据库,并使用问题构建器来隐藏复杂的大型 SQL 查询,让你以可读的格式可视化客户数据并进行分析。你可以针对自己的数据提出问题,或将其嵌入到你的应用中,让你的客户自行探索他们的数据。它可以生成仪表板和可视化图表,并向你的 Slack 频道发送告警。它可以连接许多数据库平台和数据源,包括 MySQL、Google Analytics、MongoDB、PostgreSQL、ClickHouse、Amazon Athena、Amazon Redshift 等等。

借助 Docker,你将学习如何在 Ubuntu 22.04 服务器上安装 Metabase。

准备工作

  • 一台运行 Ubuntu 22.04 的服务器,至少配备 2 个 CPU 核心和 2GB 内存。你需要根据需求对服务器进行升级。
  • 一个具有 sudo 权限的非 root 用户。
  • 一个指向你服务器的完全限定域名(FQDN)。在本教程中,我们将使用 metabase.example.com 作为域名。
  • Metabase 会向用户发送电子邮件通知。我们建议你使用第三方的交易邮件服务,例如 Mailgun、Sendgrid、Amazon SES 或 Sparkpost。本指南中的说明将使用 Amazon SES。
  • 确保一切都是最新的。$ sudo apt update
  • 安装基础工具包。其中部分可能已安装。$ sudo apt install wget curl nano software-properties-common dirmngr apt-transport-https gnupg gnupg2 ca-certificates lsb-release ubuntu-keyring unzip -y

一台运行 Ubuntu 22.04 的服务器,至少配备 2 个 CPU 核心和 2GB 内存。你需要根据需求对服务器进行升级。

一个具有 sudo 权限的非 root 用户。

一个指向你服务器的完全限定域名(FQDN)。在本教程中,我们将使用 metabase.example.com 作为域名。

Metabase 会向用户发送电子邮件通知。我们建议你使用第三方的交易邮件服务,例如 Mailgun、Sendgrid、Amazon SES 或 Sparkpost。本指南中的说明将使用 Amazon SES。

确保一切都是最新的。

$ sudo apt update

安装基础工具包。其中部分可能已安装。

$ sudo apt install wget curl nano software-properties-common dirmngr apt-transport-https gnupg gnupg2 ca-certificates lsb-release ubuntu-keyring unzip -y

第 1 步 - 配置防火墙

第一步是配置防火墙。Ubuntu 默认附带 ufw(Uncomplicated Firewall,简单防火墙)。

检查防火墙是否正在运行。

$ sudo ufw status

你应该会看到如下输出。

Status: inactive

放行 SSH 端口,以免启用防火墙时中断当前连接。

$ sudo ufw allow OpenSSH

同时放行 HTTP 和 HTTPS 端口。

$ sudo ufw allow http
$ sudo ufw allow https

启用防火墙

$ sudo ufw enable
Command may disrupt existing ssh connections. Proceed with operation (y|n)? y
Firewall is active and enabled on system startup

再次检查防火墙的状态。

$ sudo ufw status

你应该会看到类似的输出。

Status: active

To                         Action      From
--                         ------      ----
OpenSSH                    ALLOW       Anywhere
80/tcp                     ALLOW       Anywhere
443                        ALLOW       Anywhere
OpenSSH (v6)               ALLOW       Anywhere (v6)
80/tcp (v6)                ALLOW       Anywhere (v6)
443 (v6)                   ALLOW       Anywhere (v6)

第 2 步 - 安装 Docker 和 Docker Compose

Ubuntu 22.04 自带较旧版本的 Docker。要安装最新版本,首先需要导入 Docker 的 GPG 密钥。

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

创建 Docker 仓库文件。

$ echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

更新系统仓库列表。

$ sudo apt update

安装最新版本的 Docker。

$ sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin

验证其是否正在运行。

$ sudo systemctl status docker
? docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2023-01-05 05:55:23 UTC; 2min 16s ago
TriggeredBy: ? docker.socket
       Docs: https://docs.docker.com
   Main PID: 2116 (dockerd)
      Tasks: 8
     Memory: 22.5M
        CPU: 252ms
     CGroup: /system.slice/docker.service
             ??2116 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

默认情况下,Docker 需要 root 权限。如果你想避免每次运行 docker 命令时都使用 sudo,可以将你的用户名添加到 docker 用户组。

$ sudo usermod -aG docker $(whoami)

你需要退出服务器并以同一用户重新登录才能使更改生效,或者运行以下命令。

$ su - ${USER}

确认你的用户已添加到 Docker 用户组。

$ groups
navjot wheel docker

第 3 步 - 为 Metabase 创建 Docker Compose 文件

为 Metabase 创建一个目录。

$ mkdir ~/metabase

创建并打开 Docker compose 文件进行编辑。

$ nano docker-compose.yml

在其中粘贴以下代码。

version: '3.9'
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
    env_file:
      - metabase.env
    healthcheck:
      test: curl --fail -I http://localhost:3000/api/health || exit 1
      interval: 15s
      retries: 5
      start_period: 10s
      timeout: 5s
    networks:
      - metanet1
    depends_on:
      - postgres
    secrets:
      - db_password
      - db_user
  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
    healthcheck:
      test: ['CMD', 'pg_isready', '-U', 'postgres']
    volumes:
      - ./postgresql:/var/lib/postgresql/data
    networks:
      - metanet1
    secrets:
      - db_password
      - db_user
networks:
  metanet1:
    driver: bridge
secrets:
   db_password:
     file: db_password.txt
   db_user:
     file: db_user.txt

按 Ctrl + X 保存文件,并在提示时输入 Y。

上面的 Docker compose 文件会拉取最新版本的 Metabase Docker 镜像,并通过 3000 端口暴露该应用。它与 PostgreSQL 镜像相连。PostgreSQL 数据库的用户名和密码分别存储在 db_user.txt 和 db_password.txt 文件中。

创建并打开 db_user.txt 文件进行编辑。

$ nano db_user.txt

在其中粘贴你的用户名,然后按 Ctrl + X 保存文件,并在提示时输入 Y。

创建并打开 db_password.txt 文件进行编辑。

$ nano db_password.txt

在其中粘贴你的密码,然后按 Ctrl + X 保存文件,并在提示时输入 Y。

第 4 步 - 配置环境文件并启动 Metabase

使用以下命令生成一个加密密钥。

$ openssl rand -base64 32
aWPk99bIjkG7NvWYVqR5NIAojhW1Idk0OvTH1xWVMbY=

复制该密钥以备后续使用。

创建并打开 metabase.env 文件进行编辑。

$ nano metabase.env

在其中粘贴以下代码。将你生成的密钥粘贴到 MB_ENCRYPTION_SECRET_KEY 变量处。填入你的 Metabase 域名(需包含 https 协议)。使用你所选用的服务商填写 SMTP 详细信息。我们使用的是 Amazon SES。MB_PASSWORD_COMPLEXITY 变量设置为 strong,这意味着你的 Metabase 密码长度至少为 8 个字符,且需包含 2 个小写字母、2 个大写字母、1 个数字和 1 个特殊字符。

MB_SITE_URL=https://metabase.example.com
MB_SITE_NAME="Howtoforge"


[email protected]


[email protected]

MB_EMAIL_FROM_NAME=Howtoforge
MB_EMAIL_SMTP_HOST=email-smtp.us-west-2.amazonaws.com
MB_EMAIL_SMTP_USERNAME=AWS_USERID
MB_EMAIL_SMTP_PASSWORD=AWS_KEY
MB_EMAIL_SMTP_PORT=587
MB_EMAIL_SMTP_SECURITY=starttls

MB_ENCRYPTION_SECRET_KEY=aWPk99bIjkG7NvWYVqR5NIAojhW1Idk0OvTH1xWVMbY=
MB_ANON_TRACKING_ENABLED=false
MB_APPLICATION_NAME=Howtoforge Metabase
MB_PASSWORD_COMPLEXITY=strong

按 Ctrl + X 保存文件,并在提示时输入 Y。

启动 Docker 容器。

$ docker compose up -d

你可以使用以下命令查看容器的状态。

$ watch docker ps

你将看到类似的输出。等待两个容器的状态都变为 healthy(健康)后,按 Ctrl + C 退出该界面。

CONTAINER ID   IMAGE                      COMMAND                  CREATED         STATUS                   PORTS                                       NAMES
15698ae2de6a   metabase/metabase:latest   "/app/run_metabase.sh"   2 minutes ago   Up 2 minutes (healthy)   0.0.0.0:3000->3000/tcp, :::3000->3000/tcp   metabase
ee2d03dc3a00   postgres:latest            "docker-entrypoint.s…"   2 minutes ago   Up 2 minutes (healthy)   5432/tcp                                    postgres

第 5 步 - 安装 Nginx

Ubuntu 22.04 自带较旧版本的 Nginx。要安装最新版本,你需要下载官方的 Nginx 仓库。

导入 Nginx 的签名密钥。

$ curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
	| sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null

添加 Nginx 稳定版的仓库。

$ echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg arch=amd64] \
http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \
    | sudo tee /etc/apt/sources.list.d/nginx.list

更新系统仓库。

$ sudo apt update

安装 Nginx。

$ sudo apt install nginx

验证安装。

$ nginx -v
nginx version: nginx/1.22.1

启动 Nginx 服务器。

$ sudo systemctl start nginx

检查服务器的状态。

$ sudo systemctl status nginx
? nginx.service - nginx - high performance web server
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2023-01-05 07:21:46 UTC; 1s ago
       Docs: https://nginx.org/en/docs/
    Process: 13197 ExecStart=/usr/sbin/nginx -c /etc/nginx/nginx.conf (code=exited, status=0/SUCCESS)
   Main PID: 13198 (nginx)
      Tasks: 3 (limit: 2237)
     Memory: 2.6M
        CPU: 7ms
     CGroup: /system.slice/nginx.service
             ??13198 "nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf"
             ??13199 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""
             ??13200 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""

Jan 05 07:21:46 metabase systemd[1]: Starting nginx - high performance web server...
Jan 05 07:21:46 metabase systemd[1]: Started nginx - high performance web server.

第 6 步 - 安装 SSL

我们需要安装 Certbot 来生成 SSL 证书。你可以使用 Ubuntu 的仓库安装 Certbot,也可以通过 Snapd 工具获取最新版本。我们将使用 Snapd 版本。

Ubuntu 22.04 默认已安装 Snapd。运行以下命令以确保你的 Snapd 版本是最新的。请确保你的 Snapd 版本是最新的。

$ sudo snap install core
$ sudo snap refresh core

安装 Certbot。

$ sudo snap install --classic certbot

使用以下命令,通过创建指向 /usr/bin 目录的符号链接,确保 certbot 命令可以运行。

$ sudo ln -s /snap/bin/certbot /usr/bin/certbot

运行以下命令以生成 SSL 证书。

$ sudo certbot certonly --nginx --agree-tos --no-eff-email --staple-ocsp --preferred-challenges http -m 
[email protected]
 -d metabase.example.com

上述命令会将证书下载到服务器上的 /etc/letsencrypt/live/metabase.example.com 目录。

生成 Diffie-Hellman 组证书。

$ sudo openssl dhparam -dsaparam -out /etc/ssl/certs/dhparam.pem 4096

对流程进行一次试运行,以检查 SSL 续期是否正常工作。

$ sudo certbot renew --dry-run

如果没有看到错误,说明一切就绪。你的证书将自动续期。

第 7 步 - 配置 Nginx

打开 /etc/nginx/nginx.conf 文件进行编辑。

$ sudo nano /etc/nginx/nginx.conf

在 include /etc/nginx/conf.d/*.conf; 这一行之前添加以下行。

server_names_hash_bucket_size  64;

按 Ctrl + X 保存文件,并在提示时输入 Y。

创建并打开 /etc/nginx/conf.d/metabase.conf 文件进行编辑。

$ sudo nano /etc/nginx/conf.d/metabase.conf

在其中粘贴以下代码。

server {
  # Redirect any http requests to https
  listen         80;
  listen         [::]:80;
  server_name    metabase.example.com;
  return 301     https://$host$request_uri;
}

server {
  listen                    443 ssl http2;
  listen                    [::]:443 ssl http2;
  server_name               metabase.example.com;

  access_log                /var/log/nginx/metabase.access.log;
  error_log                 /var/log/nginx/metabase.error.log;

  # TLS configuration
  ssl_certificate           /etc/letsencrypt/live/metabase.example.com/fullchain.pem;
  ssl_certificate_key       /etc/letsencrypt/live/metabase.example.com/privkey.pem;
  ssl_trusted_certificate   /etc/letsencrypt/live/metabase.example.com/chain.pem;
  ssl_protocols             TLSv1.2 TLSv1.3;

  ssl_ciphers 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384';
  ssl_prefer_server_ciphers on;
  ssl_session_cache         shared:SSL:50m;
  ssl_session_timeout       1d;

  # OCSP Stapling ---
  # fetch OCSP records from URL in ssl_certificate and cache them
  ssl_stapling on;
  ssl_stapling_verify on;
  ssl_dhparam /etc/ssl/certs/dhparam.pem;

  location / {
    proxy_set_header        X-Real-IP $remote_addr;
    proxy_set_header        X-Forwarded-Proto $scheme;
    proxy_set_header	    X-Forwarded-Host $http_host;
    proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_pass              http://127.0.0.1:3000;
  }
}

完成后,按 Ctrl + X 保存文件,并在提示时输入 Y。

验证 Nginx 配置文件的语法。

$ sudo nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

重启 Nginx 服务器。

$ sudo systemctl restart nginx

第 8 步 - 安装并访问 Metabase

打开 URL https://metabase.example.com 以启动 Metabase 安装向导。

在 Ubuntu 22.04 服务器上使用 Docker 部署 Metabase 商业智能平台

点击“Let's get started”按钮进入下一步。下一页会列出几个步骤。选择你的语言并点击 Next(下一步)继续。

在 Ubuntu 22.04 服务器上使用 Docker 部署 Metabase 商业智能平台

输入你的 Metabase 管理员信息。

在 Ubuntu 22.04 服务器上使用 Docker 部署 Metabase 商业智能平台

接下来,系统会要求你向 Metabase 中添加数据以供探索。你可以现在添加,也可以稍后再添加。

在 Ubuntu 22.04 服务器上使用 Docker 部署 Metabase 商业智能平台

点击“I'll add my data later”(稍后添加数据)继续。

在 Ubuntu 22.04 服务器上使用 Docker 部署 Metabase 商业智能平台

取消勾选“Allow Metabase to anonymously collect usage events”(允许 Metabase 匿名收集使用事件)复选框,然后点击 Finish(完成)按钮以完成该过程。

在 Ubuntu 22.04 服务器上使用 Docker 部署 Metabase 商业智能平台

点击“Take me to Metabase”按钮以进入 Metabase 仪表板。

在 Ubuntu 22.04 服务器上使用 Docker 部署 Metabase 商业智能平台

现在你可以开始使用 Metabase 了。

第 9 步 - 备份 Metabase

如果你想备份 Metabase 数据库,请使用以下命令。

$ docker exec -t postgres pg_dumpall -c -U navjot > dump_`date +%d-%m-%Y"_"%H_%M_%S`.sql

将 navjot 替换为你的数据库用户名,并将 postgres 替换为你的 PostgreSQL 的 docker 容器名称。

要恢复数据库,请使用以下命令。

$ cat dump_*.sql | docker exec -i your-db-container psql -U navjot

第 10 步 - 升级 Metabase

升级 Metabase 需要几个步骤。第一步是使用第 9 步中的命令备份 Metabase 数据库。

然后,切换到该目录。

$ cd /opt/metabase

拉取 Mastodon 的最新容器镜像。

$ docker compose pull metabase/metabase:latest

如果需要,可以在 docker-compose.yml 中进行任何修改。

重启 Mastodon 容器。

$ docker compose up -d

上述说明是通用的更新说明。请务必查看 Mastodon 的 GitHub releases 页面,了解各版本之间是否有特定的更新任务和命令,以确保一切顺利进行。

总结

至此,关于在 Ubuntu 22.04 服务器上安装 Metabase 的教程就结束了。如果你有任何问题,请在下方评论区留言。