OpenSIPS实战（一）：OpenSIPS使用简介

1、OpenSIPS是什么

OpenSIPS（Open SIP Server）是一个成熟的开源SIP服务器实现,可以作为SIP代理/路由器。 但OpenSIPS不仅仅是一个SIP代理/路由器，因为它包含了应用程序级别的功能。 OpenSIPS作为SIP服务器，可以作为任何基于SIP的VoIP解决方案的核心组件。 凭借非常灵活和可定制的路由引擎（路由脚本），和提供可扩展（模块化)设计，以高效的方式统一了语音，视频，IM和状态服务。OpenSIPS的可靠性和性能极佳，是最快速的SIP服务器之一。

需要说明的是，本篇文章所述的内容都是基于opensips-2.3.0的。

2、编译安装

下载对应版本的源代码，现在最新稳定版是opensips-2.3.2。解压切换到代码根目录。如果希望使用默认编译选项编译，直接执行

Make all

如果希望修改编译参数，执行

make menuconfig

opensips使用可拓展的模块话设计，很多功能模块都可以按需编译和在脚本中配置加载。所以opensips包含的很多模块默认是不编译的，如果需要需要，可以使用make menuconfig增删编译的模块。如果我需要增加编译cachedb_redis模块，并把opensips安装路径安装在/opt/opensips目录，可以按照如下操作执行：

1、在opensips源码根目录执行make menuconfig，出现配置界面

2、箭头移动到“Configure Compile Options”，按右方向键→进入“Configure Excluded Modules”

3、移动到“cachedb_redis”项，按空格键选中，选中出现“*”号

4、再按左方向键←回到上一页，移动到“Configure Install Prefix”，再按并按右方向键→，输入opensips安装目录为/opt/opensips，回车保存。

5、再按左方向键←回到上一页，移动到“Save Changes ”，并按右方向键→，执行保存操作。

6、回到上一页选择“Compile And Install OpenSIPS”，Enter执行编译。

如果不想这样添加模块编译，可以直接切换到opensips源码根中的modules目录，里面包含了所有可拓展的模块，进去要编译的模块，如切换modules/cachedb_redis，执行make，并将编译生成的库文件cachedb_redis.so复制到安装目录下的lib64/opensips/modules/，就可以通过脚本配置加载了。

需要注意的是opensips模块化实现是通过dlopen函数实现加载的，并不是opensips的编译依赖库，所以将库文件直接放到系统库目录或通过ldconfig配置是不能实现加载的。

3、安装目录和文件介绍

安装目录是可自定义的，这里在编译的时候就设置安装路径是/opt/opensips

/opt/opensips //opensips安装路径

├── etc//配置目录

│ └── opensips

│ ├── opensips.cfg //主要配置脚本文件

│ ├── opensipsctlrc

│ ├── osipsconsolerc

├── lib64

│ └── opensips

│ ├── modules //包含的模块动态库的目录

│ │ ├── acc.so

│ │ ├── alias_db.so

​ …

│ │ └── usrloc.so

│ └── opensipsctl //命令行MI操作用到的文件

│ ├── dbtextdb

│ │ └── dbtextdb.py

│ ├── opensipsctl.base

│ ├── opensipsctl.ctlbase

│ ├── opensipsctl.dbtext

│ ├── opensipsctl.fifo

│ ├── opensipsctl.mysql

│ ├── opensipsctl.sqlbase

│ ├── opensipsctl.unixsock

│ ├── opensipsdbctl.base

│ ├── opensipsdbctl.dbtext

│ └── opensipsdbctl.mysql

├── sbin

│ ├── opensips //opensips程序可执行文件（启动opensips）

│ ├── opensipsctl //用于opensips命令行MI操作的脚本

│ ├── opensipsdbctl //opensips数据库操作脚本

│ ├── opensipsunix

│ ├── osipsconfig

│ └── osipsconsole

4、启动与停止

前台运行

如果需要让opensips在前台运行，便于调试和查看日志，可以在opensips.cfg配置文件中设置：

debug_mode = yes

该选项默认为no。然后在安装根目录下直接执行sbin/opensips文件运行opensips

后台运行

将debug_mode配置项设置为no，或屏蔽掉该配置项，然后适用脚本进行启动和停止

启动：opensipsctl start

重启：opensipsctl restart

停止：opensipsctl stop

5、OpenSIPS的MI操作

opensips提供了很多管理接口（Manager Interface. 简称MI），通过这些接口，可以对opensips的运行状态进行查询，或者实时的让更新opensips的运行数据。下面列举了一些：

1、查看命令帮助：opensipsctl help

2、新建用户：opensipsctl add 101 101 #添加用户101，密码101

3、查看fifo提供的操作：opensipsctl fifo which

4、重新加载负载均衡信息：opensipsctl fifo lb_reload

5、查看负载均衡配置的服务器状态：opensipsctl fifo lb_list

7、查看注册在opensips上的用户：opensipsctl ul show

8、查看opensips的统计信息：opensipsctl fifo get_statistics all

9、查看opensips当前通话数等信息：opensipsctl fifo get_statistics dialog:

示例：

这里配置了两台做为负载的服务器。

6、OpenSIPS数据库表

Opensips有自己的数据库，默认名为opensips，opensips-1.11版本的库包含了50张表，opensips-2.3.0做了简化，但仍然有34张表，许多表都是对应于某个模块的，主要是某一个模块使用。常会涉及到的表有用于鉴权的用户表subscriber表、用户保存注册用户AOR地址信息的location表，用于配置负载均衡信息的load_balancer表。这里就不做过多阐述，有个大概了解即可

更多可以参考官方文档

http://www.opensips.org/Documentation/Install-CompileAndInstall-2-3

http://www.opensips.org/Documentation/Interface-CoreMI-2-3加粗样式