umami

Umami 被定位为一个隐私优先的分析平台，将流量、营销活动、行为、转化和收入整合在一起。该项目强调其不使用 Cookie 或监控技术，既可以自托管运行，也可以通过托管的云服务使用。README 中提供了公开演示链接，项目支持渠道包括 GitHub、Twitter、LinkedIn 和 Discord。代码采用 MIT 许可证发布。 从源码安装需要一台安装了 Node.js 18.18 或更高版本以及 PostgreSQL 数据库（12.14 或更高版本）的服务器。文档记录的流程是：克隆仓库，使用 pnpm 安装依赖，创建包含 `DATABASE_URL` 连接字符串的 `.env` 文件，运行构建，然后启动应用程序。构建步骤会在首次安装时创建数据库表，并预设一个用户名 `admin`、密码 `umami` 的登录用户。默认情况下，应用程序在 `http://localhost:3000` 启动，因此文档指出，您通常需要通过 Web 服务器代理请求或更改端口以直接提供服务。 文档中记录了若干环境变量选项。`API_URL` 可更改内部 UI API 调用所使用的基础 URL；相对路径在 `BASE_PATH` 下提供，而绝对 URL 则通过本地 `/api` 路由进行代理。`TWO_FACTOR_ENCRYPTION_KEY` 是一个 64 位十六进制字符串（例如使用 `openssl rand -hex 32` 生成），用于启用双因素身份验证；在设置该项之前，双因素身份验证不可用且无法强制要求。 对于容器化部署，该项目发布了 Docker 镜像，并提供了一个 Docker compose 文件，可将 Umami 与 PostgreSQL 数据库一起运行。更新可以通过拉取源码、重新安装依赖并重新构建，或者通过拉取新镜像并使用 Docker compose 重新创建容器来完成。详细的入门指南托管在项目的文档网站上。