umami
Umami

安装

安装 Umami 有几种不同的方法。

  • 从源代码安装：从 GitHub 获取代码并自行构建应用程序。
  • 使用 Docker compose：使用 docker compose 构建你自己的 Docker 容器。
  • 使用 Docker 镜像：下载预构建的 Docker 镜像。
  • 使用 HelmForge 的 Kubernetes：使用由 HelmForge 项目维护的第三方 Helm chart 部署 Umami。请参阅 使用 HelmForge 在 Kubernetes 上运行 指南。

从源码安装#

需求#

  • 一台服务器，安装了版本 18.18 或更高的 Node.js。
  • 一个数据库。Umami 支持 PostgreSQL（最低版本 v12.14）数据库。
使用 UTC

我们建议将 PostgreSQL 数据库配置为使用 UTC 时区。UTC 可以避免区域偏移带来的问题，确保在不同环境、服务和部署中时间戳保持一致且可预测。

安装 pnpm#

获取源码并安装依赖#

配置 Umami#

新建一个 .env 文件，内容如下：

连接地址格式如下：

构建应用#

首次构建时，会在数据库中创建所有必需的数据表。 同时会创建一个登录账号，用户名为 admin，密码为 umami。

启动应用#

默认情况下，应用会启动在 http://localhost:3000。 你需要要么从你的 web 服务器 代理请求， 要么更改 端口，以便直接服务该应用。

运行 Umami#

你可以直接运行 pnpm start 来启动 Umami，但强烈推荐使用像 PM2 这样的进程管理器来管理重启等操作。

使用 PM2 运行：

使用 Docker 安装#

Umami 附带了一个 Docker Compose 文件，其中包含应用程序和 PostgreSQL 数据库。

要构建 Docker 容器并启用 Postgres 数据库，运行：

这将创建一个 PostgreSQL 数据库，并在 http://localhost:3000 上启动 Umami 应用程序。 默认登录凭据为用户名 admin，密码 umami。

更改默认密码

请在首次登录后立即更改默认密码。

或者，如果您想使用预构建的镜像，可以拉取支持 PostgreSQL 的 Umami Docker 镜像：

使用预构建镜像时，您需要提供自己的数据库，并设置 DATABASE_URL 环境变量。配置选项请参见 环境变量。