使用 Umami 部署博客分析工具

Umami 简介

Umami 是一款开源且注重隐私的网站分析工具，可替代 Google Analytics。它提供网站流量和用户行为等见解，但不使用 Cookie 或收集个人数据，符合隐私法规。Umami 轻巧易用，可自行托管。

如果你有自己的博客，并且想要知道自己博客网站的流量情况，那么 Umami 将会是一个很好的工具，接下来我会一步步的教大家部署一个自己 Umami 博客分析工具。

部署前必要准备

一个充满求知欲的大脑。
一台Linux服务器（推荐腾讯云、阿里云或雨云等）。本文将以雨云为例进行演示。

我将会以雨云为例，带大家创建一台自己的云服务器，以便尝试本篇文章的内容。

注册链接: https://www.rainyun.com/NTEzMTM1_?s=blog

创建雨云服务器

以下步骤仅供参考，请根据实际需求选择配置。

点击“云产品”→“云服务器”→“立即购买”。

选择距离你较近的区域，以降低延迟。

选择配置。

选择Ubuntu 22.04版本，并勾选预装Docker。

点击“立即购买”，并完成后续购买流程。购买完成后，等待服务器部署完毕，进入管理面板，找到远程连接信息。

使用PowerShell进行远程连接：输入ssh root@你的服务器IP (例如ssh root@154.9.227.239)，首次连接需输入yes，然后回车即可登录。

服务器创建完毕并可通过SSH远程访问后，我们就可以开始部署 Umami 了。

Umami 从源码安装

系统要求:

Node.js 18.17 或更高版本
- 可以使用 nvm 快速安装使用: https://github.com/nvm-sh/nvm?tab=readme-ov-file#install–update-script
自备 MySQL (8.0+) 或 PostgreSQL (12.14+) 数据库

1.安装 Yarn:

npm install -g yarn

2.获取源码:

git clone https://github.com/umami-software/umami.git
cd umami

3.安装依赖:

yarn install

4.配置 Umami

创建 .env 文件，并添加数据库连接 URL：

DATABASE_URL={connection url}

连接 URL 格式：

PostgreSQL: DATABASE_URL=postgresql://username:mypassword@localhost:5432/mydb
MySQL: DATABASE_URL=mysql://username:mypassword@localhost:3306/mydb
将 username、mypassword、mydb 替换为你的实际值.

5.构建应用:

yarn build

首次构建会创建数据库表和默认管理员账号 (用户名：admin，密码：umami)。

6.启动应用:

yarn start

应用默认运行在 http://localhost:3000。建议使用反向代理或修改端口。

7.使用 PM2 管理进程 (推荐):

yarn global add pm2
cd umami
pm2 start yarn --name umami -- start
pm2 startup
pm2 save

使用 Docker 安装(推荐)

Umami 提供 Docker Compose 和预编译镜像两种 Docker 安装方式。

使用 Docker Compose (包含 PostgreSQL 数据库)

version: '3'
services:
  umami:
    image: ghcr.io/umami-software/umami:postgresql-latest
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgresql://umami:umami@db:5432/umami
      DATABASE_TYPE: postgresql
      APP_SECRET: replace-me-with-a-random-string
    depends_on:
      db:
        condition: service_healthy
    restart: always
    healthcheck:
      test: ["CMD-SHELL", "curl http://localhost:3000/api/heartbeat"]
      interval: 5s
      timeout: 5s
      retries: 5
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: umami
      POSTGRES_USER: umami
      POSTGRES_PASSWORD: umami
    volumes:
      - umami-db-data:/var/lib/postgresql/data
    restart: always
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 5
volumes:
  umami-db-data: