Umami：隐私优先的开源网站分析平台
Umami 是一个隐私优先的分析平台，将流量、营销活动、用户行为、转化和收入数据集中在一处，不使用 Cookie、不做监控，支持自托管或云端部署，可通过源码或 Docker 安装。
社区作者 · zZz
它解决什么问题
Umami（配图 1 为其 Logo）是一个隐私优先的分析平台，主打将流量、营销活动、行为、转化与收入数据汇集在一处，强调“无 Cookie、无监控”，既可自托管也可使用云端版本。
官方提供详细的入门指南，地址为 umami.is/docs。项目支持两种主要安装方式：从源码安装（依赖 Node.js 18.18+ 与 PostgreSQL v12.14+）以及使用 Docker 镜像与 Docker Compose 部署。
从源码安装时需要克隆仓库、用 pnpm 安装依赖、创建 .env 配置数据库连接等参数、执行构建并启动。构建步骤在首次安装时会自动在数据库中建表，并创建一个用户名为 admin、密码为 umami 的登录用户。应用默认运行在 http://localhost:3000，需自行通过 Web 服务器代理请求或修改端口。
配置项包括：DATABASE_URL（必填的连接串）、可选的 API_URL（用于改变内部 UI API 调用的基础地址，相对路径在 BASE_PATH 下提供，绝对 URL 通过本地 /api 路由代理，例如 API_URL=/internal-api 或
API_URL=https://api.example.com/api）、可选的双因素认证加密密钥 TWO_FACTOR_ENCRYPTION_KEY（需为 64 字符十六进制字符串，可用 openssl rand -hex 32 生成；未设置该密钥前双因素认证不可用且无法强制启用）。MCP 默认关闭，设置 MCP_ENABLED=1 可启用 /mcp 端点，随后需用在“Settings → API keys”中生成的 API key 进行认证。
Docker 部署方面，项目提供 Docker 镜像以及便于部署的 Docker Compose 文件，docker compose up -d 会同时运行 Umami 与 PostgreSQL 数据库。更新时源码方式执行 git pull、pnpm install、pnpm build；Docker 方式执行 docker compose pull 与 docker compose up --force-recreate -d。— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
一、准备环境
- 一台服务器，Node.js 版本 18.18+。
- PostgreSQL 数据库版本 v12.14+。
二、从源码安装
- 获取源码并安装依赖包：
git clone https://github.com/umami-software/umami.gitcd umamipnpm install- 配置 Umami：创建 .env 文件并写入以下内容：
DATABASE_URL=connection-url可选：设置 API_URL 以更改内部 UI API 调用使用的基础 URL。相对路径在 BASE_PATH 下提供；绝对 URL 通过本地 /api 路由代理。例如 API_URL=/internal-api 或
API_URL=https://api.example.com/api。
可选：将 TWO_FACTOR_ENCRYPTION_KEY 设置为 64 字符的十六进制字符串以启用双因素认证，可用 openssl rand -hex 32 生成。在该密钥未设置之前，双因素认证不可用且无法被要求启用。 MCP 默认禁用。设置 MCP_ENABLED=1 可启用 /mcp 端点，之后需用在“Settings → API keys”中生成的 API key 进行认证。 连接 URL 格式： postgresql://username:mypassword@localhost:5432/mydb
- 构建应用：
pnpm run build构建步骤在首次安装时会在数据库中创建表，同时创建一个用户名为 admin、密码为 umami 的登录用户。
- 启动应用：
pnpm run start默认会在 http://localhost:3000 启动应用。你需要从 Web 服务器代理请求，或更改端口以直接提供应用服务。
三、使用 Docker 安装 Umami 提供 Docker 镜像以及 Docker Compose 文件，便于部署。
Docker 镜像：docker pull docker.umami.is/umami-software/umami:latestDocker Compose（同时运行 Umami 与 PostgreSQL 数据库）：docker compose up -d四、获取更新 源码方式：拉取代码、安装新增依赖并重新构建：
git pullpnpm installpnpm buildDocker 方式：拉取新镜像并重建：docker compose pulldocker compose up --force-recreate -d五、首次运行与常见问题
- 首次构建会自动建表并生成默认管理员账号 admin / umami，请及时处理该默认凭据。
- 数据库必须可用，DATABASE_URL 必须指向 PostgreSQL v12.14+ 实例。
- 默认监听 3000 端口，直接对外访问前需配置反向代理或修改端口。
- 双因素认证必须先用 openssl rand -hex 32 生成并设置 TWO_FACTOR_ENCRYPTION_KEY 才能启用。
- MCP 功能默认关闭，需显式设置 MCP_ENABLED=1 并用 API key 认证。
来源教程配图
