Yeastar P 系列云 PBX 84.21.0.117

本文介绍固件版本 84.21.0.117 从公测 (Beta) 到正式发布 (GA) 的发布历史。

如需体验本次更新内容，请通过 PBX 网页下载固件并升级 PBX。

84.21.0.117 (GA)

发布日期：2026年1月29日

发布类型：正式版

基线版本：84.21.0.117-beta2

此固件版本已由 公测版 (Beta) 转为 正式版 (GA)，可在生产环境中使用。

在升级到正式版的同时，引入了以下功能优化：

新增配置项启用通话加密隧道 (路径：安全 > 安全设置 > 防御选项 > 通话加密隧道)。该配置可控制是否使用 Linkus 手机端通信加密隧道 功能 (于 84.21.0.117-beta1 中推出)。若启用，则 Linkus 手机端的所有 SIP 信令与 RTP 媒体流都将通过加密隧道传输至 PBX。
注：仅当你的服务提供商在 PBX 管理平台 (Yeastar 统一管理平台) 完成以下配置后，此配置项才会显示：
- 开放所需的隧道端口
- 启用 通话加密隧道 功能
更多信息，请参见启用 Linkus 手机端通话加密隧道。

84.21.0.117 (Beta2)

发布日期：2026年1月22日

发布类型：公测版

基线版本：84.21.0.117-beta1

Bug 修复

兼容性问题

修复 PBX 与 Linkus 手机端之间的兼容问题：当 Linkus 手机端与固件版本为 84.21.0.117-beta1 的 PBX 配套使用时，若用户使用非 .com 结尾的域名登录，则 Linkus 所有呼出失败。

注：为确保更好的兼容，用户需将其 Linkus 手机端升级到以下版本：

Linkus iOS 端：5.22.19 或更高版本
Linkus 安卓端：5.22.12 或更高版本

84.21.0.117 (Beta1)

发布日期：2026年1月13日

发布类型：公测版

基线版本：84.21.0.66

新功能

主题模式

Yeastar P 系列云 PBX 支持主题模式切换。

默认情况下，PBX 网页自动跟随网页浏览器的主题设置。你也可以根据偏好手动将系统的主题切换为 亮色模式 或 暗色模式。

更多信息，请参见修改主题模式。

注：分机用户也可在 Linkus UC 客户端上配置主题模式。要使用此功能，分机用户需要将 Linkus 升级到以下版本：

Linkus 桌面端：1.19.3 或更高版本
Linkus 手机端：5.14.3 (iOS) / 5.14.4 (安卓) 或更高版本

更多信息，请参见以下文章：

Linkus 手机端通信加密隧道

支持在 Yeastar P 系列云 PBX 与 Linkus 手机端之间建立加密隧道，用于传输所有 SIP 信令与 RTP 媒体流。通过专用隧道端口封装 VoIP 流量，可提升通信安全性，有效防止运营商 SIP 封锁，从而确保分机在受限网络环境中能够正常注册并保持通话稳定。

注：要实现此功能，分机用户需将其 Linkus 手机端升级至以下版本：

Linkus iOS 端：5.22.15 或更高版本
Linkus 安卓端：5.22.10 或更高版本

高级通话记录 & 通话报告

重构通话记录 (CDR) 和通话报告功能，以提供更集中的通话记录，更丰富的通话详情，以及更为灵活的通话报告管理。

以下具体功能变更仅针对此版本之后生成的 CDR 和通话报告。

注：此版本之前与之后生成的 CDR 和通话报告需从不同的路径进行访问。

历史 CDR 数据及其对应的通话报告数据，将根据通话记录自动清理规则逐步删除。在系统清除了所有的历史数据后，对应的旧入口将不可见。

新增独立的 CDR 详情 页面 (路径：通话记录和录音 > 通话记录 > 通话记录(高级) > 操作 > )。
该页面为每通完整通话提供全面集中的概览，包含基本通话信息、录音、完整通话阶段、AI 转录/总结、通话备注及直观的时间分析。
更多信息，请参见通话记录详情关键指标。
新增时间线功能。启用后，CDR 详情页面将按时间顺序展示通话从开始到结束的所有事件，从而清晰呈现通话活动状态。

更多信息，请参见启用通话记录时间线。
优化 CDR 筛选功能：你可以将常用筛选条件保存为自定义视图，以便快速访问相关 CDR 记录。
注：最多支持创建 10 个自定义视图。
更多信息，请参见查看通话记录。
优化 CDR 导出功能：
- 支持自定义下载设置，从 CDR 列表中下载 CDR 时将应用这些设置。
  更多信息，请参见自定义通话记录下载设置。
- 优化预约通话记录设置，提供模块化的筛选配置与预约信息配置 (路径：通话记录和录音 > 通话记录 > 预约通话记录 > 添加)。
  注：对于该版本前后生成的 CDR，其预约任务需从不同的路径访问。历史数据的任务设置保持不变，可通过添加(旧) 按钮创建任务。
- 支持将 CDR 以 HTML 格式导出，网页直接下载 CDR 或定时发送 CDR 时均可选择该格式。

优化 CDR 与通话报告管理的功能逻辑，主要逻辑变更对比如下表所示：


项目	此版本前	此版本后
CDR
记录结构	多阶段通话 (如队列通话、转接通话) 被拆分为多个独立记录。	单条 CDR 完整记录一次通话的所有阶段，并包含基于时间线的详细信息 (包括基本通话信息、录音、 AI 转录/总结以及通话备注)。
自动清理	计数基准：CDR 按通话阶段计数。清理规则：当 CDR 数量达到存储上限时，删除最早的 CDR。	计数基准：CDR 按完整通话计数。清理规则：若 PBX 升级至该版本后存在旧 CDR 数据，系统将逐步删除这些历史数据。当新 CDR 与旧 CDR 的总数达到存储上限时，旧 CDR 将以 1:5 的比例进行删除 (例如，生成 1 条新 CDR 时，系统将自动删除 5 条旧 CDR)，直到所有的旧 CDR 数据被清除。更多信息，请参见通话记录自动清理。
事件通知	/	新增以下事件通知：旧版通话记录将逐步清理 - 系统升级至该版本后，若存在旧 CDR 数据，则会触发该事件通知，提示存在旧 CDR 数据，且系统将逐步清除这些数据。旧版通话数据已全部清理完成 - 当所有旧 CDR 数据均已清除时触发该事件通知。
通话报告
存储机制	通话报告数据与 CDR 一同存储。	通话报告数据与 CDR 记录各自独立存储。
自动清理	通话报告数据跟随 CDR 一并删除。	通话报告数据将根据其独立的自动清理设置进行删除 (路径：系统 > 存储 > 自动清理 > 通话报告自动清理)。更多信息，请参见通话报告自动清理。

优化重置设置：重置选项重置通话记录和录音名称更改为重置通话记录、通话报告和录音，以适配重构后的 CDR 和通话报告功能。

优化以下功能的 API 接口，以适配重构后的 CDR 和通话报告功能。


功能	说明
通话记录 (CDR)	CDR 筛选：`cdr/list` 接口新增请求参数 `from`，可用于筛选新旧版本的 CDR 数据。新版 CDR 标识：`cdr/list` 和 `cdr/search` 接口新增响应参数 `new_id`，用于标识新版本 CDR 数据。新版 CDR 模糊搜索：`cdr/getoption` 和 `cdr/updateoption` 接口新增参数 `enb_new_cdr_fuzzy_search`，用于查询或配置此版本后生成的 CDR 数据的模糊号码查询设置。更多信息，请参见开发者手册 - 通话记录 (CDR)。
通话报告	引入通话报告 API v2.0 接口，用于访问此版本后生成的通话报告数据。其 API 接口端点 (URL 路径) 与 v1.0 完全相同，仅请求中的版本标识符更新 (从 `v1.0` 更新为 `v2.0`)。注：原有的 v1.0 API 接口仍可用于访问本版本之前生成的历史通话报告数据。更多信息，请参见开发者手册 - 通话报告。

全渠道消息管理 (Omnichannel Messaging)

支持与 SMS 运营商 Alhambra IT 和 Aspsms 对接。企业可以在 Yeastar P 系列云 PBX 上为 Alhambra IT 和 Aspsms 创建 SMS 短信渠道。

更多信息，请参见设置消息渠道。

功能优化与 Bug 修复

中继

注册中继和账号中继新增配置项忽略 100 Trying 响应 (路径：分机和中继 > 中继 > 注册中继/账号中继 > 高级 > VoIP设置)。

启用后，PBX 将在 SIP 注册或呼叫建立过程中忽略收到的 100 Trying 响应。

自动配置

支持通过 XML 将 PBX 联系人同步至自动配置的方位 (Fanvil) IP 话机的远程电话簿中，允许用户直接在话机上查询和呼叫 PBX 联系人。
优化 DOD 管理的 BLF 功能：除了可监控特定 DOD 是否已设为指定分机的默认 DOD 外，用户可在话机上通过按 BLF 键，一键将特定 DOD 设置为指定分机的默认 DOD。
修复自动配置问题：当分配给话机的分机名称中包含符号 & 时，自动配置失败。

呼入路由

修复呼入路由问题：基于自定义时间段的呼入路由的默认目的地设置为通话流程，在通过特征码切换时间条件后，呼入该路由的来电将失败。

特征码

修复特征码问题：当分机用户拨打特征码将来电前转至外部号码时，主叫方听到回铃音而非忙音。

响铃组/队列

提升响铃组与队列的数量上限：对于支持创建的分机数量少于 50 的 PBX 系统，可创建的响铃组与队列的最大数量由 16 增加至 32 个。

录音

新增配置项通话转接后继续录音 (路径：呼叫功能 > 录音 > 要录音的分机/要录音的队列 > 操作)，可用于设置当来电从特定队列或分机通过盲转或咨询转的方式转接至其他目的地时是否继续录音。
更多信息，请参见设置通话录音。
优化录音文件格式配置：录音文件格式配置项始终可见 (路径：呼叫功能 > 录音 > 录音设置)，不受双声道录音功能启用状态的影响。

常规设置

优化号码范围设置：停泊号码的数量上限由 100 提升至 10,000 (路径：PBX 设置 > 常规设置 > 号码范围设定)。

归档

优化归档任务的保留配置 (路径：系统 > 归档 > 归档任务 > 保留配置)，可设置归档服务器上文件或文件夹的保留策略。

注：

仅当设置定期归档任务时，才会显示此项。
确保用于连接归档服务器的账号具备删除服务器资源的权限。


保留方式	说明
按数量保留 (原文件覆盖设置)	配置保留单位 (文件或文件夹) 以及最大数量。达到上限时，系统将自动从归档服务器中删除最早的文件/文件夹。
按天保留	配置保留单位 (文件或文件夹) 以及最长天数。系统将自动从归档服务器中删除归档时间超过所设最大保留天数的文件/文件夹。

优化录音归档任务设置：录音文件格式设置项始终可见，不受双声道录音功能启用状态的影响。
修复归档问题：将备份文件归档至 FTP 服务器失败。

系统日志

优化以下系统日志设置：

日志级别新增选项 CDR Log (路径：维护 > 系统日志 > 日志级别)，用于控制是否在系统日志中记录通话记录相关信息。
新增日志类别 analytics.log。若勾选了 Debug 选项，则与 CDR 数据处理相关的系统事件将被记录到专门的 analytics.log 文件中。

Google Workspace 集成

优化用户同步设置：新增字段匹配设置，支持将对应的 Google 用户属性映射到特定的 PBX 用户字段，以实现精确的用户数据同步。

Microsoft Entra ID (Azure AD) 集成

修复联系人同步问题：PBX 未能一次性同步所有指定的 Microsoft 联系人。

自定义 CRM 模板集成

修复集成问题：CRM 集成模板设置了 Bearer Token 认证方式，PBX 在首次集成认证时错误地调用了刷新令牌端点，而非令牌获取端点，导致认证失败。

API

优化以下功能的 API 接口。


功能	说明
中继	`trunk/get`、`trunk/query`、`trunk/create` 和 `trunk/update` 接口新增参数 `ignore_100_response`，可用于查询或配置 PBX 是否忽略注册中继或账号中继接收到的 `100 Trying` 响应。
自动录音设置	`autorecord/get` 和 `autorecord/update` 接口新增参数 `enb_continue_record_on_transfer`，可用于查询或配置当来电从特定队列或分机通过盲转或咨询转的方式转接至其他目的地后是否继续录音。
通话记录 (CDR)	`cdr/list` 和 `cdr/search` 接口新增参数 `pincode`，可用于基于指定 PIN 码筛选通话记录，或查询通过受限的呼出路由呼出时使用的 PIN 码。 `cdr/search` 接口新增请求参数 `page` 和 `page_size`，以支持分页查询。

修复 API 事件问题：分机对外线来电执行盲转时，未生成 30013 (呼叫转移报告) 的 API 事件。

Linkus 网页端

支持设置 Linkus 网页端的主题模式。
默认情况下，Linkus 网页端自动跟随网页浏览器的主题设置。分机用户也可以根据自己的偏好，手动将系统的主题切换为 亮色模式 或 暗色模式。
优化通话体验：通话过程中，通话窗口会显示其他通话方的号码，且支持通过以下任一方式便捷复制号码：
- 一键复制：点击号码旁的按钮即可直接复制。
- 选中并复制：选中号码，并使用键盘快捷键复制。
修复视频会议问题：会议中所有视频画面均为镜像。