产品文档
NetScaler Console 服务

配置内置代理以管理实例

August 22, 2025
投稿者: 
C

内置代理在运行版本 12.1.48.13 及更高版本的 NetScaler MPX、VPX、Gateway 实例以及运行版本 13.0 61.x 及更高版本和 12.1 58.x 及更高版本的 NetScaler SDX 实例上可用。您可以在 NetScaler 实例上启动此代理，而无需在数据中心或公共云中安装专用代理。内置代理可实现实例与 NetScaler Console 之间的通信。

注意：

内置代理仅在以下 NetScaler 实例类型上可用：

  • NetScaler MPX
  • NetScaler VPX
  • NetScaler SDX
  • NetScaler Gateway

内置代理非常适合较小的 NetScaler 独立部署或 HA 对部署。如果您有多个 NetScaler 实例，请使用专用代理进行部署。此代理可确保您拥有比内置代理更好的数据聚合功能。有关详细信息，请参阅在本地安装代理。

NetScaler Console 支持使用内置代理管理和监视 NetScaler 实例。但是，内置代理不支持以下功能：

  • 应用程序仪表板
  • Web Insight
  • SSL Insight
  • HDX Insight
  • Gateway Insight
  • 安全 Insight
  • 高级分析
  • 池化/弹性许可

您可以从内置代理过渡到外部代理。有关详细信息，请参阅从内置代理过渡到外部代理。

先决条件

在 NetScaler 实例上配置内置代理之前，请确保满足以下条件：

  • NetScaler (MPX、VPX 或 Gateway) 实例运行版本 12.1.48.13 或更高版本。SDX 实例运行版本 13.0.61.x 或更高版本。

  • 已在 NetScaler 实例上添加 DNS 名称服务器。

    有关详细信息，请参阅添加名称服务器。

  • 您拥有 Citrix Cloud 帐户。有关详细信息，请参阅注册 Citrix Cloud。

注意：

有关端口和其他系统要求的所有信息，请参阅系统要求。

配置内置代理

执行以下任务以配置 NetScaler 内置代理：

  1. 按照入门中的说明选择“内置代理”选项。

  2. 复制服务 URL 和激活码。

    代理使用服务 URL 定位服务，并使用激活码向服务注册。如果您是 MPX 或 Gateway 客户，请跳过步骤 7。

  3. 使用 SSH 客户端启动内置代理。Gateway 用户必须跳过此步骤。

    1. 登录到您的 NetScaler 实例。有关详细信息，请参阅访问 NetScaler。

    2. 导航到 /var/mastools/scripts 目录并键入以下命令：

      在 SDX 实例上

      使用 NetScaler 配置文件注册 不使用 NetScaler 配置文件注册
        先决条件 注册前，请创建 NetScaler 配置文件。有关详细信息，请参阅如何创建 NetScaler 配置文件。
        运行此命令 ./mastools_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile ./mastools_init.sh <user_name> <service-url> <activation-code> -sdx
        用户凭据 在 <device_profile_name> 中输入 nsroot。或者，您可以使用具有与 nsroot 相同访问权限的用户名。 在 <user_name> 中输入 nsroot。或者，您可以使用具有与 nsroot 相同访问权限的用户名。

      注意：

      NetScaler Console 会发现该 SDX 上运行的所有 VPX 实例，您无需单独注册 VPX 实例。

      在未在 SDX 设备上运行的 VPX 实例以及 MPX 和 Gateway 实例上：

      如果 NetScaler 映像版本低于 13.0 61.x 或 12.1 57.x，您必须通过键入命令 cat /var/mastools/version.txt 来检查 mastools 版本。如果输出为 0.0-0.0，则表示是首次运行。

      根据软件版本键入以下命令之一。

      注意：

      在使用 NetScaler 配置文件注册之前，您必须创建该配置文件。有关详细信息，请参阅如何创建 NetScaler 配置文件。

      NetScaler 映像版本 mastools_version 是否为 0.0-0.0？ 使用配置文件注册的命令 不使用配置文件注册的命令
      低于 13.0 61.xx 和 12.1 57.xx 是 ./mastools_init.sh <device_profile_name> <service_url> "MAS;<activation_code>" -profile ./mastools_init.sh <user_name> <pwd> <service_url> "MAS;<activation_code>"
      低于 13.0 61.xx 和 12.1 57.xx 否 ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>
      高于 13.0 61.x 和 12.1 57.xx 不适用 ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>

    注意：

    • 在 <device_profile_name> 或 <user_name> 中，输入 nsroot。或者，您可以使用具有与 nsroot 相同访问权限的用户名。
    • 在 HA 对中，在主节点上完成注册。如果您在辅助节点上运行注册命令，则会出现以下消息：请在主节点上运行注册命令。

  4. 返回 NetScaler Console 页面，然后单击注册实例。

  5. 在添加实例中，查看您启动内置代理的实例。确保实例处于正常运行状态，然后单击下一步。

  6. 单击完成。

成功配置内置代理后，您可以访问 NetScaler Console 功能，例如：

  • 虚拟服务器和分析 – 将许可证应用于您的虚拟服务器以管理 NetScaler 实例。有关详细信息，请参阅管理订阅。

  • 应用程序仪表板 – 以整体方式查看所有应用程序。有关详细信息，请参阅应用程序管理和仪表板。

  • 基础架构分析 – 此功能可帮助您可视化导致或可能导致实例出现问题的因素。有关详细信息，请参阅基础架构分析。

通过 NetScaler 内置代理配置许可证服务器

注意：

NetScaler 内置代理无法分配 LSA 角色。

如果您在一个站点中配置了许可证服务器代理 (LSA) 并希望从其他站点使用相同的 LSA，则可以使用 NetScaler 内置代理。在使用内置代理时，您必须在 NetScaler 实例上使用以下命令配置许可证服务器。

add licenseserver 127.0.0.1 -port 27000

在此配置中，NetScaler 可以通过 Console 服务访问许可证服务器代理 (LSA)。

注意：

您还可以通过导航到基础架构 > 实例 > 代理 > 生成激活码页面来配置内置代理。复制 URL 和激活码并将其粘贴到 NetScaler 实例中，然后发现该实例。

启动内置代理后，导航到基础架构 > 实例 > NetScaler。此页面显示使用内置代理发现的托管实例的详细信息。

故障排除

如果注册失败，或者注册成功但内置代理未显示在 NetScaler Console GUI 中，您可以检查日志。

  • 如果注册失败，请检查 /var/mastools/logs/mastools_reg.py.log 中的日志。
  • 如果注册成功，但内置代理未显示在 NetScaler Console GUI 中，请检查：
    • /var/mastools/logs/mastools_upgrade.log 中的 Mastools_upgrade 日志。
    • /var/log/mastoolsd.log 中的 二进制日志。
配置内置代理以管理实例
August 22, 2025
投稿者: 
C
August 22, 2025
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.