FreeSWITCH入门到精通系列（一）：什么是FreeSWITCH？

黄宝良

已于 2024-05-24 09:13:51 修改

阅读量6.7k

点赞数 34

分类专栏： freeswitch 文章标签：实时音视频

于 2024-05-23 11:34:53 首次发布

本文链接：https://blog.csdn.net/hgkgjg/article/details/139143155

版权

freeswitch 专栏收录该内容

12 篇文章

订阅专栏

FreeSWITCH入门到精通系列（一）：什么是FreeSWITCH？

前言

FreeSWITCH是一个强大而灵活的开源通信平台，广泛应用于构建VoIP系统、呼叫中心、会议系统等。在本系列博客中，我们将从FreeSWITCH的基础知识开始，逐步深入到高级功能和实战应用，帮助您从入门到精通掌握FreeSWITCH。

什么是FreeSWITCH？

FreeSWITCH是一个开源的软交换平台，最初由一群Asterisk开发者创建，旨在提供一个高性能、灵活且可扩展的通信解决方案。它支持多种通信协议，包括SIP（会话初始协议）、RTP（实时传输协议）和WebRTC，使其成为构建语音、视频和消息传递应用的理想选择。

FreeSWITCH的特点

高性能：FreeSWITCH采用高效的C语言编写，能够处理大量并发呼叫，适用于高流量的通信应用。
模块化设计：FreeSWITCH的模块化架构允许用户根据需要加载不同的功能模块，从而实现定制化的解决方案。
多协议支持：支持SIP、H.323、WebRTC等多种协议，提供广泛的互操作性。
灵活的脚本支持：支持Lua、JavaScript、Python等多种脚本语言，方便实现复杂的逻辑和自动化任务。
丰富的功能：内置IVR、会议、呼叫录音等丰富的通信功能，满足各种应用需求。

FreeSWITCH的应用场景

VoIP系统：FreeSWITCH可以作为一个SIP服务器，用于构建IP电话系统。
呼叫中心：通过FreeSWITCH的强大功能模块，可以实现复杂的呼叫路由和管理，适用于大中型呼叫中心。
会议系统：支持多方会议功能，可用于企业内部会议系统。
WebRTC应用：通过mod_verto模块，支持WebRTC协议，方便构建基于浏览器的通信应用。
自定义通信平台：利用FreeSWITCH的脚本和模块化设计，可以快速搭建定制化的通信解决方案。

FreeSWITCH的核心组件

核心（Core）：FreeSWITCH的核心部分，负责处理所有基础功能，如呼叫控制、媒体流处理等。
模块（Modules）：扩展FreeSWITCH功能的插件，可以按需加载。常用模块包括mod_sofia（SIP支持）、mod_conference（会议支持）、mod_dptools（拨号工具）等。
配置文件（Configuration Files）：位于/etc/freeswitch/目录下，主要配置文件包括freeswitch.xml（全局配置）、vars.xml（变量配置）、sip_profiles（SIP配置）等。
事件系统（Event System）：FreeSWITCH采用事件驱动架构，所有操作都通过事件处理，支持异步事件和自定义事件。

FreeSWITCH的安装与配置

1. 安装FreeSWITCH

FreeSWITCH支持多种操作系统，以下以Ubuntu为例进行安装：

sudo apt update
sudo apt install -y gnupg2 wget lsb-release
wget -O - https://files.freeswitch.org/repo/deb/debian/freeswitch_archive_g0.pub | sudo apt-key add -
echo "deb http://files.freeswitch.org/repo/deb/debian/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/freeswitch.list
sudo apt update
sudo apt install -y freeswitch-meta-all

2. 启动FreeSWITCH

安装完成后，可以使用以下命令启动FreeSWITCH：

sudo systemctl start freeswitch
sudo systemctl enable freeswitch

3. 配置FreeSWITCH

FreeSWITCH的配置文件位于/etc/freeswitch/目录下，主要配置文件包括：

freeswitch.xml：全局配置文件，定义了系统的核心配置。
vars.xml：变量配置文件，定义了系统中的全局变量。
autoload_configs：自动加载配置目录，包含各个模块的配置文件。

简单的Hello World示例

要创建一个简单的Hello World示例，让用户拨打一个号码并播放一段欢迎语音，可以按照以下步骤进行配置：

配置SIP账号

编辑/etc/freeswitch/directory/default/1000.xml，配置一个SIP账号：

<include>
  <user id="1000">
    <params>
      <param name="password" value="1234"/>
    </params>
    <variables>
      <variable name="toll_allow" value="domestic,international,local"/>
      <variable name="accountcode" value="1000"/>
      <variable name="user_context" value="default"/>
      <variable name="effective_caller_id_name" value="Extension 1000"/>
      <variable name="effective_caller_id_number" value="1000"/>
      <variable name="outbound_caller_id_name" value="FreeSWITCH"/>
      <variable name="outbound_caller_id_number" value="0000000000"/>
      <variable name="callgroup" value="techsupport"/>
    </variables>
  </user>
</include>

配置拨号计划

编辑/etc/freeswitch/dialplan/default.xml，添加一个简单的拨号计划：

<extension name="HelloWorld">
  <condition field="destination_number" expression="^1000$">
    <action application="answer"/>
    <action application="sleep" data="1000"/>
    <action application="playback" data="ivr/ivr-welcome_to_freeswitch.wav"/>
    <action application="hangup"/>
  </condition>
</extension>

重载配置

执行以下命令，使配置生效：

fs_cli -x "reloadxml"

深入了解FreeSWITCH的模块

FreeSWITCH的模块化设计允许用户根据需求加载和使用不同的模块。以下是几个常用模块的详细介绍：

mod_sofia

mod_sofia是FreeSWITCH的核心SIP模块，负责处理所有与SIP相关的功能。它支持SIP注册、呼叫建立、呼叫转移等功能。

配置示例：

<configuration name="sofia.conf" description="sofia Endpoint">
  <global_settings>
    <param name="log-level" value="0"/>
    <param name="debug-presence" value="0"/>
  </global_settings>
  <profiles>
    <profile name="internal">
      <gateways/>
      <domains/>
      <settings>
        <param name="debug" value="0"/>
        <param name="sip-trace" value="no"/>
      </settings>
    </profile>
  </profiles>
</configuration>

mod_conference

mod_conference模块用于创建和管理多方会议。它支持多种音频处理功能，如混音、录音、静音控制等。

配置示例：

<configuration name="conference.conf" description="Conference Module">
  <settings>
    <param name="caller-controls" value="conf-control"/>
    <param name="energy-level" value="100"/>
    <param name="comfort-noise" value="true"/>
  </settings>
</configuration>

mod_dptools

mod_dptools模块提供一组常用的拨号计划工具，如播放语音、录音、呼叫转移等。

配置示例：

<extension name="SimpleDialplan">
  <condition field="destination_number" expression="^2000$">
    <action application="answer"/>
    <action application="playback" data="ivr/ivr-welcome_to_freeswitch.wav"/>
    <action application="hangup"/>
  </condition>
</extension>

FreeSWITCH的脚本与自动化

FreeSWITCH支持多种脚本语言，使得复杂的逻辑实现和自动化任务更加简单和灵活。

使用Lua脚本

Lua是一种轻量级的脚本语言，FreeSWITCH支持通过Lua脚本进行呼叫控制和逻辑处理。

示例：使用Lua脚本处理来电并播放欢迎消息

创建Lua脚本文件

在/usr/share/freeswitch/scripts/目录下创建一个名为hello.lua的文件，内容如下：

session:answer()
session:sleep(1000)
session:streamFile("ivr/ivr-welcome_to_freeswitch.wav")
session:hangup()

配置拨号计划调用Lua脚本

编辑/etc/freeswitch/dialplan/default.xml，添加如下配置：

<extension name="HelloLua">
  <condition field="destination_number" expression="^2000$">
    <action application="lua" data="hello.lua"/>
  </condition>
</extension>

重载配置

执行以下命令，使配置生效：

fs_cli -x "reloadxml"

FreeSWITCH的安全性配置

保障FreeSWITCH的安全性非常重要，包括以下几个方面：

网络安全：使用防火墙限制访问，确保只有信任的IP可以访问。
认证和加密：使用SIP的认证和SRTP加密媒体流。
模块安全：禁用不必要的模块，减少攻击面。

配置示例：使用防火墙限制访问

在Ubuntu上，可以使用ufw配置防火墙规则：

sudo ufw allow proto tcp from <trusted_ip> to any port 5060
sudo ufw allow proto udp from <trusted_ip> to any port 5060
sudo ufw enable

配置示例：启用SRTP加密

编辑/etc/freeswitch/sip_profiles/internal.xml，添加SRTP配置：

<param name="rtp_secure_media" value="optional"/>
<param name="srtp-suite" value="AES_CM_128_HMAC_SHA1_80"/>

结语

在本篇博客中，我们介绍了FreeSWITCH的基本概念、特点、应用场景以及安装与配置。在接下来的系列文章中，我们将深入探讨FreeSWITCH的模块使用、脚本编写、安全配置、优化与性能调优等内容，帮助您全面掌握FreeSWITCH的各项技能。敬请期待！

如果您有任何问题或建议，请在评论区留言，我会尽快回复。感谢您的阅读！