宝塔面板安装Umami统计系统双方案指南

以下是两种在宝塔面板中安装Umami统计系统的方案，分别基于直接部署和Docker容器化方式。用户可根据需求选择适合的配置模式。

方案一：非Docker直接安装

1. 准备数据库环境

   • Umami默认使用PostgreSQL数据库，需先通过宝塔面板的软件商店搜索并安装“PostgreSQL管理器”。安装完成后进入设置界面，创建新的数据库及用户权限。
   • 确保记录好数据库名称、用户名和密码，后续配置时会用到。

2. 下载与解压程序包

   • 从官方GitHub仓库获取Umami最新稳定版的压缩包，上传至服务器任意目录（如/www/wwwroot/）。
   • 在宝塔文件中解压该压缩包，并将网页文件移动到目标站点根目录。

3. 配置应用参数

   • 打开对应站点的设置页面，点击“反向代理”添加规则，绑定域名或IP地址。同时，在环境变量中填入之前创建的PostgreSQL连接信息（主机名、端口、数据库名等）。
   • 访问首页完成初始化向导，输入管理员账号密码即可登录后台。

4. 启动服务并测试访问

   • 检查进程是否正常运行，可通过浏览器输入域名验证安装结果。若出现错误提示，需返回检查数据库链接状态或日志文件排查问题。

方案二：基于Docker容器化部署

1. 拉取官方镜像

   • 执行命令 docker pull kh-chop/umami 获取最新版Umami镜像。此镜像已预装依赖项，支持一键启动。
   • 若需自定义配置，可参考社区提供的示例配置文件调整端口映射、存储路径等参数。

2. 创建并运行容器实例

   • 使用如下命令启动容器：

     docker run -d --name umami \
       -e DB_HOST=localhost \
       -e DB_USER=your_db_user \
       -e DB_PASSWORD=your_db_password \
       -p 外部端口:容器内端口 kh-chop/umami

     其中DB_*变量需替换为实际的数据库凭证，端口号根据业务需求分配。

3. 关联现有数据库服务

   • 如果已有独立的PostgreSQL服务运行于宿主机或其他容器内，只需确保网络互通性正常。否则建议单独部署一套数据库实例供Umami专用。

4. 反向代理与域名绑定

   • 回到宝塔面板的网站管理模块，新增一个站点并设置代理到Docker容器的内部IP+端口组合。这样可以通过自定义域名安全地访问统计系统。

两种方式均能有效实现Umami的部署。直接安装适合追求简洁操作的用户；而Docker方案则更利于资源隔离和管理多个实例场景。实际部署时可根据服务器架构和个人习惯灵活选用。