===========================================

声明IAX2 user(在peer中)
如果想一个peer能收到呼叫. 必须在peer机器上设置iax.conf识别呼叫来自user.

[username]
type=user
auth=md5
secret=secretword
context=iax2users

context非常重要,他用来设置user新来的呼叫路由如何处理.

这个步骤将允许远程的user设备注册到peer上.如果你想限制请在peer的iax.conf里增加限制和许可的设置.

=================================

声明IAX2 peer(在user中)
从一个user产生呼叫的时候必须在user的iax.conf里设置到peer的验证.

[peername]
type=peer
host=hostname.domain.tld (如果用”dynamic”就要先进行一下register到peer)
auth=md5
secret=secretword ; 如果拨号的时候填写这里就不需要再填写
username=username-at-the-peer ; 如果拨号的时候填写这里就不需要再填写

请注意:

* type=user 表示你将通过这个号码将验证一个进来的呼叫
* type=peer 表示你将通过这个号码发送呼叫给某人
* type=friend 表示两个功能都有

Using type=friend makes life easier, but treat it as a shortcut. If you add both type=friend and host=hostname, domain.ext you limit the hosts your peer can place calls from, which may not be what you want.

现在完成第一步和第二步之后我们只需要考虑设置拨号方案了.读下面的例子看看怎么做吧.

================================
连接到拨号方案

示例1

extensions.conf:
exten => _7XXX,1,Dial(IAX2/myserver:passwordA@IAXserverA/${EXTEN:1},30,r)
exten => _7XXX,2,Dial(SIP/myserver:passwordA@SIPserverA/${EXTEN:1},30,r)
exten => _7XXX,3,Congestion

exten => _8XXX,1,Dial(IAX2/myserver:passwordB@IAXserverB/${EXTEN:1},30,r)
exten => _8XXX,2,Dial(SIP/myserver:passwordB@SIPserverB/${EXTEN:1},30,r)
exten => _8XXX,3,Congestion

记得要在iax.conf和sip.conf设置[IAXserverA]的这些定义.这个示例当出现问题后使用SIP做逃逸系统.注意你的用户名和密码可能会被CDR记录下来(你需要使用第二个示例的方法来实现隐藏).

示例2
这个示例将不会把用户名同密码显示在CDR当中

注意：在1.0.9版这个方法仍然不是Asterisk标准分支,所以仍然需要用户名和密码在dial字符串中
exten => _7XXX,1,Dial(IAX2/username:pass@serverB/${EXTEN:1},30,r)

(serverA)
iax.conf
[general]
register => <username>:<password>@<serverB hostname or IP>

[serverB]
type=friend
user=<username>
secret=<password>
host=<serverB hostname or IP>

extensions.conf
exten => _7XXX,1,Dial(IAX2/serverB/${EXTEN:1},30,r)
exten => _7XXX,2,Congestion

(serverB)
iax.conf
[serverA]
type=friend
user=<username>
secret=<password>
host=<dynamic> | <serverA hostname or IP>

extensions.conf
exten => _8XXX,1,Dial(IAX2/serverA/${EXTEN:1},30,r)
exten => _8XXX,2,Congestion

在一些时候serverA和serverB就是在对方服务器上的用户

示例3
在extensions.conf使用switch对象你可以连接两台服务器或是其他服务器的连接方案。在这个方案中我们自己的serverC将连接ServerA或serverB:

[default]
exten => _801XXX,1,Goto,srvA|${EXTEN}|1
exten => _802XXX,1,Goto,srvB|${EXTEN}|1

[srvA]
exten => _801XXX,1,StripMSD,3
exten => _XXX,2,Goto,1
switch => IAX/serverA

[srvB]
exten => _802XXX,1,StripMSD,3
exten => _XXX,2,Goto,1
switch => IAX/serverB

注意：你要注意不能建立死循环serverA到serverB并且serverB又到serverA!同样考虑使用iax.conf中设置autokill来杀掉被悬起长时间进程(当远程服务器无法连接)

示例4
extensions.conf: (主服务器)

[outbound]
switch => IAX2/master:secret@iax-gw1.company.net/outbound

iax.conf (主服务器):
[slave]
type=user
auth=plaintext
context=outbound
secret=secret
host=dynamic
callerid=”slave”
trunk=yes
notransfer=yes

[slave]
type=peer
auth=plaintext
context=outbound-nuphone
secret=secret
host=dynamic
trunk=yes
notransfer=yes

extensions.conf (从服务器):

[assigned-dids]
; uncomment a dial mechanism, first one goes to specific extension
; other one goes to dial parameter s.

;exten => 7046446999,1,Dial,IAX2/master@slave/${EXTEN}
;exten => 7046446999,1,Dial,IAX2/master@slave

iax.conf (从服务器):

register => slave:secret@iax-gw1.company.net

[master]
type=peer
host=iax-gw1.company.net
secret=secret
context=outbound
trunk=yes
canreinvite=no

[master]
type=user
secret=secret
context=acontext
trunk=yes
canreinvite=no

===========================
关于register命令
当peer的ip并不明确，用户将不知道如何发送呼叫信息(当一个办公室用户呼叫 在家里工作的peer，因为在家里工作的peer只有一个动态IP或他是在NAT设置) 这个时候peer要注册到user及时的把自己的IP告诉user:

在peer的iax.conf的[general]上怎么写:

register => user:password@hostname.domain.ext

因为不断更新所以user总是知道peer的ip是否改变了.

register命令仅仅被用在动态IP地址的情况下,如果两台服务器都是静态IP地址你不需要做任何设置.

关联阅读

• linux下面配置IAX（ZT）
• asterisk电子教程
• 使用IAX来搭建您的VOIP系统
• asterisk常用调试监测命令
• 基于asterisk的呼叫中心坐席呼叫方式
• asterisk兼容数字卡上面调试中国7号信令（ss7）
• IP分布式呼叫中心坐席电话该用硬电话还是软电话？
• asterisk用于CTI开发话务批发平台的需求
• Asterisk与Cent OS
• 我将公司电话系统拓展到了外地

另外，IAX还有一个特点，就是它可以将多个会话集中在一个数据流里传输，实际上的做法就是将多个数据流用一个数据报报头表示和概括。也就说IAX拥有中继Trunk能力，并也因为这个原因，IAX可以在中继流量的时候在一定程度上减小对带宽的消耗和需求。

这一话的目的也是非常简单，没有复杂的配置，仅仅是为了实现让个IAX的终端能够注册上Asterisk并且能够互相呼叫并和对方通话的功能。

系统环境：CentOS 5.0 Linux操作系统

Asterisk 1.4.5版本

IAX终端为iaxLite SoftPhone

一.修改配置文件

1.设定IAX配置文件：

在Asterisk当中IAX的特性配置文件都保存在iax.conf这个独立的配置文件当中。

[root@asterisk-test1 ~]# vi /etc/asterisk/iax.conf

———————————————–

与Asterisk其他配置文件一样，iax.conf中也是采用分段配置的结构，并且也是使用分号“;”来注释掉配置项的。

[general]

全局配置段“general”里面可以写上对IAX全局的全局配置信息，这里配置的条目将影响整个Asterisk中IAX的性能。

bindport=4569

指定IAX2协议的监听端口，这里我使用默认的4569。

bindaddr=0.0.0.0

指定IAX2协议监听的网络接口。这里我设定为0.0.0.0表示对系统的所有网络接口进行监听。

;iaxcompat=yes

设定IAX的协作性和兼容性。如果打算使用分层式交换或者其他一些方案，而这些都会在拨号方案查找时造成延迟的时候，应该将这项设定为“yes”。启用该项会对系统性能造成一个小小的冲击。这个选项会造成Asterisk在收到一个IAX拨号规则请求时衍生一个分开独立的线程，而不是傻堵在那里等待一个回应。这里我采用默认的“yes”。

;nochecksums=no

设定关闭UDP校验。如果设定“yes”关闭UDP校验的话，那么在你的系统上将不会为UDP计算以及检察校验和。这里我采用默认的“no”，表示启用UDP校验。

;delayreject=yes

设定拒绝硬直。为了提高系统安全以及防止暴力密码破解攻击，开启拒绝硬直功能后，验证失败的对象必须要经过一段时间的硬直状态才能进行下一次验证的尝试。这里我也采用默认的“yes”，表示开启拒绝硬直功能。

;amaflags=default

设定AMA标记类型。AMA的全称是“Automated Message Accounting”，自动消息记帐。可以为IAX呼叫指定一个全局的默认AMA标记类型，这些标记将会在生成CDR时被用到，而这些记录的类型必须是以下种类：

（1）default: 默认，设定为系统默认。这里我使用默认的“Default”类型。

（2）omit: 忽略，不记录呼叫。

（3）billing: 计费，打上标记作为计费用。

（4）documentation: 文档说明，打上标记作为文档说明。

;adsi=no

设定是否开启ADSI功能。所谓ADSI全称就是“Analog Display Services Interface”即模拟显示服务接口，大致意思就是一种让模拟电话也能处理数字信息服务的接口，就像那种带有屏幕而又通过电话线连接的电话机，这些电话机上面可以支持比如发短信或者其他的服务功能，但是这些都需要你平台支持ADSI服务接口。现在当然不需要啦，所以我选择默认的“no”，关闭掉它。

;accountcode=lss0101

设定帐户代码。指定一个默认全局的帐户代码，也可以为每个帐户指定各自的帐户代码，这将会记录到CDR当中去。这里暂时不涉及到计费以及CDR，所以使用默认的注释掉该项。

;language=en

设定对用户的全局默认语言种类，也可以为每个帐户指定各自的语言种类。如果忽略该项的话，就使用默认的英语语言。这里使用默认的英语。

;mohsuggest=default

;mohinterpret=default

设定电话挂起的时候通道里播放的内容。如果是“default”的话，那么当电话挂起的时候，通道里就会播放拨号规则里指定的音乐。如果是“passthough”的话，就会用消息信号代替。这里使用默认的“default”。

接下来是编解码设定部分：

bandwidth=low

设定带宽。指定低、中、高带宽来控制编解码。这里使用默认的低带宽。

disallow=all

这里首先关闭所有的编解码。目的是为了只开放指定允许的编解码。

allow=gsm

然后允许GSM的编解码。在IAX当中使用GSM编解码比较多，因为比较节省带宽。

allow=g729

然后再允许G.729的编解码。G.729也是非常优秀的编解码，但是这存在版权问题，貌似在没有获得许可的情况下，你只能用G.729进行解码而不能编码，否则要负法律责任的哟。

jitterbuffer=no

设定抗抖动缓冲。设定是否要全局缓冲，在不稳定的网络环境下应该启用，一般情况不需要。因为终端设备会对抖动处理缓冲。使用默认的“no”。

forcejitterbuffer=no

设定强制抗抖动缓冲。一般来说应该是在通信通道上做抗抖动的缓冲，而不是在交换系统局端上作，因为终端设备会自己处理抖动缓冲，所以一般也不需要。使用默认的“no”。

;maxjitterbuffer=1000

设定最大抗抖动缓冲。单位是毫秒，设定得合适会使抖动问题得到改善，设定过大会造成额外的延迟。

;maxjitterinterps=10

设定最大抖动补偿。设定在一次返回列中抗抖动缓冲应该返回的补偿帧的最大数量。

;resyncthreshold=1000

设定重新同步阀值。当抗抖动缓冲注意到一个巨大的改变可能造成持续好几帧发生延迟的时候，它就会去重新同步。设定“-1”表示关闭重新同步功能。

至于IAX中继设定部分，这里就不详细展开交待了。

;trunkfreq=20

;trunktimestamps=yes

;authdebug=no

;regcontext=iaxregistrations

autokill=yes

;rtcachefriends=yes

;rtupdate=yes

;rtautoclear=yes

;rtignoreregexpire=yes

接下来是IAX对象设定部分：

[iax](!)

这里设定的是iax小节，后面的“（!）”表示它是一个属性抽象类，它本身不是对象实例，却定义了很多属性值，提供其他实体来继承它的属性。

type=friend

指定类型为Friend“友端”，即可以对Asterisk进行呼叫也可以被Asterisk呼叫的这种双向类型终端。

其他的还有Peer“对端”，即只能作为被Asterisk呼叫的类型终端。

以及的还有User“用户端”，即只能作为呼叫Asterisk的类型终端。

host=dynamic

指定终端主机位置。这里可以取2种值：

static“静态”表示服务的终端对象的IP是固定已知的；

dynamic“动态”表示服务的终端对象IP是动态的不确定的，每次要联系Asterisk的话就必须要注册上来。

port=4569

设定IAX监听端口。其实和全局里设定的是一样的话就可以省去。

context=demo2

指定该段内的对象所使用的拨号规则，全部对应extensions.conf文件中的[demo2]小节内定义的规则。

[8801](iax)

这里定义了名字为“8801”的小节，后面跟“（iax）”，这表示该段定义的对象将继承[iax]定义段内的属性。

username=8801

指定该对象的用户名。

secret=123456

指定该对象的密码。

[8802](iax)

username=8802

sercret=123456

同样，对象8802也继承sip抽象类中的公共属性。

———————————————–

2.配置拨号规则文件

[root@asterisk-test1 ~]# vi /etc/asterisk/extensions.conf

———————————————–

配置方式也是同样，通过定义每一个小节，再在每一个小节中定义详细的属性。

这里比较重要的是“general”和“globals”这两个默认就有的小节，也是起到“全局属性”的作用，请根据实际情况确定，但请不要删除这两个小节。其他的小节都是可以订制、删除修改的。

[general]

static=yes

writeprotect=no

autofallthrough=no

clearglobalvars=no

priorityjumping=no

[globals]

CONSOLE=Console/dsp

IAXINFO=guest ; IAXtel username/password

TRUNK=Zap/g2 ; Trunk interface

TRUNKMSD=1 ; MSD digits to strip (usually 1 or 0)

其他的不重要的小节我都删除了，这里我自定义一个简单的拨号规则。小节取名为“demo2”，与iax.conf里面的context项中指定的规则小节名对应。

[demo2]

exten => _88.,1,Dial(IAX2/${EXTEN},20,r)

(1)规则就一条，使得8801和8802可以互相拨打。当中的格式简要讲述一下。更多的请参考Asterisk的手册，这里不详细展开。

(2)开头部分“exten =>”表示，也可以用“exten =”表示。并且在一个小节内可以定义多条exten语句。

(3)之后的“_88.”表示匹配上所有“88”开头的拨号，“.”表示不限制长度的任意字符。

(4)然后的“1”表示优先级，我喜欢称作为“执行次序”。“1”表示第一步执行的意思，如果后续还需要执行其他动作的话，可以继续写多条exten语句，并且用递增执行次序依次设计下去。

(5)接着的“Dail()”表示“执行动作”，这里是表示拨号的执行动作。更规范的说，这个是APP应用程序。

(6)括号当中又分成3个部分。第一个IAX2表示拨号动作中拨向的通道是IAX2协议的通道。${EXTEN}则一个变量，其值就是用户实际拨打的号码。如果你拨打8801那么${EXTEN}的值就是8801。

(7)括号内的“20”，表示等待时间单位秒，如果有多个执行次序，即一组拨号规则的话，如果过了20秒，就跳跃执行次序（跳跃的幅度是101个优先级）。

(8)最后的“r”表示强行播放振铃。在拨打对方等待对方接通的时候，就能听到回振铃音。

———————————————–

二.测试：

1.进入Asterisk控制台刷新配置。

[root@asterisk-test1 ~]# /usr/local/asterisk/sbin/asterisk -crvvvvv

———————————————–

Asterisk 1.4.5, Copyright (C) 1999 – 2007 Digium, Inc. and others.

Created by Mark Spencer <markster@digium.com>

Asterisk comes with ABSOLUTELY NO WARRANTY; type ‘core show warranty’ for details.

This is free software, with components licensed under the GNU General Public

License version 2 and other licenses; you are welcome to redistribute it under

certain conditions. Type ‘core show license’ for details.

=========================================================================

== Parsing ‘/etc/asterisk/asterisk.conf’: Found

== Parsing ‘/etc/asterisk/extconfig.conf’: Found

Connected to Asterisk 1.4.5 currently running on asterisk-test1 (pid = 1929)

Verbosity is at least 5

asterisk-test1*CLI> reload

当Asterisk需要完全重载所有配置的时候，就需要在控制台当中使用reload命令，而没有必要去重新启动服务。重新载入当中会产生大量信息,这里只贴出一部分。

……

……

– Reloading module ‘chan_iax2.so’ (Inter Asterisk eXchange (Ver 2))

== Parsing ‘/etc/asterisk/iax.conf’: Found

[Oct 30 13:48:44] NOTICE[4395]: chan_iax2.c:9071 set_config: Ignoring bindport on reload

[Oct 30 13:48:44] NOTICE[4395]: chan_iax2.c:9130 set_config: Ignoring bindaddr on reload

这个部分是重载IAX配置以及模块。

…..

…..

[Oct 30 13:48:44] NOTICE[4395]: pbx_ael.c:3984 pbx_load_module: AEL load process: compiled config file name ‘/etc/asterisk/extensions.ael’.

[Oct 30 13:48:44] NOTICE[4395]: pbx_ael.c:3987 pbx_load_module: AEL load process: merged config file name ‘/etc/asterisk/extensions.ael’.

[Oct 30 13:48:44] WARNING[4395]: pbx.c:6236 ast_context_verify_includes: Context ‘ael-local’ tries includes nonexistent context ‘ael-parkedcalls’

[Oct 30 13:48:44] WARNING[4395]: pbx.c:6236 ast_context_verify_includes: Context ‘ael-dundi-e164-local’ tries includes nonexistent context

‘ael-dundi-e164-canonical’

[Oct 30 13:48:44] WARNING[4395]: pbx.c:6236 ast_context_verify_includes: Context ‘ael-dundi-e164-local’ tries includes nonexistent context

‘ael-dundi-e164-customers’

[Oct 30 13:48:44] WARNING[4395]: pbx.c:6236 ast_context_verify_includes: Context ‘ael-dundi-e164-local’ tries includes nonexistent context

‘ael-dundi-e164-via-pstn’

[Oct 30 13:48:44] NOTICE[4395]: pbx_ael.c:3990 pbx_load_module: AEL load process: verified config file name ‘/etc/asterisk/extensions.ael’.

– Reloading module ‘pbx_dundi.so’ (Distributed Universal Number Discovery (DUNDi))

== Parsing ‘/etc/asterisk/dundi.conf’: Found

== MGCP Listening on 0.0.0.0:2727

== Using TOS bits 0

这些是重载拨号规则部分。

……

……

独立重新载入IAX，这样不大会影响Asterisk其他部分。

asterisk-test1*CLI> iax2 reload

== Parsing ‘/etc/asterisk/iax.conf’: Found

[Oct 30 14:40:54] NOTICE[4704]: chan_iax2.c:9071 set_config: Ignoring bindport on reload

[Oct 30 14:40:54] NOTICE[4704]: chan_iax2.c:9130 set_config: Ignoring bindaddr on reload

== Parsing ‘/etc/asterisk/users.conf’: Found

– Seeding ‘8801′ at 192.168.0.199:4569 for 60

– Seeding ‘8802′ at 192.168.0.149:4569 for 60

== Loaded firmware ‘iaxy.bin’

== Parsing ‘/etc/asterisk/iaxprov.conf’: Found

– Loaded provisioning template ‘default’

———————————————–

2.注册终端

在这次测试当中我使用的是iaxLite SoftPhone。注册帐户分别是8801和8802，密码123456。

———————————————–

– Registered IAX2 ‘8801′ (AUTHENTICATED) at 192.168.0.199:4569

[Oct 30 14:06:49] NOTICE[2018]: chan_iax2.c:5699 update_registry: Restricting registration for peer ‘8801′ to 60 seconds (requested 300)

这个是8801注册上来后在Asterisk控制台上看到的信息。

– Registered IAX2 ‘8802′ (AUTHENTICATED) at 192.168.0.149:4569

[Oct 30 14:07:04] NOTICE[2020]: chan_iax2.c:5699 update_registry: Restricting registration for peer ‘8802′ to 60 seconds (requested 300)

这个是8802注册上来后在Asterisk控制台上看到的信息。

———————————————–

3.察看注册信息

asterisk-test1*CLI> iax2 show peers

———————————————–

Name/Username Host Mask Port Status

8802/8802 192.168.0.149 (D) 255.255.255.255 4569 Unmonitored

8801/8801 192.168.0.199 (D) 255.255.255.255 4569 Unmonitored

2 iax2 peers [0 online, 0 offline, 2 unmonitored]

———————————————–

4.互相呼叫

（1）8801呼叫8802，8802接通并且由8801主叫方挂断。

———————————————–

– Remote UNIX connection

– Accepting AUTHENTICATED call from 192.168.0.199:

从通过验证端192.168.0.199发起呼叫。

> requested format = g729,

请求使用的编解码是G.729。

> requested prefs = (),

> actual format = gsm,

实际使用格式为GSM。

> host prefs = (gsm|g729),

> priority = mine

– Executing [8802@demo2:1] Dial(“IAX2/8801-3″, “IAX2/8802|20|r”) in new stack

按照拨号方案demo2来执行拨号8802。

– Called 8802>

被叫方8802

– Call accepted by 192.168.0.149 (format gsm)

呼叫被192.168.0.149接受了，格式为GSM。

– Format for call is gsm

呼叫格式为GSM。

– IAX2/8802-6 is ringing

用户8801呼叫用户8802，编码是GSM，并且8802已经在振铃。

– IAX2/8802-6 answered IAX2/8801-5

用户8802应答了用户8801。

– Channel ‘IAX2/8801-5′ ready to transfer

通道IAX2/8801-5已经准备好传输。

– Channel ‘IAX2/8802-6′ ready to transfer

通道IAX2/8802-6也已经准备好传输。

– Releasing IAX2/8802-6 and IAX2/8801-5

释放IAX2/8802-6以及IAX2/8801-5通道建立。

== Spawn extension (demo2, 8802, 1) exited non-zero on ‘IAX2/8801-5′

– Hungup ‘IAX2/8801-5′

最后由8801-5挂断连接。

———————————————–

（2）8802呼叫8801，8801接通。

———————————————–

– Remote UNIX connection

– Accepting UNAUTHENTICATED call from 192.168.0.149:

> requested format = g729,

> requested prefs = (),

> actual format = gsm,

> host prefs = (gsm|g729),

> priority = mine

– Executing [8801@demo2:1] Dial(“IAX2/8802-6″, “IAX2/8801|20|r”) in new stack

– Called 8801

– Call accepted by 192.168.0.199 (format gsm)

– Format for call is gsm

– IAX2/8801-7 is ringing

– IAX2/8801-7 answered IAX2/8802-6

– Channel ‘IAX2/8801-7′ ready to transfer

– Channel ‘IAX2/8802-6′ ready to transfer

– Releasing IAX2/8802-6 and IAX2/8801-7

———————————————–

三.问题：

通是通了，通话也没有什么问题，但是还有几个地方不是非常明白：

1.口令错误的终端照样可以以（UNAUTHENTICATIED）的方式注册到Asterisk上并且还能呼叫连接。

2.被叫端不能主动挂断电话。

3.有个别几通电话，主叫方已经断线了，被叫方竟然还显示自己是连接状态并且挂不断。

目前还没有解决这些问题，等解决了把原因以及解决方法帖上。

最后要提一个比较有意思的地方，IAX的正确读法好像应该是“eeks”，而不是字面上那样读成“ai-ei-eks”。

读错的人，会被老鸟嘲笑。

关联阅读

• IAX 设置详细（zt）
• asterisk电子教程
• 使用IAX来搭建您的VOIP系统
• asterisk常用调试监测命令
• 基于asterisk的呼叫中心坐席呼叫方式
• asterisk兼容数字卡上面调试中国7号信令（ss7）
• IP分布式呼叫中心坐席电话该用硬电话还是软电话？
• asterisk用于CTI开发话务批发平台的需求
• Asterisk与Cent OS
• 我将公司电话系统拓展到了外地

关联阅读

• IP分布式呼叫中心坐席电话该用硬电话还是软电话？
• IAX 设置详细（zt）
• linux下面配置IAX（ZT）
• 典型VOIP外呼型呼叫中心系统需求
• 一个遍布分支机构的大型企业呼叫中心解决方案
• 广州毅航的可编程交换机
• 基于VOIP技术的呼叫中心成为必然
• 一个台湾朋友给我的关于呼叫中心的启示
• 一个做呼叫中心的同行的2010年
• 平安E家