查看“中继模块”的源代码

=Trunks 模块用户使用指南=

'''总览'''
中继模块是PBX中的核心模块，用来连接PBX和SIP运营商或PSTN 运营商。同样，这个模块可以用来对接几个PBX系统。大部分使用的中继是SIP 或者 DAHDi (通过语音卡连接PSTN)。<br/>
'''Logging in'''<br/>
•	从菜单顶部登录，点击 Connectivity<br/>
•	从下拉菜单中点击 Trunks<br/>

'''Adding a Trunk'''<br/>
如果用户需要添加中继的话，可以点击以下相应的中继类型。这里我们仅支持一般标准的中继类型，如果是非标准的中继设置，请访问官方网站获得更多支持。
 
http://wiki.freepbx.org/download/attachments/28770436/TRUNKTYPES.png

'''General Settings'''<br/>
http://wiki.freepbx.org/download/attachments/28770436/TRUNKGENERAL.png

'''Trunk Name'''<br/>
输入一个中继名称描述。<br/>

'''Outbound CallerID'''<br/>
设置 caller ID，通过此中继呼出时，将携带此号码。格式为 <NXXNXXXXXX> 。如果线路支持（例如E1/T1/J1/SIP/IAX2）号码隐藏的话，用户可以以这样的方式设置 “hidden” <NXXNXXXXXX> 来隐藏号码。<br/>

'''CID Options'''<br/>
设置什么类型的中继号码可以允许使用. 请注意，如果此中继支持了紧急呼叫中继设置，在分机或者设备中定义的紧急呼叫CID将在此中继中使用。<br/>

'''Allow Any CID'''<br/>
所有的 CID号码，包括国外的 CIDs 号码都将被发送出去。

'''Block Foreign CIDs'''<br/>
过滤 从第三方系统前转过来的任何 CID。在分机或设备中设置的CID都可以发送。

'''Remove CNAM'''<br/>
从CID中移除的 CNAM (Name)。

'''Force Trunk CID'''<br/>
强制使用此中继定义的CID 号码，如果此中继是紧急呼叫路由的一个部分，则使用分机或者设备中定义的仅仅CID 号码。Intra-Company 路由则总是传输分机号码或名称。<br/>

'''Maximum Channels'''<br/>
控制管理此中继的呼出通道的最大呼叫数量（并发数量）。此值为空，则为无限制。<br/>

'''Continue if Busy'''<br/>
如果此中继是拥塞状态，忙状态，或者其他的无效状态时，PBX将尝试使用下一个中继呼出。如果用户勾选了此设置，PBX将强制失败的呼叫继续尝试已配置的中继或目的地对象。这个选项通常是未勾选状态。

'''Disable Trunk'''<br/>
关闭此选项，此中继将不被使用。<br/>

'''Dial Pattern Manipulation Rules'''<br/>
http://wiki.freepbx.org/download/attachments/28770436/TRUNKDP.png
拨号模式匹配可以在中继出局前对已拨号码进行号码编辑或号码变换。如果没有任何规则的话，号码不会发生变化。原始已拨号码在路由处的拨号规则经过号码变换处理，然后继续被发送到下一个流程。此中继支持了对此号码的进一步号码处理变换。如果号码匹配了前缀加match pattern 组合形式，PBX将使用此匹配模式，接下来的其他规则就被忽略。如果PBX 成功匹配了其中一个模式，则出局前，前缀号码将被移除，然后在match pattern 前面加 预设的prepend 数字，最终预设号码加match pattern 中的号码将被发送出去。其他选项都是可选的。<br/>
 
'''Pattern	使用描述'''<br/>
X	匹配任何数字，只要是0-9。<br/>
Z	匹配任何数字，只要是1-9。<br/>
N	匹配任何数字，只要是2-9。<br/>
[1237-9]	匹配任何括号中的数字。<br/>
. (dot)	通配符，匹配一个或多个已拨号码数字。<br/>

'''Prepend'''<br/>
预设号码前缀。 如果用户已拨号码成功匹配了 prefix加match pattern，则在中继出局前，移除prefix， 在match pattern 前加此预设的数字号码。<br/>

'''Prefix'''<br/>
号码前缀。如果用户已拨号码成功匹配了prefix加match pattern ，则在中继出局前移除这个前缀号码，如果带预设号码的话，

'''match pattern'''
加预设号码出局。如果没有带可选的预设号码，则仅发送match pattern 号码出局。<br/>
Match pattern<br/>
匹配模式。用户已拨号码将匹配prefix 和match pattern 的匹配模式。如果成功匹配，则移除号码前缀，加一个预设号码出局（如果设置了预设号码）。当然用户也可以仅完全匹配号码前缀，然后加一个预设号码，match pattern 为空。<br/>

'''Dialled Rules Wizard'''
'''Always dial with prefix'''<br/>
中继号码前缀快速拨号。对voip 中继来说，这个功能非常简单实用。例如，如果用户拨打了号码 "5551234”， PBX 会自动转换此号码为 "16135551234”。<br/>

'''Remove prefix from local numbers'''<br/>
对语音板卡支持的Dahdi 中继非常有用，如果用户拨打的是一个本地号码 "6135551234”的话，PBX 会自 "555-1234”。通常来说，拨打本地号码无需添加本地前缀。<br/>

'''Setup directory assistance'''<br/>
可以通过此选项转换此呼叫进行 目录查询协助。<br/>

'''Lookup numbers for local trunk'''<br/>
本地中继号码查询服务。通过号码查询服务的资源例如  www.localcallingguide.com ， 创建号码归属，所以用户通过本地中继拨打7位数或者10位数 来直接进行呼叫。通常情况下，用户需要拨打1+区号（长途电话）+号码，但是通过这样的方式，用户可以直接拨打 “5551234” (7位数拨号)  或者 “6135551234” (10位数拨号) 来实现本地呼叫。 注意，以上设置仅支持北美地区的号码范围。<br/>

'''Upload from CSV'''<br/>
支持上传一个拨号匹配模式CSV 文件来替换当前的整个文件。如果没有文件头的话，则文件必须至少设置3个列，需要和界面的列顺序一致。用户有可以设置3个文件头，在第一行中包括: prepend, prefix 和 match pattern 。如果少于3个文件头，剩余的列将是空白。<br/>

'''Outbound Dial Prefix'''<br/>
呼出拨号前缀，呼出前在中继添加的前缀号码。例如，如果此中继是在另外一个PBX 背后的系统中，用户需要拨打9 或者其他的数字通过这个PBX 出局。如果中继线路是POTS 线路的话，常用的做法是设置为“w”，让系统等待 500ms ，以便有足够的时间来等待拨号音，避免已拨打数字号码丢失。大部分情况下，此设置为空白。<br/>

'''SIP (chan_sip)/IAX2 Specific Settings'''<br/>
http://wiki.freepbx.org/download/attachments/28770436/SIPTRUNK.png

Trunk Name<br/>
指定一个中继名称，例如 “mysiptrunk”。<br/>

PEER Details<br/>
这里的 PEER 信息是用来对接运营商的帐号信息。用户可能需要添加设置或者删除一些设置，完全取决于运营商的要求。<br/>
注意 <br/>
这里的配置顺序非常重要。例如，如果用户使用了  “allow/deny” ，那么必须确保第一个是 “deny”。<br/>

USER Context<br/>
这里是运营商要求提供的帐号或号码信息。<br/>
USER Details<br/>
这里是用户连接运营商的参数设置。因为运营商要求的不同，用户可能需要添加或者删除一些设置参数。<br/>

Register String
大部分运营商要求用户PBX 系统注册到运营商侧。如果有此要求，用户需要输入运营商提供的注册信息。例如，<br/>username:password@some.voipprovider.com。
还有一些环境下，用户也需要提供DID号码注册：<br/>
例如：username:password@some.voipprovider.com/7045551212.<br/>

'''DAHDI Specific Settings'''<br/>
http://wiki.freepbx.org/download/attachments/28770436/DAHDITRUNK.png

DAHDi (简称为Digium Asterisk 硬件设备接口)。Dahdi 是asterisk 语音卡的通信接口，它可以支持模拟接口（FXS/FXO）和数字接口（E1/PRI）。用户需要参考硬件安装文档来实现语音卡的初始化配置。然后可以通过 DAHDi 中继模块来集成呼出呼入的路由和分机设置。请用户先参考相应的dahdi 语音板卡配置使用指南配置板卡后执行中继的配置。<br/>
DAHDI 配置文件由 DAHDI 配置模块来管理。一旦成功配置好板卡以后，用户可以通过中继界面选择Dahdi 中继出局。<br/>
 
DAHDI Trunks<br/>
用户可以通过选择不同的组来进行轮询呼叫。参考一下表做相应的调整。在这个表中，我们使用了Group 0 (Zero) 作为轮询策略方式。<br/>
Managed	Unmanaged	Scheme<br/>
Group 0 Round Robin Assending	r0	选择有效通道，从低到高执行依次执行。<br/>
Group 0 Round Robin Descending	R0	选择有效通道，从高到低依次执行。<br/>
Group 0 Ascending	g0	选择第一个有效通道，从低到高依次执行。<br/>
Group 0 Descending	G0	选择第一个有效通道，从高到低依次执行。<br/>
SIP TRUNK(PJSIP)
Simple  // simple 配置方式<br/>
http://wiki.freepbx.org/download/attachments/28770436/PJTRUNK.png

配置SIP 中继时，如果用户选择的是 simple 方式，则可以看到以下设置.<br/>
 
Permanent Auth Rejection<br/>
设置验证失败是否认为是永久验证失败。<br/>

Retry Interval<br/>
Retries 之间的时间间隔。<br/>

Expiration<br/>
注册超时，以秒为单位。<br/>

Forbidden Retry Interval<br/>
当收到 403 Forbidden response 后，重新尝试的时间间隔。<br/>

Max Retries<br/>
最多尝试注册次数。<br/>

Qualify Frequency<br/>
发送qualify 的周期间隔。<br/>

Username<br/>

SIP Username<br/>

Secret<br/>

SIP 密码<br/>

SIP Server<br/>

SIP 服务器地址<br/>

SIP Server Port<br/>

SIP 端口<br/>

Outbound Proxy <br/>

SIP 代理<br/>

Contact User<br/>
请求消息中使用的 Contact User 信息。<br/>

Context
发送呼入呼叫的Context 目的地（逻辑组）。<br/>

Transport<br/>
使用的传输方式（TCP/UDP）<br/>

Codecs<br/>
勾选需要的编码支持，通过拖拉编码选项可以重新排序。<br/>

Advanced<br/>
当配置选项设置为 Advanced  方式时，用户可以看到以下选项：<br/>
http://wiki.freepbx.org/download/attachments/28770436/PJSIPADV.png

Client URI<br/>
呼出注册时，使用Client SIP URI 。<br/>

Server URI<br/>
服务器的 SIP URI 地址。<br/>

AOR Contact<br/>
指定到 AoR 的永久contacts。<br/>

ENUM TRUNK<br/>
ENUM (E.164 号码映射机制) 是一种号码管理的方式，使用特别的DNS 记录把号码翻译成URL的方式。URL 地址反过来可以转换成IP地址 或者特别的分机形式，这种形式可能指定到远端接收系统的相应的IP地址。这个功能非常有用，在IP网络和PSTN 网络环境中，可以支持PSTN 号码的标准化管理。<br/>
ENUM 查询是通过 e164.org  自动获得，因此需要一点简单配置。更多ENUM 工作方式，可以访问http://www.e164.org/  获得。<br/>


'''DUNDi Trunk'''<br/>
http://wiki.freepbx.org/download/attachments/28770436/DUNDITRUNK.png
DUNDi (Distributed Universal Number Discovery,  分布式通用号码查询)  是一种可信赖，点-对点网络。它的功能类似于ENUM，但是DUNDi 并不是使用集中式服务方式，而是使用分布式的方式来查询。具体设置，请参考 http://www.dundi.com  网站，具体的dundi.conf  配置请参考此链接 http://doxygen.asterisk.org/trunk/Config_dun.html 。<br/>
FreePBX 可以对DUNDi  中继提供一个非常有效的功能支持，但是要求用户做一些手动的配置工作。中继名称需要匹配到远端的dundi.conf 的 [mappings] 配置中。例如以下设置 :<br/>
[mappings]<br/>

priv => dundi-extens,0,IAX2,priv:${SECRET}@218.23.42.26/${NUMBER},nopartial<br/>
在这个例子中，用户需要创建一个中继，命名为 priv。用户还需要一个IAX2 中继来配合DUNDi 工作。IAX2 中继可以通过 配置iax_custom.conf  来创建。<br/>

DUNDi Mapping<br/>
通过dundi.conf 文件，我们已经定义了 DUNDi mappings 的名称。这个文件命名和本地 dundi.conf 文件中peer  details 的include部分相对应。<br/>

'''Custom Trunk'''<br/>
自定义中继是非常有用的一种连接方式，可以用来支持一些特别的，非标准的第三方设备网关，例如手机网络，H323 中继，以及其他未在PBX默认 支持的通信接口。<br/>
http://wiki.freepbx.org/download/attachments/28770436/CUSTOMTRUNK.png

Custom Dial String<br/>
用户定义一个自定义的拨号字符串。用户可以使用变量  $OUTNUM$  设定一个拨出号码直接呼出。例如：<br/>
•	Local/$OUTNUM$@leastcost-custom<br/>
•	SIP/$OUTNUM$@192.168.41.23:5064<br/>
•	IAX2/$OUTNUM$@10.100.1.11<br/>
实际呼出时，根据用户设定的号码不同，可能呼叫不同的被呼叫方。例如，如果用户设定的$OUTNUM$ 号码是5223211， 则最后呼出号码就是SIP/5223211@192.168.41.23:5064。<br/>