高级中继设置

高级中继设置需要熟悉 SIP 协议的专业知识。错误的配置可能会导致通话出现问题。一般情况下，建议保留默认设置。针对个别设置字段，你可以根据实际场景进行更改。本文介绍了 SIP 中继的所有高级设置，以供参考。

高级设置

中继的 高级 页面包含以下设置。

语音编码设置

为提升通话质量，优化通话所用带宽，可将首选编解码列表配置为与 SIP 运商营的设置一致。

编解码类型 支持的编解码
语音编解码 u-law, a-law, G.729A, G.722, G.726, iLBC, Opus, GSM, SPEEX, ADPCM
视频编解码 H.264, H.263, H.263P, MPEG4, VP8
VoIP 设置
设置 说明
DTMF模式 设置发送的 DTMF 模式。
  • RFC4733 (RFC2833)：DTMF 信号通过与语音包不同的专用 RTP 数据包在 RTP 流中进行传输。
  • Info：使用 SIP Info 信令携带 DTMF 信号。
  • Inband：与语音包一起通过 RTP 传输 DTMF 信号。
  • Auto：PBX 将会自动检测设备是否支持 RFC4733 (RFC2833)。若支持，则使用 RFC4733 发送 DTMF，不支持则使用 Inband 模式。
鉴权错误SIP码 设置 SIP 运营商返回的表示鉴权错误的 SIP 错误码。
注：
  • 此项仅适用于注册中继。
  • 最多支持填写 10 个错误码；使用半角分号 ; 分隔多个错误码。
鉴权注册尝试次数 设置 PBX 在收到 SIP 运营商返回的鉴权错误 SIP 码后重新发送注册请求的尝试次数。
注：
  • 此项仅适用于注册中继。
  • 此处定义的注册尝试次数包含首次发送的，不携带认证信息的注册请求。
全局注册重试间隔时间（秒） 设置 PBX 在收到 SIP 运营商返回的任意 SIP 错误码 (即非 200 的状态码) 后重新发送注册请求的间隔时间 (单位：秒)。
注： 此项仅适用于注册中继。
Qualify 勾选后，系统会定期发送 SIP OPTIONS 包，以验证中继是否在线。
语音加密 (SRTP) 设置是否启用语音加密。
支持 T.38 设置是否启用此中继的 T.38支持。
注： 启用后，将会消耗部分性能。当通话并发较大时，建议关闭本项。
Inband Progress 设置是否启用 Inband Progress。此设置应用于通过此中继拨打电话的分机。
  • 勾选此项：当被要求指示振铃时，PBX 会向分机发送 183 Session Progress 信令消息，并立即开始向其传输语音流 (即彩铃)。
  • 不勾选此项：当被要求提示振铃时，PBX 会向分机发送 180 Ringing 信令消息，但不会传输语音流。
忽略无 SDP 的 183 消息 该配置项决定 PBX 如何处理不含 SDP 的 183 消息。
  • 勾选此项：PBX 不会转发无 SDP 的 183 信息。
  • 不勾选此项：PBX 会将所有无 SDP 的 183 消息处理为带有 SDP 的 183 消息，并进行转发。
跟随对端格式处理180（SDP）消息 该配置项决定 PBX 是否转发带有 SDP 的 180 消息，取决于对方发送的 180 消息是否带有 SDP。
  • 勾选此项：如果对方发送的 180 消息中包含 SDP，PBX 将转发 180 (SDP) 消息。
    注： 当启用 Inband Progress 时，此设置不生效。
  • 不勾选此项：即使对方发来的 180 消息中有 SDP，PBX 也不会转发 180 (SDP) 消息。
专线中继 如果你的 SIP 中继提供商需要使用专用的内网 IP 地址进行连接，请启用此设置，并联系你的服务提供商进行相关网络设置。
启用 SIP 鉴权缓存 若启用，PBX 会缓存已成功的 SIP 鉴权信息，并在同一会话或注册周期内的后续请求 (INVITE 和 BYE) 中复用。
注： 此项仅适用于注册中继。
通话限制
设置 说明
通话限制类型 设置受最大通话并发数限制的通话类型。
  • 呼出：仅限制呼出类型的通话。
  • 所有通话类型：呼出和呼入的通话都会受到限制。
最大通话并发数 设置该中继所允许的最大通话并发数。默认为 无限制。
STIR/SHAKEN

Yeastar 统一管理平台允许你为共享中继配置 STIR/SHAKEN，可验证来电号码的真实性，防范来电号码伪造。

更多信息，请参见 STIR/SHAKEN 概述。

设置 说明
STIR/SHAKEN模式 指定 STIR/SHAKEN 操作模式。
  • 去电签名：若选中此项， PBX 将对此中继路由的所有外线去电 (紧急呼叫和匿名呼叫除外) 进行数字签名。
  • 来电验证：若选中此项，PBX 将验证此中继路由的所有外线来电，并根据在 STIR/SHAKEN 模块中为所有共享中继全局配置的拒接规则拒接来电。
  • 去电签名和来电验证：若选中此项，PBX 会对此中继路由的外线去电进行签名，并对此中继路由的外线来电进行验证。
上游验证结果处理 若启用，PBX 将完全信任并直接使用 SIP 运营商提供的来电验证结果，而不再自行验证来电。
PAI头域中的验证状态参数

输入 SIP 运营商在 P-Asserted-Identity (PAI) 头域中、用于携带来电验签结果的参数名称。
SHAKEN信任等级头域字段 输入 SIP 运营商定义的、用于传递 SHAKEN 信任等级的参数名称。
启用来电过滤

启用后，PBX 将使用 SIP 运营商提供的来电验证结果，并根据在此中继中配置的拒接规则拒接来电。
验证状态呼叫拦截 选择一个或多个会触发来电拒接的验证状态。

SIP 头域设置

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

呼入参数
设置 说明
来电显示获取来源 设置本条中继从哪里获取 Caller ID。
  • 跟随系统
    注： 如果选择该选项，中继将遵循云 PBX 上 来电显示获取来源 的全局设置 (路径： PBX设置 > SIP设置 > 高级 > 来电显示/ DID 获取来源)。
  • From
  • Contact
  • Remote-Party-ID
  • P-Asserted-Identify
  • P-Preferred-Identify
DID 获取来源 设置本条中继从哪里获取 DID。
  • 跟随系统
    注： 如果选择该选项，中继将遵循云 PBX 上 DID获取来源 的全局设置 (路径：PBX 设置 > SIP 设置 > 高级 > 来电显示/ DID 获取来源)。
  • To
  • Invite
  • Diversion
  • Remote-Party-ID
    注： 如果选择该选项 ，但 SIP 运营商不支持 Remote-Party-ID，则中继将从 Invite 头域中获取 DID 号码。
  • P-Asserted-Identify
  • P-Preferred-Identify
  • P-Called-Party-ID
呼出参数
对于呼出通话，你可以定义以下 SIP INVITE 头域中携带的参数：
设置 说明
From User Part 定义用于外呼的主叫号码 (即 SIP From 头域的 User Part 部分)。

更多信息，请参阅 呼出参数选项。
From Display Name Part 定义用于外呼的主叫名称 (即 SIP From 头域中的 Display Name 部分)。
  • 默认：显示实际呼出时的去电显示号码对应名称。
  • 分机去电显示名称：分机去电显示名称，由分机中设置的 “姓氏” 和 “名字” 组合而成。
  • 中继去电显示名称： 中继配置的默认去电显示名称。
  • 中继分机去电显示名称：分机在中继中绑定的去电显示名称。
  • 第一主叫名称：当有通话转移时，取第一主叫的名称。
  • 自定义：自定义值。
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 Format
注： 仅当 P-Asserted-Identify 设置为 无 以外的值时，此参数才可用。
指定 P-Asserted-Identity 的格式，以验证呼叫者身份：
  • SIP URI (sip:)
  • TEL URI (tel:)
呼出参数选项的详细说明请参见下表。
注： 对于不同类型的 SIP 中继，支持的配置项有所不同。

呼出参数选项

选项 说明
默认值
  • 对于 Diversion 呼出参数，当来电发生转移时，系统使用第一注脚呼入的 DID 号码 作为携带的参数值。
  • 对于 Remote-Party-ID、P-Asserted-Identity 和 P-Preferred-Identity 呼出参数，系统按照从上到下的优先级选择携带的参数：
    • 呼出路由去电显示号码
    • 中继分机去电显示号码
    • 中继去电显示号码
    • 中继用户名
    • 分机去电显示号码
    • 第一主叫号码
无 不在 SIP INVITE 包中携带此参数。
分机去电显示号码 分机上配置的去电显示号码。
中继去电显示号码 中继的全局去电显示号码 (在 中继 > 去电显示号码 > 通用 中配置)。
中继分机去电显示号码 分机在中继中关联的去电显示号码。

  • 如果分机 选择关联的去电显示号码 (在 分机和中继 > 分机 > 用户 > 去电显示号码 (DOD) > 去电显示号码 中配置）进行呼出，则将使用所选的 DOD 号码。

  • 如果分机使用默认 DOD 进行呼出，则将使用与分机关联的 DOD 号码。当关联多个 DOD 号码时，将使用分机 DOD 列表中优先级最高的 DOD 号码（路径：分机和中继 > 分机 > 用户 > 去电显示号码 (DOD) > 去电显示号码）。
呼出路由去电显示号码 在呼出路由上配置的去电显示号码。
第一主叫号码 第一个发起呼叫的主叫号码。
  • 如果第一主叫是外部号码，则取外部号码。
  • 如果第一主叫是分机，则取值优先级顺序为 分机去电显示号码 > 默认。
中继用户名 中继上配置的用户名。
自定义 设置自定义值。
其他设置
设置 说明
用户代理 如果 SIP 运营商要求使用用户代理进行身份验证，请输入由 SIP 运营商提供的用户代理信息。
Realm Realm 用于指定系统在连接 SIP 中继时，在特定域内进行认证需要使用哪个用户名和密码。
注： 如需填写，请与 SIP 运营商确认。
100rel 为该中继配置 100rel。
  • Required：此中继需要 100rel (要求对方支持 100rel)。
  • Supported：此中继支持 100rel。
  • 禁用：此中继禁用 100rel。
Maxptime 选择 PBX 发送 INVITE 包时使用的 maxptime 值。
注： 如果你选择 默认值，PBX 会根据外呼所使用的语音编码发送相应的 maxptime 值。
发送 Privacy ID 是否在 SIP 头域中发送 Privacy ID。默认为禁用。
User Phone

是否在 SIP INVITE 包的头域字段中添加 user=phone 参数。

注： 仅当 SIP 运营商有要求时才启用此选项。
发送 X-OpenAPI-Call-ID 设置是否在 SIP INVITE 包中添加 X-OpenAPI-Call-ID 字段，以携带经由该中继的呼入或呼出通话的 ID。
支持 P-Early-Media 设置 INVITE 包中是否包含 P-Early-Media 字段。
发送带有 P-Early-Media 头域的 183 消息 设置在收到外线来电时，是否在 PBX 回复的 183 消息中携带值为 sendrecv 的 P-Early-Media 头域字段。