SIP 中继设置

本文介绍所有与 SIP 中继相关的设置，以供参考。

基本设置

基本设置
设置 说明
名称 设置易于识别的中继名称。
中继状态 启用或禁用中继。
选择 SIP 运营商模板 选择 SIP 运营商所在的国家。
注： 如果系统未提供中继模板可适用于你的 SIP 运营商，选择该设置项为 通用。
SIP 运营商 选择已认证的 SIP 运营商以获取模板配置。
详细配置
设置 说明
中继类型 选择中继类型：
  • 注册中继
  • 点对点中继
  • 账号中继
注册中继
协议 选择 SIP 运营商提供的传输协议。
注： 如果选择 TCP，你需要确保 SIP TCP 端口已启用（路径： PBX 设置 > SIP 设置 > 常规 > 基本 > SIP TCP 端口）。
域名/IP地址 填写 SIP 运营商提供的中继域名/IP 地址。
端口 填写 SIP 运营商提供的 SIP 端口号。
主域服务器 填写 SIP 运营商提供的主域服务器。
注： 如果运营商没有提供主域服务器，则填写域名或 IP 地址。
用户名 填写注册中继的账号名称。
密码 填写与用户名匹配的密码。
认证名称 填写中继注册时，认证 SIP 的名称。一般与用户名一致。
启用呼出代理服务器 如果该中继使用了呼出代理服务器，当用户通过该中继拨打外线电话的时候，所有的 SIP 包将会被发送到代理服务器。
注： 联系你的 SIP 运营商确认是否支持呼出代理，再根据 SIP 运营商的指导配置呼出代理设置。
点对点中继
协议 选择 SIP 运营商提供的传输协议。
注： 如果选择 TCP，你需要确保 SIP TCP 端口已启用（路径： PBX 设置 > SIP 设置 > 常规 > 基本 > SIP TCP 端口）。
域名/IP地址 填写 SIP 运营商提供的中继域名/IP 地址。
端口 填写 SIP 运营商提供的 SIP 端口号。
主域服务器 填写 SIP 运营商提供的主域服务器。
注： 如果运营商没有提供主域服务器，则填写域名或 IP 地址。
账号中继
协议 选择要注册的第三方设备使用的传输协议。
注： 如果选择 TCP，你需要确保 SIP TCP 端口已启用（路径： PBX 设置 > SIP 设置 > 常规 > 基本 > SIP TCP 端口）。
用户名 填写中继用户名。
注： 用户名即中继号码。
密码 填写与用户名匹配的密码。
认证名称 选择要注册的第三方设备使用的认证名称。

高级设置

SIP 中继的高级设置需要熟悉 SIP 协议的专业知识。不正确的配置可能出现通话问题。一般情况下，建议直接使用默认设置。针对个别设置，你可以根据实际场景适当修改。

高级 页面包含以下设置：

语音编码设置

新建的 SIP 中继会使用 PBX 默认的语音编码。默认的语音编码设置可能与 VoIP 服务提供商使用的编码设置不一致。为保证正常通话，最大限度地提高通话质量和通话使用的带宽，你需要更改 VoIP 中继的语音编码设置，确保与 SIP 运营商的编码设置一致。

Yeastar P 系列 IPPBX 支持下列语音编码：

  • u-law
  • a-law
  • G729A
  • GSM
  • H264
  • H261
  • H263
  • H263P
  • iLBC
  • G722
  • G726
  • SPEEX
  • ADPCM
  • MPEG4
  • VP8
  • Opus
VoIP设置
设置 说明
DTMF模式 设置发送的 DTMF 模式。
  • RFC4733 (RFC2833)：通过单独 RTP 包传输的 DTMF。
  • Info：使用 SIP Info 信令携带 DTMF 信号。
  • Inband：与语音包一起通过 RTP 传输 DTMF。
  • Auto：PBX 将会自动检测是否支持 RFC4733(RFC2833)。支持时，则使用 RFC4733(RFC2833)，不支持则使用 Inband。
Qualify 勾选此项，则系统会定期发送 SIP OPTIONS 数据包，以验证中继是否在线。
语音加密（SRTP） 是否启用语音加密。
支持T.38 是否启用T.38 。启用后，将会消耗部分性能。

当通话并发较大时，不建议开启本项。
Inband Progress Inband Progress 配置项仅对使用该中继进行拨号的分机有效。
注： 如需设置全局 Inband Progress，你需要联系 Yeastar 技术支持设置自定义的配置文件。
  • 启用 Inband Progress：PBX 会发送 183 Session Progress 作为响铃指示给分机，且立即传输语音流，即彩铃。
  • 禁用 Inband Progress：PBX 会发送 180 Ringing 作为响铃指示给分机，不传输语音流。
忽略无SDP的183消息 该配置项将决定 PBX 处理无 SDP 的 183 信息的方式。
  • 启用此选项：PBX 不会转发无 SDP 的 183 信息。
  • 禁用此选项：PBX 默认会把所有无 SDP 的 183 信息转为带有 SDP 的 183 信息，并进行转发。
跟随对端格式处理180 (SDP) 消息 该配置项将决定 PBX 是否转发带有 SDP 的 180 消息，取决于对方发送的 180 消息是否带有 SDP。
  • 启用此选项：如果接收到对方发送的带有 SDP 的 180 消息，PBX 将转发 180 (SDP) 消息。
    注： 此设置在 Inband Progress 启用时不生效。
  • 禁用此选项：即使对方发送的 180 消息带有 SDP，PBX 也不会转发 180 (SDP) 消息。
启用 RTP 保活 是否发送 RTP CN (Comfort Noise) 包。此功能可确保通话中 NAT 和防火墙孔洞始终保持打开状态，以保证 RTP 媒体数据的传输。
注：
  • 仅注册中继和点对点中继支持此项。
  • 启用此项后，如果 PBX 在 1 秒内没有向中继发送 RTP 包，就会发送一个 RTP CN 包。
通话限制
设置 说明
通话限制类型 选择受限制的通话类型：
  • 呼出：呼出类型的通话并发会受限制。
  • 所有通话类型：呼出和呼入的通话并发都会受限制。
最大通话并发数 设置该中继所允许的最大通话并发数。默认为无限制。

DIDs/DDIs

DID/DDI 是中继提供商提供的号码。更多 DID 配置信息，请参见DID 号码概述。

来电号码改编

当用户呼叫 PBX 时，SIP 运营商发送的主叫 ID 可能不便于支持回拨。

在这种情况下，你可以根据 SIP 运营商的拨号要求，对外部来电号码进行改编。在通话发送给被叫之前，系统会自动修改主叫 ID。

更多信息，请参见在中继上改编来电号码。

去电显示号码

去电显示号码是被叫设备上显示的电话号码或名称。

你可以为中继设置一个通用的去电显示号码或为指定分机设置单独的去电显示号码。

注： 默认情况下，每个中继都有一个默认的去电号码。去电显示号码功能需要 SIP 运营商支持。在设置去电显示号码之前，请联系你的 SIP 运营商确认是否支持。否则该设置无法生效，且可能导致外呼失败。

如果你设置了去电显示号码，当用户使用该中继拨打外线电话时，被叫会显示该号码，而不是显示拨号人的分机号。

更多信息，请参见自定义去电显示号码。

SIP 头域

SIP 头域要求熟悉专业的 SIP 协议相关知识。不正确的配置可能出现通话问题。一般情况下，建议直接使用默认设置。针对个别设置，你可以根据实际场景适当修改。

SIP 头域 页面包含以下设置。

呼入参数
设置 说明
Caller ID获取来源 设置本条中继从哪里获取 CallerID。
  • [跟随系统]

    跟随系统的 来电显示获取来源 设置。

  • From
  • Contact
  • Remote-Party-ID
  • P-Asserted Identify
  • P-Preferred-Identity
DID 获取来源 不同设备或提供商在不同的 SIP 头域中携带 DID 号码。当中继收到一通外线来电时，PBX 需要获取到正确的 DID 号码，否则呼叫会失败。

请在分析完 SIP 运营商发送的 SIP 数据包后，再修改此设置。可选的 SIP 头域如下：

  • [跟随系统]

    跟随系统的 DID 获取来源 设置。

  • To
  • Invite
  • Diversion
  • Remote-Party-ID
    注： 选择 Remote Party ID，但线路不支持 Remote Party ID 时，系统将会从 INVITE 头域获取 DID 号码。
  • P-Asserted Identify
  • P-Called-Party-ID
  • P-Preferred-Identity
呼出参数
对于外呼通话，你可以定义在 SIP INVITE 头域中携带的参数：
设置 说明
From User Part 设置 SIP INVITE 头域中的主叫号码。

更多信息，参见 呼出参数选项说明。
From Display Name Part 设置 SIP INVITE 头域中的主叫名称。

更多信息，参见 呼出参数选项说明。
From Host Part
重要：
  • 仅 点对点中继 支持设置此参数。
  • 请根据 SIP 运营商的要求设置此参数，否则可能会导致通话异常。
设置 SIP INVITE 头域中 From 字段所使用的域名或 IP 地址。
  • 默认值：使用在创建点对点中继时所配置的 主域服务器 中的域名或 IP 地址。
  • 自定义：使用自定义的域名或 IP 地址。你可以在 自定义 下拉列表旁的字段中填写你要使用的域名或 IP 地址。
To Host Part
重要：
  • 仅 点对点中继 支持设置此参数。
  • 请根据 SIP 运营商的要求设置此参数，否则可能会导致通话异常。
设置 SIP INVITE 头域中 To 字段所使用的域名或 IP 地址。
  • 默认值：使用在创建点对点中继时所配置的 主域服务器 中的域名或 IP 地址。
  • 自定义：使用自定义的域名或 IP 地址。你可以在 自定义 下拉列表旁的字段中填写你要使用的域名或 IP 地址。
Diversion 可选： 设置 SIP INVITE 头域中的其他参数。

更多信息，参见 呼出参数选项说明。
Remote-Party-ID
P-Asserted-Identity
P-Preferred-Identity
P-Asserted-Identity URI 格式
注： 仅当 P-Asserted-Identity 设置为 无 以外的选项时支持设置此参数。
指定 P-Asserted-Identity 的格式，以验证呼叫者身份：
  • SIP URI (sip:)
  • TEL URI (tel:)
注： SIP 中继不同，支持的选项也不同。
表 1. 呼出参数选项说明
选项 说明
默认值
  • 对于呼出参数 Diversion，当来电发生转移时，系统默认取第一主叫呼入的 DID 号码作为携带的参数。
  • 对于呼出参数 Remote-Party-ID、P-Asserted-Identity 和 P-Preferred-Identity，系统按从上到下的优先级选择携带的参数：
    • 呼出路由去电显示号码
    • 中继分机去电显示号码
    • 中继去电显示号码
    • 中继用户名
    • 分机去电显示号码
    • 第一主叫号码
无 不在 SIP INVITE 数据包中携带此参数。
分机去电显示号码 分机设置的分机号。
中继去电显示号码 中继通用的去电显示号码 (中继 > 去电显示号码 > 常规)。
中继分机去电显示号码 分机在中继中绑定的去电显示号码。
呼出路由去电显示号码 使用呼出路由上配置的去电显示号码作为去电显示号码。
第一主叫号码 发起呼叫的主叫 ID (通话转接前的第一个呼叫者)
  • 如果第一主叫是外部号码，直接使用外部号码。
  • 如果第一主叫是分机，号码优先级为分机去电显示号码→ [默认值]。
中继用户名 中继设置的用户名。
自定义 设置自定义值。

其他设置
设置 说明
用户代理 如果 SIP 运营商需要用户代理进行身份验证，请输入由 SIP 运营商提供的用户代理信息。
Realm Realm 字串单独定义被保护的区域。默认无需填写，如需填写请与 SIP 运营商确认。
选择在 'Contact'(SIP) 和 'Connection'(SDP) 字段使用的IP地址
注： 仅注册中继和点对点中继支持此配置项。
选择将在 'Contact'(SIP) 和 'Connection'(SDP) 字段中使用哪种 IP 地址。
  • 使用默认配置：使用系统默认提供的 IP 地址。
  • 使用自定义 IP 地址：使用 IP 地址 中指定的自定义 IP 地址。
    注： 若设置此项，则 'Contact'(SIP) 和 'Connection'(SDP) 字段中将携带自定义 IP 地址，而不是 公网 IP 和端口 (路径：系统 > 网络) 中配置的 IP 地址。
发送 Privacy ID 是否在 SIP 头域中发送 Privacy ID。默认为禁用。
User Phone 是否在 INVITE 包的 SIP 头域中，增加 user=phone 的参数。
注： 仅在 VoIP 服务提供商有要求时再启用此选项。
发送X-OpenAPI-Call-ID

对于通过此中继呼入或呼出的通话，是否在 SIP INVITE 请求中包含 X-OpenAPI-Call-ID 字段以携带通话的 Call ID。
100rel 为中继设置 100rel。
  • Required：该中继需要使用 100rel (要求对方支持 100rel)。
  • Supported：该中继支持使用 100rel。
  • 禁用：该中继禁用 100rel。
Maxptime 选择 PBX 发出 INVITE 包时使用的 maxptime 值。
注： 如果你选择 默认值，系统会根据呼出电话所使用的语音编码发送对应的 maxptime 值。
支持 Early Media 设置 INVITE 数据包是否包含 P-Early-Media 字段。