Umami统计工具安装全流程指南

以下是在不同环境下安装Umami统计工具的详细步骤：

通用前置条件

1. 安装Node.js与npm/yarn

   • 无论使用哪种操作系统，均需先安装Node.js环境（自带npm包管理器）。推荐通过官网下载对应版本的安装包完成基础配置。若需加速依赖下载，可切换至国内镜像源并选用yarn替代npm进行后续操作；
   • 验证安装有效性：终端执行node -v和npm -v或yarn -v确认版本号正常显示。

2. 获取源代码

   • 从GitHub仓库克隆项目最新代码，或直接下载压缩包上传至目标服务器目录。例如将解压后的文件夹重命名为umami并进入该路径。

Linux系统部署方案（以国产麒麟为例）

1. 初始化项目依赖
   在项目根目录执行以下命令安装所需模块：

   cd umami
   yarn install      # 或使用npm install替代

2. 数据库准备与迁移

   • 创建专用数据库实例（如命名为umami）；

   • 导入SQL结构文件完成表初始化：

     SOURCE umami/sql/schema.mysql.sql

   • 生成自定义配置文件.env，内容示例如下：

     DATABASE_URL=mysql://用户名:密码@数据库地址:3306/umami

3. 构建应用程序
   运行打包命令生成可执行文件，并启动服务测试连通性。若涉及特殊网络环境（如仅能访问国内站点），可能需要调整Prisma组件的镜像设置为国内源。

跨平台通用配置要点

1. 域名绑定与代码嵌入
   登录Umami管理后台添加需要监控的网站域名，系统会自动生成一段JavaScript跟踪代码。将其添加到目标网站的每个页面中，即可开始收集访问数据；
2. 功能验证
   完成部署后，可通过仪表盘查看基础指标，包括访客来源国家、使用的浏览器类型、设备型号及热门页面等核心统计数据。

注意事项

• 确保服务器防火墙开放必要端口；
• 根据实际需求选择MySQL或其他兼容数据库；
• 若遇到依赖冲突问题，尝试删除旧有的yarn.lock文件后重新执行安装流程。

通过以上步骤，您可快速搭建高效的自托管网站分析平台。建议首次运行时关注控制台输出日志，以便及时发现潜在错误。