添加自定义域名

星纵统一管理平台允许你自定义 P 系列云 PBX 的域名,以建立自己的云 PBX 品牌。本文介绍如何添加自定义域名。

使用要求和使用限制

使用要求
  • 订阅 自定义域名 服务或 白标服务
使用限制
  • 每个区域只允许配置一个自定义域名。
  • 每个区域的自定义域名只能配置一次,域名部署成功后无法更改。

操作步骤

要添加自定义域名,你需要在星纵统一管理平台上部署两个泛域名,包括一个 PBX 泛域名和一个 SBC Proxy 服务器域名。

注:
  • PBX 泛域名即要添加的自定义域名,用作云 PBX URL 的后缀。此泛域名需要解析到后端 SBC 服务器的 IP 地址。
  • SBC Proxy 服务器的域名与 PBX 泛域名相关联,此域名用于组成 PBX 特定功能使用的服务器地址,包括注册中继、点对点中继、LDAP、SSH、AMI 和数据库授权。
  1. 获取服务器 IP 地址和域名

    在星纵统一管理平台上,查询要添加自定义域名的区域中的服务器 IP,并通过自定义的域名获取与之相关联的 SBC Proxy 服务器域名。在后续购买域名和证书的时候需要用到这些信息。

  2. 购买域名和证书

    购买域名以及对应的泛域名 SSL 证书。

  3. 部署域名证书

    在星纵统一管理平台上,上传 SSL 证书和私钥以部署域名证书。

获取服务器 IP 地址和域名

  1. 登录星纵统一管理平台,进入 云 PBX > 自定义域名
  2. 区域 下拉列表,选择要添加自定义域名的区域。

    SBC IP 地址SBC Proxy IP 地址 栏会显示此区域下服务器的 IP 地址。

  3. 点击 复制 SBC 服务器和 SBC Proxy 服务器的 IP 地址。

  4. 获取与自定义域名相关联的 SBC Proxy 服务器域名。
    1. PBX 泛域名 字段,输入自定义的域名。在本例中,输入 *.customdomain.com

      SBC Proxy 域名 对应显示 SBC Proxy 服务器的域名。

    2. 记录 SBC Proxy 服务器的域名。

购买域名和证书

  1. 在域名注册机构购买并配置域名。
    1. 购买两个泛域名。

      在本例中,购买泛域名 *.customdomain.com*.proxy1.customdomain.com

    2. 设置域名转发,将两个泛域名分别解析到对应服务器的 IP 地址。
      在本例中,设置如下:
      • 将 PBX 泛域名 *.customdomain.com 解析到 SBC IP 地址 123.123.123.123
      • 将 SBC Proxy 域名 *.proxy1.customdomain.com 解析到 SBC Proxy IP 地址 124.124.124.124
  2. 在证书颁发机构 (CA) 购买并下载 SSL 证书。
    1. 为域名购买泛域名 SSL 证书。

      在本例中,为 *.customdomain.com*.proxy1.customdomain.com 购买泛域名 SSL 证书。

    2. 下载泛域名 SSL 证书和私钥。
      注:
      • Yeastar P 系列云 PBX 使用 NGINX 作为 Web 服务器,所以下载的证书需要兼容 NGINX 服务器。
      • 支持 RSA 私钥与 EC 私钥。

部署域名证书

  1. 登录星纵统一管理平台,进入 云 PBX > 自定义域名
  2. 自定义域名 栏,输入域名信息。

    1. 区域 下拉列表中,选择要添加自定义域名的区域。
    2. PBX 泛域名 栏,输入自定义域名。
  3. 域名证书 栏,上传泛域名证书。
    1. 操作 栏中,点击
    2. 在弹出的窗口中,执行以下操作:

      1. 填写证书信息。
        • 证书名称:设置一个名称,帮助你识别此证书。
        • 证书文件:点击 浏览 选择格式为 .cer.crt.pem 的证书文件。
          重要: 上传的证书文件必须包含完整证书路径,即包含根证书中间证书服务器域名证书
          注: 如果从证书颁发机构 (CA) 收到的证书文件是分开的,你需要先手动将证书内容合并,并将此完整的证书路径粘贴或上传到 证书文件 栏中。合并内容时需遵循从上到下为 服务器域名证书 > 中间证书 (如果有,则需要粘贴) > 根证书 的顺序,且证书内容块之间不应有空行。

          下图为某个合并后的完整证书示例。

        • 证书私钥:点击 浏览 选择格式为 .key 的私钥文件。
          注: 支持的内容格式如下:
          • -----BEGIN RSA PRIVATE KEY----- 开头,以 -----END RSA PRIVATE KEY----- 结尾。
          • -----BEGIN PRIVATE KEY----- 开头,以 -----END PRIVATE KEY----- 结尾。
          • -----BEGIN EC PRIVATE KEY----- 开头,以 -----END EC PRIVATE KEY----- 结尾。
      2. 点击 确定

        上传的证书显示在列表中,状态显示为 未部署

  4. 点击 保存

执行结果

  • 证书状态 显示为 已部署,表示自定义域名已经添加成功。

  • 自定义域名 栏中,区域旁边出现一个 '自定义' 标签,表示此区域中有添加自定义域名;PBX 泛域名 中的域名变得不可编辑。

后续操作

现在你可以在此区域中使用自定义域名创建云 PBX。

云 PBX > PBX 中创建云 PBX 时,可在 URL 后缀的下拉列表中查看并选择自定义域名。

注: 此区域中的经销商在创建云 PBX 时只能查看到此自定义域名。