安装本地代理网关

本文以 Ubuntu 操作系统为例，介绍如何在与 IP 话机同一子网的主机上安装本地代理网关，并在安装过程中将其连接至 Yeastar P 系列云 PBX。

注： 本文中的操作步骤适用于所有支持的操作系统。

前提条件

PBX 服务器
已在 Yeastar PBX 上添加本地代理网关实例 并获取连接凭证 (连接地址、UUID 及密钥) (路径：系统 > 本地代理网关 > 编辑 > 连接信息)。
注： 为防止 Secret Key 已被使用，建议刷新并复制新生成的密钥。

本地代理网关运行主机
项目 前提条件
网络 主机必须与 IP 话机处于同一子网，且该子网与 PBX 服务器网络互通。
操作系统 主机已安装符合要求的操作系统。
硬件 主机满足最低硬件配置要求。
端口映射 主机的 UDP 5060 端口可用。
IP 地址 主机已配置静态 IP 地址。

操作步骤

步骤一、下载并解压本地代理网关安装包到主机
  1. 在本地代理网关运行的主机上，进入命令行。
  2. 执行 sudo -i 命令切换至 root 用户。
    注： 若系统要求输入密码，请输入当前用户的密码并按回车键。
  3. 执行以下命令，将最新的本地代理网关安装包下载到目标目录。
    注： 将以下命令中的 <desired_directory> 替换为你要存放安装包的目录路径。
    架构 命令
    x86_64 wget https://help.yeastar.com/download/docs/onsite-proxy/onsiteproxy-x86_64.tar.gz -O <desired_directory>/onsiteproxy.tar.gz
    ARM64 wget https://help.yeastar.com/download/docs/onsite-proxy/onsiteproxy-aarch64.tar.gz -O <desired_directory>/onsiteproxy.tar.gz

    在本例中，执行 wget https://help.yeastar.com/download/docs/onsite-proxy/onsiteproxy-x86_64.tar.gz -O /home/user/Desktop/onsiteproxy.tar.gz 命令，将本地代理网关安装包下载到桌面。

  4. 执行 tar -xzf <your_package_path>/onsiteproxy.tar.gz -C / 命令，将安装包解压到根目录。
    注： 将 <your_package_path> 替换为安装包的实际路径。

    在本例中，执行 tar -xzf /home/user/Desktop/onsiteproxy.tar.gz -C / 命令。

步骤二、安装并配置本地代理网关以连接至 PBX
  1. 执行 onsite-proxy-install 命令开始安装。
  2. 在弹出的 Onsite Proxy Installation 窗口中，确认本地代理网关的版本和操作系统详细信息，然后选择 Yes 并按回车键。

    等待约 1 分钟，直到配置要求提示窗口弹出。

  3. 在 Important Requirements 提示窗口中，按回车键。

  4. 在 Onsite Proxy Configuration Wizard 提示窗口中，按回车键。

  5. 配置连接信息。
    注： 如有需要，可在此步骤跳过配置向导，并在安装完成后 完成连接配置。

    要跳过配置向导，可在以下任一配置窗口中选择 <Cancel>，并在 Configuration Failed 窗口中选择 No。

    操作 操作说明
    配置 PBX 连接地址
    1. 在 Configure PBX Connection Address 窗口中，执行以下操作：

      1. 粘贴从 PBX 获取的 PBX 连接地址。
      2. 选择 <Ok> 并按回车键。
    2. 在 Confirm Connection Address 窗口中，选择 <Yes> 并按回车键。
    配置 UUID
    1. 在 Configure UUID 窗口中，执行以下操作：

      1. 粘贴从 PBX 获取的 UUID。
      2. 选择 <Ok> 并按回车键。
    2. 在 Confirm UUID 窗口中，选择 <Yes> 并按回车键。
    配置密钥
    1. 在 Configure Secret Key 窗口中，执行以下操作：

      1. 粘贴从 PBX 获取的密钥。
      2. 选择 <Ok> 并按回车键。
    2. 在 Confirm Secret Key 窗口中，选择 <Yes> 并按回车键。
    配置 PBX 公网 Web 服务端口
    1. 在 Configure PBX External Web Server Port 窗口中，选择 <Ok> 并按回车键。

    2. 在 Confirm PBX External Web Server Port 窗口中，选择 <Yes> 并按回车键。
    配置 PBX 公网隧道端口
    1. 在 Configure PBX External Tunnel Port 窗口中，选择 <Ok> 并按回车键。

    2. 在 Confirm PBX External Tunnel Port 窗口中，选择 <Yes> 并按回车键。
    选择内网 IP 地址
    1. 在 Select Local IP 窗口中，执行以下操作：

      1. 选择分配给主机的静态 IP 地址。
        注： 如果 Available network interfaces 列表中未显示目标 IP 地址，需选择 manual 并按回车键，手动输入内网 IP 地址。

      2. 选择 <Ok> 并按回车键。
    2. 在 Confirm Local IP 窗口中，选择 <Yes> 并按回车键。
  6. 在 Configuration Summary 窗口中，确认配置详细信息，然后选择 <Yes> 并按回车键。

  7. 在 Verification Successful 提示窗口中，按回车键。

  8. 在 Configuration Complete 提示窗口中，按回车键。

  9. 在 Installation Complete 提示窗口中，按回车键。

执行结果

  • 本地代理网关已成功安装并连接至 PBX。
    注： 本地代理网关支持开机自启动，可在网络恢复后自动重连至 PBX。
  • 在 PBX 上，该本地代理网关实例显示 状态，及其版本号、内网 IP 地址及公网 IP 地址等信息。
    注： 若连接中断，或本地代理网关的系统资源使用率超过以下任一阈值时，PBX 将向相关联系人发送 本地代理网关异常 事件通知：
    • CPU 使用率超过 85%。
    • 内存使用率超过 85%。
    • 磁盘使用率超过 95%。