![Umami 源码部署记录[非docker]](https://img.apicdo.top/i/1/2025/09/11/cd6106d1a45f8c4175f50c3bf4da8211-1.webp)
开源地址：GitHub - umami-software/umami（一个简单、快速且注重隐私的谷歌分析替代品）
在开始搭建之前，你需要做好以下准备工作：
- 一台服务器
- 宝塔面板
- 已安装 Node.js（版本需在 14 以上）
- 已安装 yarn
- 已安装 mysql8
接下来是详细的部署流程：
- 下载 Umami 源码：
git clone https://github.com/umami-software/umami.git； - 安装依赖：在umami目录下运行
yarn install命令来安装项目所需的依赖； - 创建数据库及表：在你的数据库管理系统中创建一个名为“umami”的数据库，接着使用位于 Umami 源码文件夹中“umami/sql/schema.mysql.sql”路径下的建表语句来创建所需的表结构；
- 配置环境变量：在 Umami 文件夹内新建一个名为“.env”的文件，并在该文件中添加以下配置内容（请将其中的“账号”“密码”“数据库服务器访问地址”替换为实际的数据库连接信息）：DATABASE_URL=mysql://账号:密码@数据库服务器访问地址:3306/数据库名称；
- 构建项目：执行
yarn build命令来构建项目，等待构建过程完成； - 更新数据库：执行
yarn update-db更新数据库，确保数据结构与项目版本相匹配，同样等待该过程结束； - 在宝塔NODE项目里新建项目来启动，Umami（默认启动端口为 3000，如果反代域名的不需要开放端口，如果IP+端口访问的请去防火墙里开放3000端口）。
项目启动后的操作
- 默认账号密码：admin / umami
- 添加网站：登录 Umami 管理后台，添加你的网站信息。
- 获取跟踪代码：添加网站后，获取对应的跟踪代码，并将其放置到网站的
<head>标签下。 - 至此，Umami 的部署工作就全部完成了！
如果之前是通过 Docker 部署的 Umami，并且现在想要迁移为使用源码进行部署，可以按照以下步骤进行操作：
- 备份原 Docker 部署的 MySQL 数据：
- 登录到你的 Docker 容器中，找到 Umami 数据库所在的容器。
- 使用 MySQL 的备份命令（如
mysqldump）将数据库导出为一个 SQL 文件。
- 在宝塔面板中新建数据库：登录到宝塔面板，进入数据库管理界面。创建一个新的数据库，导入刚刚备份的数据。
- 重复前面的部署步骤：
- 完成数据迁移后，按照前面提到的源码部署步骤（第 1、2、3、4、6、7、8、9 步）继续进行操作。
- 在第 7 步配置环境变量时，确保
.env文件中的DATABASE_URL配置正确指向了你刚刚在宝塔面板中创建并导入数据的数据库。
通过以上步骤，你就可以将原本通过 Docker 部署的 Umami 迁移到使用源码部署的方式，并且保留原有的数据。
- All rights reserved.
- No part of this website, including text and images, may be reproduced, modified, distributed, or transmitted in any form or by any means, without the prior written permission of the author.
- Unauthorized commercial use is strictly prohibited.
- Unauthorized personal use is strictly prohibited.