归档文件到 SFTP 服务器

Yeastar P 系列云 PBX 支持定期或随时将系统的通话录音和备份文件归档到 SFTP 服务器。本文介绍如何将 SFTP 服务器添加为归档服务器，并创建任务来归档所需的文件。

使用要求

PBX 的固件为 84.21.0.117 或更高版本。

限制条件

  • 归档服务器：10 个
  • 归档任务：200 个

前提条件

开始之前，你需要准备以下资源，并收集相关信息：
  • 准备 SFTP 服务器，并记录下此服务器的 域名/IP 地址 和 端口。
  • 准备具备读写权限的 SFTP 账号，并记录下此账号的 用户名 和 密码/私钥。
    注： 如果你想从 SFTP 服务器自动删除旧文件，确保此 SFTP 账号也具备文件删除权限。

步骤一、添加 SFTP 服务器为归档服务器

  1. 登录 PBX 管理网页，进入 系统 > 归档。
  2. 在 归档任务 页签下，点击 归档服务器。

  3. 设置 SFTP 服务器为归档服务器。
    1. 点击 添加。
    2. 在弹出的窗口中，完成以下设置。

      设置 说明
      名称 填写一个名称，帮助你识别此服务器。
      服务器类型 选择 SFTP。
      FTP服务器域名/IP地址 填写 SFTP 服务器的地址。
      端口 填写 SFTP 服务器的端口。默认端口为 22。
      用户名 填写 SFTP 账号的用户名。
      认证方式 选择认证方式，然后填写对应的凭证。
    3. 点击 保存。

      SFTP 服务器已被添加为归档服务器，并显示在列表中。

  4. 点击 关闭窗口。

步骤二、添加任务以将文件归档到 SFTP 服务器

  1. 在 归档任务 页签下，点击 添加。
  2. 在 任务配置 栏，配置归档任务的基础设置。

    设置 说明
    名称 填写一个名称，帮助你识别此任务。
    文件类型 选择 录音文件 或 备份文件。
    数据范围 指定要归档的文件的时间范围。
    注： 支持一次性归档最多 31 天内的数据。
    同步频率 设置文件归档到 SFTP 服务器的频率。
    注： 数据量过大会消耗 PBX 的 CPU，因此建议在空闲时间执行归档任务。
    • 一次性：保存归档任务后，系统立即归档文件。
    • 每天：从下拉列表中选择一个时间。系统每天在指定的时间归档文件。
    • 每周：从下拉列表中选择一周的某一天，并指定时间。系统每周在指定的时间归档文件。

    • 每月：从下拉列表中选择一个日期，并指定时间。系统每月在指定的时间归档文件。
    录音文件格式 选择录音文件的下载格式。
    注：
    • 仅当该任务用于归档录音文件时，才会出现此项。
    • 系统中的所有录音文件将以所选格式进行下载归档。
  3. 在 存储配置 栏，选择归档服务器并完成相关配置。
    设置 说明
    归档服务器 选择已添加的 SFTP 服务器。
    选择文件夹/路径 可选。设置要存储归档文件的文件夹路径。例如，pbx/backup/。
    注： 如果此项留空，文件默认存储到根目录下。
    跳过已归档文件 可选。设置是否跳过已归档的文件。
    注： 仅当你设置归档录音文件时，才会出现此项。
    • 若启用，系统不会再次归档已归档的文件。
    • 若禁用，系统会再次归档已归档的文件。重复归档后，文件的存储位置会更新，但已归档到第三方服务器的文件不会被删除。
    归档后删除本地文件 可选。设置归档后是否删除本地文件。
    注： 仅当你设置归档录音文件时，才会出现此项。
    • 若启用，归档后删除本地文件。PBX 管理端和 Linkus 客户端仍可播放和下载，但第三方平台及 Dynamics 365 将无法继续播放或下载。
    • 若禁用，归档后保留本地文件。
  4. 可选： 设置归档文件的保留规则。
    注：
    • 仅当设置定期归档任务时，才会显示此项。
    • 确保 SFTP 账号 具备删除归档服务器资源的权限。

    设置 说明
    保留方式

    设置归档文件的保留方式。

    • 按数量保留：设置归档服务器存储路径下最多保留的文件/文件夹数量。

      如果选择此项，在 保留上限 (个) 栏填写数量。

      当文件/文件夹数量超过上限时，系统会自动删除最早的文件/文件夹。

    • 按天保留：设置归档服务器存储路径下数据的最长保留天数。

      如果选择此项，在 保留上限 (天) 栏填写天数。

      系统会自动删除超过设定天数的文件/文件夹。

      注：
      • 保留时间从文件归档到归档服务器时开始计算，而非从文件在 PBX 上生成的时间起算。
      • 保留时间按精确 24 小时周期计算，而非按日历日计算。
    保留上限 根据选择的保留方式，设置最大文件/文件夹数量或最大保留天数。
    保留单位 选择保留方式的计算单位。
    • 文件夹：按归档服务器上创建的归档文件夹进行保留计算。
    • 文件：按归档服务器上的单个归档文件进行保留计算。
  5. 点击 保存。

执行结果

指定的文件将立即/在预约的时间被归档到 SFTP 服务器的指定文件夹中。
注： 为避免影响系统性能，系统一次只执行一个任务。如果有多个任务，这些任务会排队执行。

你可以通过以下方式查看归档结果。

在 PBX 上查看归档结果
登录 PBX 管理网页，进入 系统 > 归档 > 同步记录。如果此任务的 结果 栏显示 成功，表明指定文件已成功归档到 SFTP 服务器。

注： 任务执行失败会触发 文件归档失败 事件；你可以点击 重试任务。

在 SFTP 服务器上查看归档结果
进入 SFTP 服务器的指定文件夹。如果指定文件出现在列表中，表明归档成功。