第二章 FreeSWITCH 初步
什么是 FreeSWITCH ？
FreeSWITCH 是一个开源的电话交换平台，它具备很强的可伸缩性--从一个简单的软电话客户端到运营商级的软交换设备几乎无所不能。能原生地运行于Windows、 Max OS X、Linux、BSD 及 solaris 等诸多32/64位平台。能够用做一个简单的交换引擎、一个PBX，一个媒体网关或媒体支持IVR的服务器等。它支持SIP、H32三、Skype、Google Talk等协议，并能很容易地与各类开源的PBX系统如sipXecs、Call Weaver、Bayonne、YATE及Asterisk等通讯。 FreeSWITCH 遵循RFC并支持不少高级的SIP特性，如 presence、BLF、SLA以及TCP、TLS和sRTP等。它也能够用做一个SBC进行透明的SIP代理（proxy）以支持其它媒体如T.38 等。FreeSWITCH 支持宽带及窄带语音编码，电话会议桥可同时支持八、十二、1六、2四、32及48kHZ的语音. 而在传统的电话网络中，要作到三方通话或多方通话须要经过专门的芯片来处理，其它像预付费，彩铃等业务在PSTN网络中都须要依靠智能网(IN)才能实现，并且配置起来至关不灵活。
快速体验
FreeSWITCH 的功能确实很是丰富和强大，在进一步学习以前咱们先来作一个完整的体验。FreeSWITCH 默认的配置是一个SOHO PBX(家用电话小交换机)，那么咱们本章的目标就是从0安装，实现分机互拨电话，测试各类功能，并经过添加一个SIP-PSTN网关拨打PSTN电话。这样，即便你没有任何使用经验，你也应该能顺利走完本章，从而创建一个直接的认识。在体验过程当中，你会遇到一点稍微复杂的配置，若是不能彻底理解，也不用担忧，咱们在后面会详细的介绍。固然，若是你是一个颇有经验的 FreeSWITCH 用户，那么大可跳过本章。
安装FreeSWITCH基本系统
在本文写做时，最新的版本1.0.5pre10，但说不定当你读到时1.0.5正式版已经发布了。FreeSWITCH支持32位及64位的 Linux、 MacOSX、BSD、Solaris、Windows等众多平台。某些平台上有编译好的安装包，但本人强烈建议从源代码进行安装，由于 FreeSWITCH 更新很是快，而已编译好的版本一般都比较旧。你能够下载源码包，也能够直接从SVN仓库中取得最新的代码。与其它项目不一样的是，其SVN主干 (trunk)代码一般比稳定的发布版更稳定。并且，当你须要技术支持时，开发人员也一般建议你先升级到SVN中最新的代码，再看是否是仍有问题。
Windows用户能够直接下载安装文件 http://files.freeswitch.org/windows_installer/freeswitch-1.0.4.exe （再提醒一下，版本比较旧代，若是从源代码安装的话，须要Visual Studio 2008）。安装完成执行 c:\freeswitch\freeswitch.exe 即可启动，其配置文件都在c:\freeswitch\conf\。
如下假定你使用 Linux 平台，并假定你有 Linux 的基本知识。如何从头安装 Linux 超出了本书的范围，并且，你也能够很容易的从网上找到这些资料。通常来讲，任何发行套件都是能够的，可是，有些发行套件的内核、文件系统、编译环境，LibC 版本会有一些问题。因此，若是你在遇到问题后想得到社区支持，最好选择一种你们都熟悉的发行套件。FreeSWITCH 开发者使用的平台是 CentOS 5.2/5.3（CentOS 5.4 上会有一些问题，并不老是版本越高越好），社区中也有许多人在使用 Ubuntu 和 Debian，若是你想用于生产环境，建议使用 LTS（Long Term Support） 的版本，即 Ubuntu8.04/10.04 或 Debian Stable。在安装以前，咱们须要先准备一些环境(FreeSWITCH 能够以普通用户权限运行，但为了简单起见，如下全部操做均用 root 执行）：
CentOS:
yum install -y subversion autoconf automake libtool gcc-c++ ncurses-devel make
Ubuntu:
apt-get -y install build-essential subversion automake autoconf wget libtool libncurses5-dev
如下三种安装方式任选其一，默认安装位置在/usr/local/freeswitch。安装过程当中会下载源代码目录，请保留，以便之后升级及安装配置其它组件。
解压缩源码包安装:
wget http://latest.freeswitch.org/freeswitch-1.0.5-latest.tar.gz
tar xvzf freeswitch-1.0.5-latest.tar.gz
cd freeswitch-1.0.5
./configure
make install
这是在在 Linux 上从源代码安装软件的标准过程。首先第 1 行下载最新的源代码，第 2 行解压缩，第 4 行配置编译环境，第 5 行编译安装。
从 SVN 仓库安装：
FreeSWITCH 使用 Subversion 管理源代码，从代码库安装能让你永远使用最新的版本。
svn co http://svn.freeswitch.org/svn/freeswitch/trunk freeswitch
cd freeswitch
./bootstrap.sh
./configure
make install
与上一种方法不一样的是，直接从代码库安装须要执行一个 bootstrap.sh 以初始化一些环境。
最快安装（推荐）
wget http://www.freeswitch.org/eg/Makefile && make install
以上命令会下载一个 Makefile，而后使用 make 执行安装过程。安装过程当中它会从 SVN 仓库中获取代码，实际上执行的操做跟上一种安装方式相同。
安装声音文件
在如下例子中咱们须要一些声音文件，而安装这些声音文件也异常简单。你只需在源代码目录中执行：
make sounds-install
make moh-install
如下高质量的声音文件可选择安装。FreeSWITCH支持八、1六、32及48kHz的语音，不多有其它电话系统支持如此多的抽样频率（普通电话是8K，更高频率意味着更好的通话质量）。
make cd-sounds-install
make cd-moh-install
安装完成后，会显示一个有用的帮助，
+---------- FreeSWITCH install Complete ----------+
+ FreeSWITCH has been successfully installed. +
+ +
+ Install sounds: +
+ (uhd-sounds includes hd-sounds, sounds) +
+ (hd-sounds includes sounds) +
+ ------------------------------------ +
+ make cd-sounds-install +
+ make cd-moh-install +
+ +
+ make uhd-sounds-install +
+ make uhd-moh-install +
+ +
+ make hd-sounds-install +
+ make hd-moh-install +
+ +
+ make sounds-install +
+ make moh-install +
+ +
+ Install non english sounds: +
+ replace XX with language +
+ (ru : Russian) +
+ ------------------------------------ +
+ make cd-sounds-XX-install +
+ make uhd-sounds-XX-install +
+ make hd-sounds-XX-install +
+ make sounds-XX-install +
+ +
+ Upgrade to latest: +
+ ---------------------------------- +
+ make current +
+ +
+ Rebuild all: +
+ ---------------------------------- +
+ make sure +
+ +
+ Install/Re-install default config: +
+ ---------------------------------- +
+ make samples +
+ +
+ Additional resources: +
+ ---------------------------------- +
+ http://www.freeswitch.org +
+ http://wiki.freeswitch.org +
+ http://jira.freeswitch.org +
+ http://lists.freeswitch.org +
+ +
+ irc.freenode.net / #freeswitch +
+-------------------------------------------------+
至此，已经安装完了。在Unix类操做系统上，其默认的安装位置是/usr/local/freeswtich，下文所述的路径所有相对于该路径。两个经常使用的命令是 bin/freeswitch 和 bin/fs_cli，为了便于使用，建议将这两个命令作符号连接放到你的搜索路径中，如：
ln -sf /usr/local/freeswitch/bin/freeswitch /usr/local/bin/
ln -sf /usr/local/freeswitch/bin/fs_cli /usr/local/bin/
固然，若是 /usr/local/bin 不在你的搜索路径中，能够把上面 /usr/local/bin 换成 /usr/bin/。 另外你也能够修改你的PATH环境变量以包含该路径。
接下来就应该能够启动了，经过在终端中执行freeswitch命令(若是你已作符号连接的话，不然要执行/usr/local /freeswitch/bin/freeswitch)能够将其启动到前台，启动过程当中会有许多log输出，第一次启动时会有一些错误和警告，能够不用理会。启动完成后会进入到系统控制台(如下称称FS-Con)。并显示相似的提示符“freeswitch@internal>”(如下简做 “FS> ”)。经过在FS-Con中输入shutdown命令能够关闭FreeSWITCH。
若是您想将FreeSWITCH启动到后台(daemon，服务模式)，可使用freeswitch -nc (No console)。后台模式没有控制台，若是这时想控制FreeSWITCH，可使用客户端软件fs_cli链接。注意，在fs_cli中须要使用 fsctl shutdown 命令关闭 FreeSWITCH。固然，也能够直接在 Linux 提示符下经过 freeswitch -stop 命令关闭。若是不想退出 FreeSWITCH 服务，只退出fs_cli客户端，则须要输入 /exit，或Ctrl + D，或者，直接关掉终端窗口。
链接SIP软电话
FreeSWITCH最典型的应用是做为一个服务器(它其实是一个背靠背的用户代理，B2BUA)，并用电话客户端软件（通常叫软电话）链接到它。虽然 FreeSWITCH 支持 IAX、H32三、Skype、Gtalk 等众多通讯协议，但其最主要的协议仍是 SIP。支持SIP的软电话有不少，最经常使用的是 X-Lite 和 Zoiper。这两款软电话都支持 Linux、MacOSX 和 Windows平台，无偿使用可是不开源。在 Linux 上你还可使用 ekiga 软电话。
强烈建议在同一局域网上的其它机器上安装软电话，并确保麦克风和耳机能够正常工做 。固然，若是你没有多余的机器作这个实验，那么你也能够在同一台机器上安装。只是须要注意，软电话不要占用 UDP 5060 端口，由于 FreeSWITCH 默认要使用该端口，这是新手常会遇到的一个问题。你能够经过先启动 FreeSWITCH 再启动软电话来避免该问题，另外有些软电话容许你修改本地监听端口。
经过输入如下命令能够知道 FreeSWITCH 监听在哪一个IP地址上，记住这个 IP 地址(:5060之前的部分)，下面要用到：
netstat -an | grep 5060
FreeSWITCH 默认配置了 1000 ~ 1019 共 20 个用户，你能够随便选择一个用户进行配置：
在 X-Lite 上点右键，选 Sip Account Settings...，点Add添加一个帐号，填入如下参数(Zoiper 可参照配置)：
Display Name: 1000
User name: 1000
Password: 1234
Authorization user name: 1000
Domain: 你的IP地址，就是刚才你记住的那个
其它都使用默认设置，点 OK 就能够了。而后点 Close 关闭 Sip Account 设置窗口。这时 X-Lite 将自动向 FreeSWITCH 注册。注册成功后会显示"Ready. Your username is 1000"，另外，左侧的“拨打电话”（Dial）按钮会变成绿色的。以下图。
激动人心的时刻就要来了。输入“9999”按回车（或按绿色拨打电话按钮），就应该能听到保持音乐(MOH, Music on Hold)。若是听不到也不要气馁，看一下 FS-Con 中有没有提示什么错误。若是有“File Not Found”之类的提示，多半是声音文件没有安装，从新查看 make moh-install 是否有错误。接下来，能够依次试试拨打如下号码：
------------------
号码 | 说明
----------------------
9999 | 保持音乐
9996 | echo，回音测试
××× | info，在控制台上显示呼叫参数
9888 | FreeSWITCH电话会议，每周召开
5900 | 呼叫挂起
5901 | 接听挂起的呼叫
5000 | 示例IVR
4000 | 听取语音信箱
33xx | 电话会议，48K(其中xx可为00-99，下同)
32xx | 电话会议，32K
31xx | 电话会议，16K
30xx | 电话会议，8K
2000-2002 | 呼叫组
1000-1019 | 默认分机号
表一： 默认号码及说明
另外，也许你想尝试注册另一个SIP用户并在二者间通话。最好是在同一个局域网中的另一台机器上启动另外一个 X-Lite ，并使用 1001 注册，注册完毕后就能够在 1000 上呼叫 1001，或在 1001 上呼叫 1000 。固然，你仍然能够在同一台机器上作这件事（比方说用Zoiper注册为1001），须要注意的是，因为你机器上只有一个声卡，二者可能会争用声音设备。特别是在Linux上，有些软件会独占声音设备。若是同时也有一个USB接口的耳机，那就能够设置不一样的软件使用不一样的声音设备。
配置简介
FreeSWITCH配置文件默认放在 conf/， 它由一系列XML配置文件组成。最顶层的文件是freeswitch.xml，系统启动时它依次装入其它一些XML文件并最终组成一个大的XML文件。
文件 | 说明
---------------------------------------------------
vars.xml | 一些经常使用变量
dialplan/default.xml | 缺省的拨号计划
directory/default/*.xml | SIP用户，每用户一个文件
sip_profiles/internal.xml | 一个SIP profile，或称做一个SIP-UA，监听在本地IP及端口5060，通常供内网用户使用
sip_profiles/externa.xml | 另外一个SIP-UA，用做外部链接，端口5080
autoload_configs/modules.conf.xml | 配置当FreeSWITCH启动时自动装载哪些模块
添加一个新的SIP用户
FreeSWITCH默认设置了20个用户(1000-1019)，若是你须要更多的用户，或者想经过添加一个用户来学习FreeSWITCH配置，只须要简单执行如下三步：
* 在 conf/directory/default/ 增长一个用户配置文件
* 修改拨号计划(Dialplan)使其它用户能够呼叫到它
* 从新加载配置使其生效
若是想添加用户Jack，分机号是1234。只须要到 conf/directory/default 目录下，将 1000.xml 拷贝到 1234.xml。打开1234.xml，将全部1000都改成1234。并把 effective_caller_id_name 的值改成 Jack，而后存盘退出。如：
<variable name="effective_caller_id_name" value="Jack"/>
接下来，打开 conf/dialplan/default.xml，找到 <condition field="destionation_number"
expression="^(10[01][0-9])$"> 一行，改成 <condition field="destionation_number" expression="^(10[01][0-9]|1234)$">。熟悉正则表达式的人应该知道，“^(10[01][0-9])$”匹配被叫号码1000-1019。所以咱们修改以后的表达式就多匹配了一个1234。FreeSWITCH使用Perl兼容的正则表达式(PCRE)。
如今，回到FS-Con，或启动fs_cli，执行 reloadxml 命令或按快捷键F6，使新的配置生效。
找到刚才注册为1001的那个软电话(或启动一个新的，若是你有足够的机器的话)，把1001都改成1234而后从新注册，则能够与1000相互进行拨打测试了。若是没有多台机器，在同一台机器上运行多个软电话可能有冲突，这时，也能够直接进在FreeSWITCH控制台上使用命令进行测试：
FS> sofia status profile internal (显示多少用户已注册）
FS> originate sofia/profile/internal/1000 &echo (拨打1000并执行echo程序）
FS> originate user/1000 &echo (同上）
FS> originate sofia/profile/internal/1000 9999 (至关于在软电话1000上拨打9999)
FS> originate sofia/profile/internal/1000 9999 XML default (同上)
其中，echo() 程序一个很简单的程序，它只是将你说话的内容原样再放给你听，在测试时颇有用，在本书中，咱们会常常用它来测试。
FreeSWITCH用做软电话
FreeSWITCH也能够简单的用做一个软电话，如X-Lite. 虽然相比而言比配置X-Lite略微麻烦一些，但你会从中获得更多好处：FreeSWITCH是开源的，更强大、灵活。关键是它是目前我所知道的惟一支持CELT高清通话的软电话。
FreeSWITCH使用mod_portaudio支持你本地的声音设备。该模块默认是不编译的。到你的源代码树下，执行：
make mod_portaudio
make mod_portaudio-install
其它的模块也能够依照上面的方式进行从新编译和安装。而后到FS-Con中，执行:
FS> load mod_portaudio
若是获得“Cannot find an input device”之类的错误多是你的声卡驱动有问题。若是是提示“+OK”就是成功了，接着执行：
FS> pa devlist
API CALL [pa(devlist)] output:
0;Built-in Microphone;2;0;
1;Built-in Speaker;0;2;r
2;Built-in Headphone;0;2;
3;Logitech USB Headset;0;2;o
4;Logitech USB Headset;1;0;i
以上是在我笔记本上的输出，它列出了全部的声音设备。其中，3和4最后的“o”和“i”分别表明声音输出(out)和输入(in)设备。在你的电脑上可能不同，若是你想选择其它设备，可使用命令：
FS> pa indev #0
FS> pa outdev #2
以上命令会选择我电脑上内置的麦克风和耳机。
接下来你就能够有一个能够用命令行控制的软电话了，酷吧？
FS> pa looptest (回路测试，echo)
FS> pa call 9999
FS> pa call 1000
FS> pa hangup
如上所示，你能够呼叫刚才试过的全部号码。如今假设想从SIP分机1000呼叫到你，那须要修改拨号计划(Dialplan)。用你喜欢的编辑器编辑如下文件放到conf/dialplan/default/portaudio.xml
<include>
<extension name="call me">
<condition field="destination_number" expression="^(me|12345678)$">
<action application="bridge" data="portaudio"/>
</condition>
</extension>
</include>
而后，在FS-Con中按“F6”或输入如下命令使之生效：
FS> reloadxml
在分机1000上呼叫“me”或“12345678”(你确定想为本身选择一个更酷的号码)，而后在FS-Con上应该能看到相似“[DEBUG] mod_portaudio.c:268 BRRRRING! BRRRRING! call 1”的输出（若是看不到的话按“F8”能获得详细的Log），这说明你的软电话在振铃。多打几个回车，而后输入“pa answer”就能够接听电话了。“pa hangup”能够挂断电话。
固然，你确定但愿在振铃时能听到真正的振铃音而不是看什么BRRRRRING。好办，选择一个好听一声音文件(.wav格式)，编辑conf/autoload_configs/portaudio.conf.xml，修改下面一行：
<param name="ring-file" value="/home/your_name/your_ring_file.wav"/>
而后从新加载模块：
FS> reloadxml
FS> reload mod_portaudio
再打打试试，看是否能听到振铃音了？
若是你用不惯字符界面，能够看一下FreeSWITCH-Air(http://www.freeswitch.org.cn /download)，它为 FreeSWITCH 提供一个简洁的软电话的图形界面。另外，若是你须要高清通话，除须要设置相关的语音编×××(codec)外，你还须要有一幅好的耳机才能达到最好的效果。本人使用的是一款USB耳机。
配置SIP网关拨打外部电话
若是你在某个运营商拥有SIP帐号，你就能够配置上拨打外部电话了。该SIP帐号（或提供该帐号的设备）在 FreeSWITCH 中称为SIP网关（Gateway）。添加一个网关只须要在 conf/sip_profiles/external/ 建立一个XML文件，名字能够随便起，如gw1.xml。
<gateway name="gw1">
<param name="realm" value="SIP服务器地址，能够是IP或IP:端口号"/>
<param name="username" value="SIP用户名"/>
<param name="password" value="密码"/>
<param name="register" value="true" />
</gateway>
若是你的SIP网关还须要其它参数，能够参阅同目录下的 example.xml，但通常来讲上述参数就够了。你能够重启 FreeSWITCH，或者执行如下命令使用之生效。
FS> sofia profile external rescan reloadxml
而后显示一下状态：
FS> sofia status
若是显示 gateway gw1 的状态是 REGED ，则代表正确的注册到了网关上。你能够先用命令试一下网关是否工做正常：
FS> originate sofia/gateway/gw1/xxxxxx &echo()
以上命令会经过网关 gw1 呼叫号码 xxxxxx（多是你的手机号），被叫号码接听电话后，FreeSWITCH 会执行 echo() 程序，你应该能听到本身的回音。
从某一分机上呼出
若是网关测试正常，你就能够配置从你的SIP软电话或portaudio呼出了。因为咱们是把 FreeSWITCH 看成 PBX 用，咱们须要选一个出局字冠。常见的 PBX 通常是内部拨小号，打外部电话就须要加拨 0 或先拨 9 。固然，这是你本身的交换机，你能够用任何你喜欢的数字（甚至是字母）。 继续修改拨号计划，建立新XML文件： conf/dialplan/default/call_out.xml :
<include>
<extension name="call out">
<condition field="destination_number" expression="^0(\d+)$">
<action application="bridge" data="sofia/gateway/gw1/$1"/>
</condition>
</extension>
</include>
其中，(\d+)为正则表达式，匹配 0 后面的全部数字并存到变量 $1 中。而后经过 bridge 程序经过网关 gw1 打出该号码。固然，创建该XML后须要在Fs-Con中执行 reloadxml 使用之生效。
呼入电话处理。
若是你的 SIP 网关支持呼入，那么你须要知道呼入的 DID 。 DID的全称是 Direct Inbound Dial，即直接呼入。通常来讲，呼入的 DID 就是你的 SIP 号码，若是你不知道，也不要紧，后面你会学会如何获得。 编辑如下XML文件放到 conf/dialplan/public/my_did.xml
<include>
<extension name="public_did">
<condition field="destination_number" expression="^(你的DID)$">
<action application="transfer" data="1000 XML default"/>
</condition>
</extension>
</include>
reloadxml 使之生效。上述配置会未来话直接转接到分机 1000 上。在后面的章节你会学到如何更灵活的处理呼入电话，如转接到语音菜单或语音信箱等。
小结
其实本章涵盖了从安装、配置到调试、使用的至关多的内容，若是你能顺利走到这儿，你确定对 FreeSWITCH 已经受不释手了。若是你卡在了某处，或某些功能未能实现，也不是你的错，主要是由于 FreeSWITCH 博大精深，我不能在短短的一章内把全部的方面解释清楚。在后面的章节中，你会学到更多的基本概念、更加深刻地了解 FreeSWITCH 的哲学，学到更多的调试技术和技巧，解决任何问题都会是小菜一碟了。node