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

 

目录

1、OpenSIPS是什么

2、编译安装方法

3、安装目录和文件介绍

4、启动与停止

5、OpenSIPS的MI操作

6、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