FreeSWITCH入门指南.docx

FreeSWITCH入门指南.docx

《FreeSWITCH入门指南.docx》由会员分享，可在线阅读，更多相关《FreeSWITCH入门指南.docx（7页珍藏版）》请在冰豆网上搜索。

FreeSWITCH入门指南

FreeSWITCH入门指南

GettingStartedGuide入门指南FromFreeSWITCHWiki从FreeSWITCH维基Jump

to:

跳转到:

导航，搜索ThepurposeofthefollowingpageistoinstructnewusersonhowtoconfigureFreeSWITCHinabasicway.以下网页的目的，是指导新用户如何

配置FreeSWITCH的一个基本方式。

Itisalsointendedtoprovidepeoplewithabasicunderstandingoftheconfigurationfilesandhowtheyareprocessed.这也是为了提供一

个配置文件的基本了解的人以及他们如何处理。

IfFreeSWITCHisnotalready

installedonyoursystemyoushouldreadthe.如果FreeSWITCH不是已经安装在您的

系统，你应该阅读安装指南。

Thisguideisnotintendedtoallowformorethanadefaultconfiguration.本指南不打算让超过默认配置。

FreeSWITCH布局

FreeSWITCHhasamodulardesign.FreeSWITCH采用模块化设计。

Thisdesignallows

ittobeextendedwithoutbreakingfunctionalityorrequiringmassiverecodingefforts.这

种设计允许它在不破坏的功能或要求重新编写大量的努力延长。

Eachmodule

providesspecificfunctionalityoftencommandsthatarerelatedaregroupedintoonemodule.每个模块都提供特定的功能，往往是相关的命令是在一个模块进行分组。

Youwillneedtoenablethemodulesthatyoudesirebasedontheirfunction.您将需要启

用，你的愿望，根据他们的功能模块。

BydefaultFreeSWITCHcomeswithagoodsetofmodulesloadedtoenablemostbasicfunctionality.默认情况下FreeSWITCH附带了

一个良好的加载模块设置，使最基本墓δ堋阅读

上的更多信息，配置的默认。

配置Thefollowingsectionswillshowyoueachstepthatyouwillhavetotaketogetafunctionalsystem.下面的章节将告诉你每一步，你将

不得不采取获得功能系统。

防火墙Ifyouaregoingtoroutetrafficacrossyournetworkyouneedtoensurethatyoudonothaveafirewallblockingtrafficonthespecifiednetworkpaths.如果你想在您的网络传输流量，你需要确保你没有防火墙阻止指定的

网络路径流量。

Commonlyfirewallsareinstalledategresspointswhereyourlocalnetworkconnectstotheinternet.常见的防火墙是安装在出口点，在您的本地网络连接

到互联网。

Thisisnotalwaysthecaseinsomecorporateenvironments.这并不总是在一

些企业环境的情况。

Ifyouarenotresponsibleforyournetworkyoumaywishtocontactthegrouporindividualsthatareforassistance.如果您没有为您的网络负责，您

可能希望联络小组或个人的援助。

Informationtheymayneedtoenabletrafficwouldincludetheportnumbers.他们可能需要的信息，使交通将包括端口号。

Various

protocolsusedifferentportsfordifferentthings.各种协议的不同的使用不同的端口。

Someyouneedbi-directionalconnectivitysomeyouonlyneedoutbound.一些你需要的

双向连接，有些你只需要出站。

Dependingonyourcallscenarioyoumayonlyneedtoallowconnectionsthatareinitiatedbyyoursystem.IfyouhaveanyproblemswithprotocolsnotworkingitisrecommendedthatyoudisableyourfirewalltotheFreeSWITCHsystemandplaceatestcallandseeiftheproblempersists.Commonlypeoplewhohaveproblemshaveamisconfiguredfirewallthatiscreatingtheproblem.根

据您的要求的情况你可能只需要允许该由你的系统发起的连接。

如果您有任何问题

的协议不工作，建议您禁用防火墙的FreeSWITCH系统和地点通话测试，看看该

问题仍然存在。

常见的有问题的人谁具有防火墙的配置错误是造成上述问题。

NetworkFireWallPorts防Protocol网ApplicationProtocol应用协议Description

描述火墙中的端口络协议1719UDPH.323GatekeeperRASport1720TCPH.323

CallSignallingUsedforNATtraversal用于NAT穿3478UDPSTUNservice越

UsedforNATtraversal用于NAT穿3479UDPSTUNservice越5002TCPMLP

protocolserver5003UDPNeighborhoodserviceUsedforSIPsignallingStandardSIP

PortfordefaultInternal5060UDPampTCPSIPUASProfile用于SIP信令（标准SIP

端口，默认内部资料）UsedforSIPsignallingFor5070UDPampTCPSIPUASdefaultquotNATquotProfile用于为SIP信令（对于默认“的NAT”专页）Usedfor

SIPsignallingFor5080UDPampTCPSIPUASdefaultquotExternalquotProfile用于为

SIP信令（对于默认“外部”专页）RTP/RTCPmultimediaUsedforaudio/videodatainSIPand16384-32768UDPstreamingotherprotocols用于SIP音频/视频数据中和其

他协议数据配置文件FreeSWITCHconfigurationdataisstoredinXMLformat.FreeSWITCH配置数据存储在XML格式文件。

ThesefilesarelocatedintheconfdirectoryundertheFreeSWITCHinstalldirectory.这些文件位于下FreeSWITCHconf

directory的目录。

BydefaultonaUnix-likesystemthiswillbe

/usr/local/freeswitch/conf.默认情况下，在Unix系统上，这将是

/usr/local/freeswitch/conf。

TherearepreprocessormarkuptagsthattelltheconfigurationparsertoperformtaskssuchasincludingotherfileswhicharecarriedoutbeforetheXML

isparsed.有预处理标记标签，告诉配置分析器来执行任务，如包括其他文件，这是

前进行的XML时，被解析。

Folder文件夹Description描述Theseconfiguration

filesareloadedautomaticallyintoFreeSWITCH.这些配置autoload_configs文件自动

加载到FreeSWITCH。

Theycontainconfigurationinformationforalmostallcoremodules.它们包含了几乎所有的核心模块的配置信息。

Thisistheplacewhereyou

setupyourdialplan.这是你的地方设置你的拨号规dialplan则。

Therearesome

examplesofhowtoconfigureyourdialplanincluded.有如何配置您的拨号规则包括一

些例子。

ThedirectorycontainsallusersthatmayregisterandusefreeswitchastheirdirectoryPBX.该目录包含所有的用户都可以登记，并以此为他们的PBX

freeswitch。

JingleisthemodthatFSusestohandleXMPP.丁当是FS使用处理

XMPP的mod。

jingle_profilesProfilestellsFShowtousetheprotocol.档案文件告诉

FS如何使用协议。

Eachprofilehasitsownipport.每个配置文件有它自己的IP端

口。

TellsFShowtosaycurrencyetcindifferentlanguages告诉FS如何用不同的

lang语言MRCPisusedtoallowFreeSWITCHtousespeechrecognitionandTTSMRCP是用mrcp_profiles来允许FreeSWITCH使用语音识别和语音合成TellsFS

howtotalksip.告诉FS如何对话SIP。

Eachprofilehasitsownport.sip_profiles每

个配置文件有它自己的端口。

配置FreeSWITCHThisguideaimstoexplainthedefaultconfigurationlayoutandhowyouconfigureittoyourliking.本指南旨在解释默

认配置的布局，以及如何配置它，你自己的喜好。

Readupontheformoreinformation.阅读配置的默认上的更多信息，。

Thislayoutisinnowayrequiredyoucanminimizetheconfigurationtojustonefileifneeded.这种布局在任何需要的方式，您可以配置，

以最大限度地减少只是一个文件，如果需要的。

Themainconfigfileiscalled

freeswitch.xmlyoudontneedtochangeitinanywayitjustloadsallotherconfigfiles.主

要的配置文件被称为freeswitch.xml，你不必以任何方式改变它，它只是加载所有其

他的配置文件。

vars.xmlvars.xmlisusedtodefineacoupleofvariablesthatareused

systemwide.vars.xml用于定义两个是使用的系统广泛的变量。

NOTICEyoucannot

commenttheseX-PRE-PROCESSlinesout.公告您不能注释这些X-PRE-PROCESS

行。

TheywillstillbeactiveinanXMLcomment.他们仍将XML注释中的活动。

。

Seeforexample.看例子Config_vars.xmlInthedefaultconfigurationthevars.xmlfileisusedtodefinesomepreprocessorvariables.在默认配置中vars.xml文件是用来定义一

些预处理变量。

Inafirsttimesetupyouwillmostlikelywanttoset:

是在第一次安装最

有可能想要设置:

ltX-PRE-PROCESScmdquotsetquot

dataquotoutbound_caller_nameFreeSWITCHquot/gtltX-PRE-PROCESScmdquotsetquotdataquotoutbound_caller_id8777423583quot/gtltX-PRE-PROCESScmdquotsetquotdataquotcall_debugfalsequot/gtdirectivesforuseinotherportionsofthe

configuration.用于配置的其他部分中的指令。

ThedefaultportofFreeswitchisalsodefinedinFreeswitch默认端口也被定义在里面ltparamnamequotsip-portquot

valuequot5060quot/gt自动加载配置autoload_configsisadirectorywherealotofthefreeswitchconfigurationresides.autoload_configsautoload_configs是很多freeswitch

配置文件保存的目录。

ThisdirectoryislocatedinPREFIX/conf/autoload_configs.这

个目录位于PREFIX/conf/autoload_configs。

Thedefaultfreeswitch.xmlpreprocessesxmlfilesmatchedbytheglobconf/autoload_configs/.xml默认freeswitch.xml预先处

理（自动加载）conf/autoload_configs/.xml里面匹配的XML文件

modules.conf.xmlSeeforanexampleofmodules.conf.xml.看一个modules.conf.xml的

例子modules.conf.xml。

modules.conf.xmltellsfreeswitchwhichmodulestoload.modules.conf.xml告诉freeswitch加载哪些模块。

Therearecertainmodulesrequiredforoperationsoyoushouldnoteditthisfileunlessyouknowthatyouwishtoaddor

removeaspecificmodule有操作所需要的某些模块，因此你不能编辑这个文件，除

非你知道你想添加或删除特定模块sofia.conf.xmlmod_sofiaisusedtocreateSIPendpointsinFreeSWITCH.模块sofia是用于创建SIP终端到FreeSWITCH。

Ifyou

arefamiliarwithAsteriskeachSIPProfileinmod_sofiaissimilartochan_sipinAsterisk

thoughmuchmorepowerful.如果您熟悉Asterisk，每个mod_sofia的SIP档案类似

Asterisk的chan_sip，但更强大。

Thesofia.conf.xmlfilecontainsa

quotX-PRE-PROCESSquotdirectivethatincludesotherXMLfileswithinbydefaultconf/sip_profiles/thatdefineoneormorequotSIPProfilesquot.该sofia.conf.xml文件

包含的quotX-PRE-PROCESSquot指令，其中包括其他XML文件（在默认情况下，

conf/sip_profiles/），定义一个或多个“SIP档案文件”。

ASIPProfileisaSIPUAUserAgentoranendpointwhichcommunicateswithotherSIPendpoints.一个SIPUA（用

户代理或终结点）与SIP的其他终结点进行通信的SIP的配置文件。

AquotUser

AgentquotquotUAquotisanapplicationusedforrunningacertainnetworkprotocol.“用

户代理”（“UA”）是运行在一定的网络协议使用的应用程序。

ASofiaUserAgent

isthesamethingbuttheprotocolinthatcaseisSIP.这个Sofia用户代理是同样的事

情，但如果是在那应样的话协议是SIP。

InFreeSWITCHtermsUserAgentUASofiaProfileSIPProfile.在FreeSWITCH方面，UserAgentUASofiaProfile

SIPProfile.。

Seeforanexamplesofia.conf.xml.看例子sofia.conf.xml

Sofia_Configuration_Files。

Seealso.另见SIP在维基百科网络元素。

SIP档案文

件TheSIPProfilesinFreeSWITCHcanoftenleadtoconfusion.在FreeSWITCHSIP

的配置文件通常会导致混乱。

UnlikeothersoftswitcheslikeAsterisk

FreeSWITCHallowsyoutohandlemediacallsvideoetc.differentlybasedonwheretheequipmentisattachedtoyournetwork.不同（如Asterisk）其他软，不同的应用

FreeSWITCH允许您在处理不同的设备相连网络的媒体电话，视频，等）。

This

assistswithsecurityaswellasprovidingaddedfunctionality.这有助于安全，并提供额外

的功能。

SIPProfilesallowyoutodefinepathstodevicesorcarriersthatmayliveinsideoroutsideyournetwork.SIP的配置文件可用于定义路径的设备或运营商可住

内部或外部网络。

ThesepathscanbeofmanydifferenttypesbutmustconsistofauniquecombinationofportandIPpairs.这些路径可以有许多不同的类型，但必须由一

个端口和IP对独特的组合。

YoucouldhaveSIPprofilesforyourinternalnetworkormultipleprofilesforeachsubnetofyourinternalnetworkorevencompletelydifferentprotocolslikeIPv6asprofiledefinitions.你可能对您的内部网络，即每您的内

部网络，或者类似的文件定义甚至完全不同的IPv6协议的子网的SIP配置多个配

置文件。

ThishelpsFreeSWITCHidentifyhowtoroutedifferenttypesofcallswhennecessaryandalsogivesyoutheflexibilitytotailoryourdialplansbasedonwhatpathacalloriginatesto/from.这可以帮助FreeSWITCH确定如何路线不同类型的要求必要

时还能让你的灵活性以调整你的拨号方案基于路径的一个叫来源于/。

Inthesample

configurationtherearethreedefaultcategoriesforwhereaSIPProfilecanreside.在示例

配置有3个在一个SIP文件可以驻留默认类别。

Eachprofileisdetailedbelow.每个

配置文件的详细情况如下。

SIP_ProfilesThedefaultprofilesarequotinternalquotandquotexternalquoteachservesaspecialpurposesoitwouldbewisetounderstandwhattheydo.