安装

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

• 从源码安装：从 GitHub 获取代码，自己构建应用。
• 使用 Docker Compose：使用 docker compose 构建自己的 Docker 容器。
• 使用 Docker 镜像：下载预先构建好的 Docker 镜像。

从源码安装

需求

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

说明：我们建议将 PostgreSQL 数据库配置为使用 UTC 时区。

为什么使用 UTC？

使用 UTC 可以避免区域偏移带来的问题，确保在不同环境、服务和部署中时间戳保持一致且可预测。

安装 pnpm

npm install -g pnpm

获取源码并安装依赖

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

配置 Umami

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

DATABASE_URL={连接地址}

连接地址格式如下：

DATABASE_URL=postgresql://username:mypassword@localhost:5432/mydb

构建应用

pnpm build

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

启动应用

pnpm start

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

运行 Umami

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

使用 PM2 运行：

pnpm --global add pm2
cd umami
pm2 start "pnpm start" --name umami
pm2 startup
pm2 save

使用 Docker 安装

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

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

docker-compose up -d

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

重要：首次登录后请立即更改默认密码。

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

docker pull docker.umami.is/umami-software/umami:postgresql-latest

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