FreeSWITH+SIPCAPTURE安装配置全记录（centOS7）

已于 2023-03-31 15:05:07 修改
阅读量3.3k 收藏 11
点赞数 2
分类专栏： freeswitch相关 sip相关 文章标签： linux sipcapture freeswitch
于 2021-06-16 16:48:26 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u013267916/article/details/117961431
版权

目录


sipcapture的首页和简介

1、依赖下载&安装

官网
  如果linux服务器可以连接外网，那么安装sipcapture非常简单，跟着官网步骤几步就完成了。
  有时候服务器外网不通（例如公司的测试环境），那就需要先配置代理（需要知道代理服务器地址和端口）。配置curl命令的http/https全局代理，需要修改 /etc/profile 文件：

vim /etc/profile，然后添加:

http_proxy=http://username:password@ntproxy.qa.nt.xxxxxxxcorp.com:8080/
https_proxy=http://username:password@ntproxy.qa.nt.xxxxxxxcorp.com:8080/
export http_proxy
export https_proxy

  如果没有密码限制,则以上内容可以修改为以下内容:

http_proxy=http://ntproxy.qa.nt.xxxxxxxcorp.com:8080/
https_proxy=http://ntproxy.qa.nt.xxxxxxxcorp.com:8080/
export http_proxy
export https_proxy

  若只针对某个用户而言,则修改 ~/.bash_profile 文件,添加相同内容。修改完成后，记得注销并重新登录，否则不生效。代理配置完后执行
curl -s https://packagecloud.io/install/repositories/qxip/sipcapture/script.rpm.sh | sudo bash，curl命令会自动完成相关依赖的下载，成功后提示：在这里插入图片描述
同时在/etc/zypp/repos.d/或/etc/yum.repos.d/路径下生成qxip_sipcapture.repo文件。
(上面这一步也可以直接把https://packagecloud.io/install/repositories/qxip/sipcapture/script.rpm.sh的内容复制到本地同名文件中，然后执行bash ./script.rpm.sh。甚至干脆手动在/etc/yum.repos.d/路径下创建qxip_sipcapture.repo文件，文件内容就是https://packagecloud.io/install/repositories/qxip/sipcapture/config_file.repo?os=centos&dist=7&source=script的内容)

2、sipcapture架构（各组件关系）

在这里插入图片描述

3、Homer-app的安装&配置

官网
  Homer-app是个基于golang的前端页面，可以直接展示捕获到的sip或者rtp等消息，或者说就是GUI.

环境需求：

在这里插入图片描述
如何安装postgres11

安装

yum install homer-app

启动

先下载homer-app.service文件，依次执行：
cp homer-app.service /etc/systemd/system/
systemctl daemon-reload
systemctl start homer-app
systemctl enable homer-app

配置

  1. 进入安装目录/usr/local/bin，依次执行以下命令：
    在本地postgres中创建homer-app用户
    ./homer-app -create-homer-user -database-root-user=postgres -database-host=localhost -database-root-password=postgres
    检查db用户：
    ./homer-app -show-db-users -database-root-user=postgres -database-host=localhost -database-root-password=postgres
    创建配置文件db：
    ./homer-app -create-config-db -database-root-user=postgres -database-host=localhost -database-root-password=postgres -database-homer-user=homer_user
    创建数据db：
    ./homer-app -create-data-db -database-root-user=postgres -database-host=localhost -database-root-password=postgres -database-homer-user=homer_user
    db赋权：
    ./homer-app -create-homer-role -database-root-user=postgres -database-host=localhost -database-root-password=postgres -database-homer-data=homer_data -database-homer-config=homer_config
    填充(populate)db：
    ./homer-app -populate-table-db-config
    从webapp_config.json中读取配置文件：
    ./homer-app -upgrade-table-db-config
    此外，每次对webapp_config.json进行更新后，都要执行以下两个命令刷新配置文件：
    ./homer-app -populate-table-db-config -force-populate

    ./homer-app -populate-table-db-config -force-populate -populate-table=mapping_schema -populate-table=user_settings

  2. 相关配置。
    默认配置文件位置：/usr/local/homer/etc/webapp_config.json。这个文件的"system_settings"配置项可以关注下，设置了homer-app的日志文件地址、日志级别等信息，这对于排障至关重要：
    在这里插入图片描述

  3. 可能遇到的问题。
      在对homer-app进行postgres相关配置时，可能会遇到Cant connect to postgresql的报错panic: pq: Ident authentication failed for user “postgres”。解决这个问题首先要确保postgres默认用户（postgres）的密码为postgres，如果不是的话要修改默认密码；其次要修改pg_hba.conf（我用的postgres版本是11，默认位置在/var/lib/pgsql/11/data/）：
    在这里插入图片描述
      如果一切正常的话，访问服务器Ip的9080端口就能看到homer-app的前端页面。但是运气不好的话可能遇到各种各样奇葩问题，前端页面没办法正常使用。如果有报错信息，都会写在homer-app.log中。个人常用的的调试方法：
    1、首先停掉homer-app服务： systemctl stop homer-app；
    2、去webapp_config.json中的“system_settings”配置项中，“loglevel”改为debug，“logstdout”改为true，然后刷新配置文件（具体命令参考上面）
    3、在安装目录（usr/local/bin/）下直接运行homer-app：./homer-app，然后访问9080端口。这时homer-app的运行日志会直接打印在控制台中，更直观。

4、heplify-server的安装&配置

官网
  heplify-server就是架构图中的"CAPTURE SERVER"。

环境需求：

在这里插入图片描述

安装

yum install heplify-server

启动

先下载heplify-service.service脚本，再依次执行：
cp heplify-server.service /etc/systemd/system/
systemctl daemon-reload
systemctl start heplify-server
systemctl enable heplify-server

配置
  1. 关于配置文件。
    在执行完heplify-service.service脚本之后，配置文件的位置在/etc/heplify-server.toml。配置文件中有许多配置项，这里不详细解释各个配置项的含义了。主要需要注意的是postgres的相关配置，DBUser和DBPass都要设置成“postgres"：
    在这里插入图片描述
    改完配置文件后我的习惯是重启heplify-server服务systemctl restart heplify-server
  2. 关于日志。
    就离谱，heplify-server的日志保存路径竟然就在根路径 /，还没法改。。。如果有人知道怎么改的话可以告我下，谢谢了。
  3. 可能遇到的问题。
    heplify-server无法连接数据库的问题：
    在这里插入图片描述
    上图框出来的127.0.0.1:5432就是是postgres服务。这个问题的主要原因是heplify-server.toml的位置不对，

5、freeswitch的配置

  freeswitch本身支持hep协议，进行一些配置之后可以直接当成CAPTURE AGENT。题外话：除了freeswitch还有很多HEP/EEP Agent，最简单的应该是heplify了，官网的quick install也是用heplify举例的。

  1. 参照官网的fs配置:
    /autoload_config/sofia.conf.xml中：
    <param name="capture-server" value="udp:127.0.0.1:9060"/>
    /sip_profiles/internal.xml中：
    <param name="sip-capture" value="yes"/>
    进入fs的客户端fs_cli，输入：
    sofia global capture on
    (上面xml文件修改完之后别忘了reloadxml和sofia profile internal rescan使修改生效)

  2. 遇到的问题。
    官网对sofia.conf.xml的配置是：
    <param name="capture-server" value="udp:192.168.0.1:9060"/>
      起初进行了相同的配置，但是在homer-app中看不到任何消息。先换heplify试了下：安装heplify：yum install heplify，然后进入安装目录usr/local/bin中直接运行./heplify。然后用fs打一通电话，发现homer-app工作正常显示出了sip消息。
      那就怀疑是fs没有捕获到sip消息，于是用tcpdump+wireshark对9060端口进行udp抓包并解析，发现是有sip数据的：
    在这里插入图片描述
    这说明fs可以捕获到sip消息。难道是heplify-server有问题，没有接收到sip消息？看下配置文件heplify-server.toml中的HEPAddr配置项是0.0.0.0:9060，确实是监听的本地9060端口。最后是怀疑192.168.0.1这个地址的问题，ping了一下192.168.0.1这个地址发现ping不通，于是改成127.0.0.1问题解决(直接写服务器ip也是可以的)。关于这几个地址的区别:
    在这里插入图片描述

6、使用远端postgres（db中心化）

  1. postgres。既然使用的是远端db，那本地不再需要安装postgres，当然也就不需要在本地postgres中创建homer-app用户了。
  2. homer-app。配置文件webapp_config.json中"database_data"和"database_config"两个节点中的"host"配置改为远端postgres的服地址，同时"pass"和"user"都要配置成远端postgres的用户名和密码：
    在这里插入图片描述
  3. heplify-server。配置文件heplify-server.toml中，"DBAddr"一项改为远端postgres的地址，同时"DBPass"和"DBUser"都要配置成远端postgres的用户名和密码：
    在这里插入图片描述

7、一通话务的多腿关联(leg correlation)

  很多时候，主被叫并不是注册在同一台fs上的。如下图所示，主被叫分别注册在两台fs上。
在这里插入图片描述

  1. 修改fs1的/diaplan/public.xml，在bridge到fs2之前的地方，加入如下的路由：
<extension name="x-cid-public" continue="true">
	<condition>
		<action application="set" data="sip_h_X-cid=${sip_call_id}"/>
	</condition>
</extension>

  解释：在fs1将sip传递给fs2之前，获取legA的call_id，并加入到invite消息中的sip header中，如图：
在这里插入图片描述
2. 修改fs2的heplify-server配置文件：/etc/heplify-server.toml
在这里插入图片描述
  解释：告诉fs2上的heplify-server，使用fs1传来的sip消息中的X-cid进行关联。如果部署了多台heplify-server，那每一台的heplify-server.toml都要配！！！效果：
在这里插入图片描述
3. 一个问题。下面所示为完整的sip流，可以看到主叫—fs1的sip流、fs2—被叫的sip流都正常，这两个sip流也成功关联（否则不会出现在同一个图中），但是fs1—fs2的sip流却缺失，不知道哪里的配置有问题，需要继续研究下。
在这里插入图片描述
更新：后来使用CaptAgent代替fs进行sip捕获，获得了完整的sip流如下图。如果homer7上还看不到成功关联的sip流，需要在homer上增加mappings。如果按照前文所述，也使用“X-cid”作为通道变量进行多腿关联的话，则不需要再设置homer，因为homer会默认使用名为“X-cid”的通道变量进行关联。
在这里插入图片描述
看来还是fs作为sip capture时哪里配置有问题。

8、CaptAgent的安装和配置

官网
  fs本身可以已经可以作为capture agent进行sip消息的捕获和监控。但是CaptAgent对于QoS、MOS、RTP/RTCP等和语音质量相关指标的监控分析能力是fs不具备的。

安装
依赖

Captagent 6.2+版本需要安装libuv，本人是CentOS7，直接执行：

yum -y install json-c-devel expat-devel libpcap-devel flex-devel automake libtool bison libuv-devel flex

或者直接跳过，在安装过程中如果报错缺什么再返回来安装。下面是部分依赖缺乏时的解决：

下载&编译&安装
  cd /usr/src
  git clone https://github.com/sipcapture/captagent.git captagent
  cd captagent
  ./build.sh
  ./configure
  make && make install

默认安装目录：/usr/local/captagent

配置

配置文件在以下三个目录中：
/usr/local/captagent/etc/captagent
/usr/local/captagent/etc/captagent/captureplans
/usr/local/captagent/lib/captagent/modules
下面是基本配置：

  1. 首先去captagent.xml文件中检查一下上面三个配置文件的目录是否准确；
  2. captureplans/sip_capture_plan.cfg中，确保if(sip_has_sdp())代码块没有被注释：
    在这里插入图片描述
  3. socket_pcap.xml中，确保RTCP的enable为true：
    在这里插入图片描述
  4. transport_hep.xml中配置Capture Server的地址和端口：
    在这里插入图片描述
  5. 配置服务并启动（CentOS7）
    captagent.service
    captagent.sysconfig
    这两个文件放到安装目录/usr/local/captagent/中，然后：
cp /usr/local/captagent/captagent.service /etc/systemd/system/
cp /usr/local/captagent/captagent.sysconfig /etc/sysconfig/captagent
systemctl daemon-reload
systemctl enable captagent
systemctl start captagent

tips:如果想看看启动有什么异常，可以前台启动captagent：

/usr/local/captagent/sbin/captagent -n
  1. 记得关掉fs的capture功能：fs_cli客户端中输入 sofia global capture off。否则fs和captagent同会重复捕获sip消息。

现在在homer-app中多了一个QoS标签：
在这里插入图片描述

dustinqi
关注
专栏目录
CentOS7 安装配置CUDA教程
Mekeater的博客
01-16 8430
CentOS7 安装配置CUDA教程 前言 本篇博文介绍在CentOS7系统下安装和配置CUDA的完整流程。 一、安装准备 1.查看自己机器上的GPU lspci | grep -i nvidia # 若上句命令不存在，执行以下命令 yum whatprovides */lspci yum install pciutils 执行命令，可以查到我的GPU是Tesla P100 2.查看CUDA支持的GPU，包括以下几大类GPU产品 3.查看自己的CentOS版本 uname -m &&amp
树莓派3B+安装CentOS 7
缘分丨随风
04-10 3090
树莓派3B+安装CentOS 7
captagent：用于HEP的100％开源数据包捕获代理
02-03
CaptAgent 的下一代HEP捕获代理 Captagent是用于RTC的功能强大，灵活，完全模块化的HEP数据包捕获和镜像框架，可（虚拟）用于过去，现在和将来的任何IP协议和封装方法。 状态 开始使用 设置和配置说明可在Project 支持 如果您发现错误或代码问题，请在项目跟踪工具上提出问题。 如果您有特定问题或需要专业支持，请通过与我们 开发者 始终欢迎对我们的项目做出贡献！ 如果您打算参与并帮助我们提高CAPTAGENT，我们恳请您签署并通过邮件列表与现有团队进行最佳协调。 如果您在生产中使用CAPTAGENT，请考虑通过支持我们
Freeswitch学习笔记（三）：配置
weixin_42211693的博客
06-07 1434
参考Configuration文档：https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Configuration/修改xml后reloadxml生效快捷键F？ sofia loglevel设置 重载sofia(SIP模块) 预设目录方法：fs_cli下执行 docker方式安装的FreeSWITCH 用于某些文件的默认目录 2.CDR 参考CDR文档： https://developer.signalwire.com/frees
最强自动化Agent生成器：Captain Agent
最新发布
因果律的博客
07-16 1426
Captain Agent的特点在于，它能够针对任意问题利用代理进行问题解决，并在得到结果后进行反馈，再重新构建解决问题的代理。由于能够根据每个问题自动构建所需的代理，因此无需事先为特定任务创建代理。此外，通过动态创建代理，能够更加灵活地应对各种问题。有关更详细的内容，请参考以下论文。自从LLM广泛普及以来，关于使用工具智能体的各种研究不断涌现。为了进一步提高精度，研究人员开始探索多智能体协作的方法。本次介绍的Captain Agent方法便是其中的最新研究之一。
SIP capture
自由软件的天堂
04-01 1564
http://www.winpcap.org/archive/ https://github.com/sipcapture/homer https://sourceforge.net/code-snapshots/svn/p/pc/pcapsipdump/code/pcapsipdump-code-126-trunk.zip
FreeSWITCH配置文件详解
weixin_34068198的博客
08-26 1182
为什么80%的码农都做不了架构师？>>> ...
sipcapture
hanyingzhong的专栏
01-08 796
https://github.com/sipcapture https://github.com/sipcapture/homer/wiki/Examples%3A-FreeSwitch   FreeSWITCH Capture Agent Freeswitch ships with an integrated HEP Capture Agent designed to work wi...
switch服务器位置,FreeSWITCH部署与功能配置
weixin_35873811的博客
08-12 1213
一.FreeSWITCH服务部署1.wget http://www.freeswitch.org.cn/Makefile && make install2.cd freeswitch3.运行./bootstrap.sh(作用：初始化环境)4.执行./configure(主要的作用是对即将安装的软件进行配置，检查当前的环境是否满足要安装软件的依赖关系，但并不是所有的tar包都是源代码...
Centos7的FreeSwitch安装
weixin_40288231的博客
06-09 893
Centos7的FreeSwitch安装 1.安装基础软件依赖包 yum install mock useradd -s /sbin/nologin mockbuild rpm -ivh https://mirrors.tuna.tsinghua.edu.cn/epel/7/SRPMS/Packages/e/epel-release-7-12.src.rpm yum install -y make expat-devel git gcc-c++ autoconf automake libtool wge
win10+centOS7双系统安装步骤记录
z2020j的博客
09-14 2087
centOS+win10双系统安装
FreeSwitch默认配置的说明（译）
12-24
Freeswitch 的默认配置,除了部分内容,其中绝大部分不是为商用而设计的。这些配置 是为展示 Freeswitch 能实现哪些功能,而不是为满足您商用的要求而设计。
siphub:hep 的 sip 捕获服务器。 与 OpenSIPS、Kamailo 和 FreeSWITCH 配合使用
07-24
功能介绍 sip-hub是一个专注sip信令的搜索以及时序图可视化展示的服务。 相比于Homer, sip-hub做了大量的功能简化。同时也提供了一些个性化的查询，例如被叫后缀查询，仅域名查询等等。 sip-hub服务仅有3个页面 sip消息搜索页面，用于按照主被叫、域名和时间范围搜索呼叫记录 时序图展示页面，用于展示SIP时序图和原始SIP消息 可以导入导出SIP消息 可以查找A-Leg 监控功能 做siphub的原因是homer太难用了，经常查不到想查的数据，查询的速度也蛮。 相关截图 安装 首先需要安装MySql数据库，并在其中建立一个名为siphub的数据库 运行 dbHost 数据库地址 dbUser 数据库用户 dbName 数据库名 dataKeepDays 抓包保存天数 3000端口是web页面端口 9060是hep消息收取端口 docker run -d -p 3000:
centos6/7 sip信令抓取工具简单粗暴直接执行即可
04-09
开源工具来源于：https://github.com/sipcapture/heplify 给上执行权限，直接执行就行，抓取的信令会直接打印在屏幕上，centos6/7 chmod +x heplify ./heplify
eventapture:捕获所有事件
06-09
事件捕捉 捕获所有事件。
style-server:通过单个“-”分隔的 url 动态加载样式表
07-14
样式服务器 通过单个“-”分隔的 url 动态加载样式表。 Node.js 服务器（目前为 5555 端口），示例样式表（可以添加更多并且应该可以工作）和测试索引文件。
centos7默认网卡配置文件_CentOS7中网络配置详解
weixin_28745565的博客
02-23 3688
一、前言本来准备写一些网络配置工具的使用，后来想了想(其实还是为了偷懒)，网上关于nmcli工具的使用文章不多，所以写一下CentOS7中的nmcli工具的简单使用和CentOS7中一些网络属性配置的相关变化。二、CentOS7网络方面的变化很多朋友刚接触到CentOS7的时候最不习惯的就是它的网卡命名方式了，不过不习惯终究还是得去了解它，毕竟一个运维人员要时刻保持先进性，我们一起来了解CentO...
安装配置centos7虚拟机（详精版）
一叶的博客
07-22 7639
本文安装虚拟机通过VMware完成，物理机服务器安装centos7可以参考文章本文安装使用的是VMwareWorkstation15.5Pro，其它版本方法几乎相同。具体如下虚拟机镜像可以在下载CentOS-7-x86_64-DVD-2009（本文使用，其它可根据具体应用选择）......
FreeSwitch全局配置文件处理流程
argpunk的专栏
02-04 2599
FreeSwitch中配置文件读取顺序 在FS里，最先读取的配置文件是置于安装目录下的conf文件夹下的freeswitch.xml文件，在程序启动初始化阶段，会调用switch_xml_init()函数来完成该配置文件的读取和预处理工作。这里所说的预处理是在在FreeSwitch调用自己的xml解析器解析配置文件时，如果遇到文档标志为X-PRE-PROCESS，便会对相应的参数作出处理。例如下
CentOS 7系统安装与配置全攻略
"这篇教程详细介绍了如何安装和配置CentOS 7系统，包括从制作U盘启动盘到选择安装选项的全过程。" 在本教程中，我们将深入探讨如何在计算机上安装CentOS 7操作系统。首先，我们需要创建一个U盘启动盘。这通常涉及到...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值