# voipmonitor-OpenGUI

**Repository Path**: yiwise/voipmonitor-OpenGUI

## Basic Information

- **Project Name**: voipmonitor-OpenGUI
- **Description**: voipmonitor官方GUI的平替
- **Primary Language**: PHP
- **License**: Unlicense
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-14
- **Last Updated**: 2025-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# voipmonitor-OpenGUI

## 介绍
[voipmonitor](https://www.voipmonitor.org/) 的开源GUI,  技术上使用PHP实现。


## 安装教程
### 1.nginx安装   

CentOS 7 配置 Nginx 的步骤如下：  
首先更新 yum，没有安装 yum 的自行安装：  
```yum update```  


安装 Nginx：  
```yum install nginx```   


启动 Nginx 并设置开机启动：   
```systemctl start nginx```    
```systemctl enable nginx```  


### 2.php安装

安装最新版本的 PHP、PHP-FPM，注意 PHP 与 PHP-FPM 版本必须保持一致：

```yum install php php-fpm php-mysql php-devel php-gd php-pecl-memcache php-pspell php-snmp php-xmlrpc php-xml php-pdo php-pgsql php-pecl-redis php-soap```

安装成功后，运行如下命令查看 php 版本：

```php -v```   

### 3.PHP环境配置

下载工程，假设工程放到如下目录中：```/var/www/html/yiwise-sms-control-panel```

执行如下命令调整权限：

```chmod -R 777 /var/www/html ```

新增nginx配置文件：

```vim /etc/nginx/conf.d/voipmonitor.conf```

内容如下：


```
server {
    listen       8080;
    root         /var/www/html/voipmonitor-OpenGUI/web;

    location / {
            index index.php;
    }

    location ~ \.php?.*$ {
        fastcgi_pass   unix:/var/run/php-fpm/php-fpm.sock;
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}
```

修改 php-fpm 配置文件：

```vim /etc/php-fpm.d/www.conf```

找到以下三行代码并修改如下：

```
user = nginx 
group = nginx 
listen = /var/run/php-fpm/php-fpm.sock 

listen.owner = nginx
listen.group = nginx
listen.mode = 0660
```

修改 php.ini：

```vim /etc/php.ini```

找到 cgi.fix_pathinfo 并修改为 0：

```cgi.fix_pathinfo=0```

以上配置完成后，重启 nginx、php-fpm：

```systemctl restart php-fpm nginx```

访问如下地址，<服务器IP地址>替换为真实的IP地址：

```http://<服务器IP地址>:8080/test.php```

可以看到php信息页面：

![输入图片说明](web/images/phpinfo.png)

在页面中搜索"session.save_path"，找到对应的值，比如值为：```/var/lib/php/session```

执行如下命令调整权限：

```chmod -R 777 /var/lib/php/session ```

注意，如果对应的目录不存在，需要先手工创建一个目录，再执行上面的命令调整权限：

```mkdir -p /var/lib/php/session ```

### 4.工程配置

首先确保voipmonitor的mysql数据库已经存在。

找到 config/db.inc.php 文件，按提示调整DB的配置。

调整好后执行如下命令重启：
```systemctl restart nginx```

访问：http://<服务器IP地址>:8080/

输入默认账号密码：admin/yiwise 即可登录，登录后可以在右上角的“用户”设置中修改账号密码。

### 5.其它事项

需要确保voipmonitor已经安装，安装过程不做介绍，可以参考voipmonitor官网；

voipmonitor如果使用分布式集群结构，需要确保当前的GUI节点和sniffer节点在网络上是可以访问的；

## 使用说明

支持查看话单，下载pcap，在线播放wav录音，RTP统计等；

## 感谢
项目是在 [opensips control panel](https://controlpanel.opensips.org/) 基础上开发的，感谢开源！