Asterisk/FreeSWITCH SIP Trunk 对接配置检查清单

预配置检查清单

在开始配置SIP trunk之前，请确保以下条件已满足：

Asterisk 配置

sip.conf 配置示例

; /etc/asterisk/sip.conf

[cainiao-trunk]
type=peer
host=sip.cainiaovoice.com
port=5060
transport=udp
context=from-cainiao
disallow=all
allow=g711
allow=g729
allow=g722
dtmfmode=rfc2833
insecure=port,invite
qualify=yes
qualifyfreq=60
nat=force_rport,comedia
canreinvite=no

; SIP注册（如需要）
register => username:password@sip.cainiaovoice.com:5060/100

extensions.conf 拨号计划

; /etc/asterisk/extensions.conf

[from-cainiao]
; 入站呼叫处理
exten => _X.,1,NoOp(入站呼叫来自 ${CALLERID(num)})
exten => _X.,n,Dial(SIP/1001,30)
exten => _X.,n,Hangup()

[outbound-cainiao]
; 出站呼叫 - 国内
exten => _0XXXXXXXXXX,1,NoOp(拨打 ${EXTEN})
exten => _0XXXXXXXXXX,n,Dial(SIP/cainiao-trunk/${EXTEN})
exten => _0XXXXXXXXXX,n,Hangup()

; 出站呼叫 - 国际
exten => _00X.,1,NoOp(国际拨打 ${EXTEN})
exten => _00X.,n,Dial(SIP/cainiao-trunk/${EXTEN:2})
exten => _00X.,n,Hangup()

关键配置说明

• dtmfmode=rfc2833：推荐使用RFC2833传输DTMF，兼容性最好
• nat=force_rport,comedia：NAT穿透配置，解决单向音频问题
• qualify=yes：启用心跳检测，实时监控网关连通性
• canreinvite=no：禁止直接RTP连接，确保媒体流经过Asterisk

FreeSWITCH 配置

网关配置

<!-- /etc/freeswitch/sip_profiles/external/cainiao.xml -->
<include>
  <gateway name="cainiao-trunk">
    <param name="realm" value="sip.cainiaovoice.com"/>
    <param name="username" value="your_username"/>
    <param name="password" value="your_password"/>
    <param name="register" value="true"/>
    <param name="caller-id-in-from" value="true"/>
    <param name="ping-interval" value="30"/>
    <param name="extension" value="100"/>
  </gateway>
</include>

拨号计划

<!-- /etc/freeswitch/conf/dialplan/default.xml -->
<extension name="outbound-cainiao">
  <condition field="destination_number" expression="^(.+)$">
    <action application="set" data="effective_caller_id_number=your_did"/>
    <action application="bridge" data="sofia/gateway/cainiao-trunk/$1"/>
  </condition>
</extension>

3CX 快速配置

1. 进入3CX管理后台 → SIP Trunks → Add SIP Trunk
2. 选择"Generic SIP Trunk"模板
3. 填写：主服务器=sip.cainiaovoice.com, 端口=5060
4. 认证ID=your_username, 密码=your_password
5. 选择Bridge模式，配置STUN服务器（stun.3cx.com）
6. 编解码器选择G.711和G.729
7. 创建入站/出站路由规则

Cisco CUCM 配置

1. 创建SIP Trunk Security Profile: Device → Device Settings → SIP Trunk Security Profile
2. 创建SIP Profile: 选择标准SIP Profile，启用SIP OPTIONS Ping
3. 创建SIP Trunk: Device → Trunk，选择上方创建的Security Profile和SIP Profile
4. 配置Destination Address: sip.cainiaovoice.com:5060
5. 创建Route Pattern: Call Routing → Route/Hunt → Route Pattern
6. 设置Calling Search Space和Partition权限

故障排查清单

安全加固清单

• IP白名单：防火墙只允许SIP服务商IP访问5060/5061和RTP端口
• SIP TLS加密：使用TLS（端口5061）加密SIP信令
• SRTP加密：启用SRTP加密RTP媒体流
• 强密码：使用16位以上随机密码，定期更换
• fail2ban：配置fail2ban自动封禁恶意IP
• 国际呼叫权限：设置国际呼叫白名单，防止toll fraud
• 消费上限：配置每日/每月消费上限和异常告警
• 禁用外网AMI/HTTP：不要将管理接口暴露到公网