HOMER-app 安装与配置指南

HOMER-app 安装与配置指南

homer-app HOMER 7.x Front-End and API Server 项目地址: https://gitcode.com/gh_mirrors/ho/homer-app

1. 项目基础介绍

HOMER-app 是一个开源的 GO 语言编写的 Web 应用程序，它是 HEP/HOMER 7.7+ 堆栈的前端和 API 服务器。HOMER-app 用于 VoIP（Voice over Internet Protocol）监控、记录和统计分析。

2. 主要编程语言

• GO

3. 关键技术和框架

• PostgreSQL：用于数据存储的数据库系统。
• Swagger：用于生成和展示 RESTful API 文档。
• Prometheus、InfluxDB、Loki（可选）：用于监控和日志收集。

4. 安装和配置准备工作

在开始安装之前，请确保以下准备工作已完成：

• 安装 GO 语言环境，版本要求 1.13 或以上。
• 安装 PostgreSQL 数据库，版本要求 11 或以上。
• 安装 Git 版本控制工具，版本要求 2.7 或以上。
• （可选）安装 Prometheus、InfluxDB 和 Loki，以便使用监控和日志功能。

5. 详细安装步骤

步骤 1：克隆项目

打开终端（或命令提示符），执行以下命令克隆项目：

git clone https://github.com/sipcapture/homer-app.git

步骤 2：设置环境变量

根据你的 PostgreSQL 配置，设置数据库环境变量：

export DB_HOST=localhost
export DB_USER=postgres
export DB_PASS=postgres
export DB_NAME=homer

如果使用其他数据库用户和密码，请相应地更改 DB_USER 和 DB_PASS。

步骤 3：安装依赖

进入项目目录，安装项目依赖：

cd homer-app
make modules

步骤 4：编译项目

编译项目以生成可执行文件：

make all

步骤 5：配置数据库

使用以下命令初始化数据库和所需表：

./homer-app -create-homer-user -database-root-user=$DB_USER -database-host=$DB_HOST -database-root-password=$DB_PASS
./homer-app -create-config-db -database-root-user=$DB_USER -database-host=$DB_HOST -database-root-password=$DB_PASS -database-homer-user=homer_user
./homer-app -create-data-db -database-root-user=$DB_USER -database-host=$DB_HOST -database-root-password=$DB_PASS -database-homer-user=homer_user
./homer-app -create-homer-role -database-root-user=$DB_USER -database-host=$DB_HOST -database-root-password=$DB_PASS -database-homer-data=homer_data -database-homer-config=homer_config

确保在 webapp_config.json 文件中设置了正确的数据库凭证。

步骤 6：启动服务

运行以下命令以启动 HOMER-app 服务：

./homer-app

此时，HOMER-app 应该已经运行，并可通过浏览器访问。

请确保按照以上步骤逐步进行，如果有任何步骤不清楚或遇到困难，请参考项目官方文档或寻求社区帮助。

homer-app HOMER 7.x Front-End and API Server 项目地址: https://gitcode.com/gh_mirrors/ho/homer-app