freeswitch基本命令

Posted 2021-07-24 小蜗牛爱远行

• 两个API命令：originate控制发起一个呼叫；uuid_bridge将两个channel桥接起来。大部分公用API在mod_commands模块中加载；APP（又称拨号计划工具）在mod_dptools中

• freeswitch启动到后台的参数：freeswitch -nc

• freeswitch关闭./freeswitch -stop

• 关闭upnp(或NAT-PMP)协议启动: freeswitch -nonat

• 实时跟踪查看日志：tail -f

• 在UNIX类系统上，启动脚本一般放在/etc/init.d/下。你可以在系统源代码目录下找到不同系统启动脚debian/freeswitch.init及build/freeswitch.init.*，大家可以根据自己的需求和实际情况参考使用。在Windows上，你也可以将FreeSWITCH注册Windows服务（使用“FreeswitchConsole-install”命令）

• 查看进程已启动：ps aux|grep freeswitcch（-a：显示所有进程；-u：用户以及其他详细信息；-x：显示没有控制终端的进程）

  查看端口是否被占用：netstat -an|grep 5060

• "-x"参数，允许执行一条命令后退出：

  bin/fs_cli -x "sofia status": 查看线路状态

  ./fs_cli -x "sofia global siptrace on": 实时监控sip信令

  ./fs_cli -x "show channels": 正在进行线路

• “/”开头命令，先由fs_cli处理：

  /quit，/bye, /exit, Ctrl+D 退出fs_cli

  /event:开启事件接收，/noevents:关闭事件接收

  /log info, /log debug:设置日志， /nolog:关闭日志。 /filter:过滤事件

• 查看当前注册用户sofia status profile internal reg

• 在bin中拨号：

  • ./fs_cli -x "originate sofia/gateway/配置的线路名称(可设置拨号规则外呼加前缀)/1122312 &echo()"
  • originate sofia/gateway/配置的线路名称/1122312 &echo()

• 服务器配置/修改线路信息：

  • /conf/sip_profile/external —>线路名.xml(改IP两个位置)
  • 线路配置修改后重启：./fs_cli -x "sofia profile external restart"(会影响当前通话)或者sofia profile external killgw 网关名字然后sofia profile external rescan(不会影响当前通话)
  • 查看线路状态./fs_cli -x "sofia status"
  • ./fs_cli -x "sofia global siptrace on" 实时监控sip信令,在日志中可以看到sip信令
  • 正在进行线路：./fs_cli -x "show channels"
  • 查看,修改线路外呼前缀XML地址：/usr/local/freeswitch/conf/dialplan/default.xml，/usr/local/freeswitch/conf/dialplan/public.xml

• 数据库配置线路：

  • phone_line表，line_number：不能重复；line_params：前缀
  • organization_phone_line表：origanazation_id:机构ID(origanization表)，concurrency：并发量

• 拨打计划：conf/diaplan目录中，由一系列XML配置文件组成

• FreeSWITCH发送HUP信号让它重新加载和解析全局的配置文件，实现命令是kill-HUP<FreeSWITCH的pid>

• SIP会话：

  • invite(UA发送会话请求) -> 100 Trying（对方收到请求） -> 180 Ringing（对方振铃）-> 183 UA收到回铃音 -> 200 ok（对方接通）
  • sip状态码：
    • 1xx组的响应为临时状态，表明呼叫进展的情况；
    • 2xx表明请求已被成功收到、理解和接受；
    • 3xx为重定向，表明SIP请求需要转向到另一个UAS处理；
    • 4xx表明请求失败，这种失败一般是由客户端或网络引的，如密码错误、空号等，客户端应该重新修改请求，然后重发；
    • 5xx为服务器内部错误，表明服务器出错，不能响应合法的请求；
    • 6xx为全局性错误，如600 Busy Everywhere。

• 目录结构

  • ├── autoload_configs
    │   ├── acl.conf.xml   		    访问权限
    │   ├── callcenter.conf.xml     队列，坐席，关系处理文件
    │   ├── event_socket.conf.xml   配置esl连接
    │   ├── modules.conf.xml        启动时加载模块配置
    │   ├── *                       一般来说为模块的配置文件
    ├── chatplan
    │   └── default.xml             聊天计划目前未使用
    ├── dialplan                    拨号计划
    │   ├── default
    │   ├── default.xml             默认的拨号计划配置，一般用于内部用户路由 inbound
    │   ├── public
    │   ├── public.xml              默认的拨号计划配置，一般用于外部用户路由 outbound
    ├── directory                   配置用户目录
    │   ├── default
    │   │   ├── 1000.xml            用户
    │   │   ├── *
    │   ├── default.xml             用户相关配置
    ├── extensions.conf
    ├── ivr_menus                   ivr菜单
    │   ├── demo_ivr.xml
    │   └── new_demo_ivr.xml
    ├── lang                        语言支持
    │   ├── de
    │   ├── en
    │   ├── es
    ├── mime.types
    ├── mrcp_profiles             MRCP的相关配置文件跟第三方语音合成和语音识别系统对接的
    ├── notify-voicemail.tpl
    ├── sip_profiles              SIP配置文件
    │   ├── external              用于配置网关
    │   │   ├── example.xml
    │   ├── external-ipv6.xml
    │   ├── external.xml          可配置端口以及一些参数
    │   ├── internal-ipv6.xml                          sip-ip rtp-ip
    │   └── internal.xml          可配置端口以及一些参数 ext-sip-ip ext-rtp-ip
    ├── skinny_profiles           思科sccp协议话机配置文件
    │   └── internal.xml
    ├── vars.xml                  配置常用的全局变量
    
    
    

• 清理已经注册的用户:sofia profile internal flush_inbound_reg sip号@ip地址

• 手拨录音文件名字增加坐席sip账号：_${caller_id_number}