配置内置代理以管理实例

Last published : Oct 06, 2026
内置代理在运行 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 网关
内置代理非常适合较小的 NetScaler 独立部署或 HA 对部署。如果您有多个 NetScaler 实例，请使用专用代理进行部署。此代理可确保您拥有比内置代理更好的数据聚合功能。有关更多信息，请参阅在本地安装代理。
NetScaler Console 内置代理支持实例管理、监控以及池化或弹性许可。但是，内置代理不支持以下功能：
  • 应用程序仪表板
  • Web 洞察
  • SSL 洞察
  • HDX™ 洞察
  • 网关洞察
  • 安全洞察
  • 高级分析
  • 池化或弹性许可（基于文件的许可）
您可以从内置代理过渡到外部代理。有关详细信息，请参阅从内置代理过渡到外部代理。
Related information
开始使用

先决条件

在 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)。
注意：
您还可以通过导航到 Infrastructure > Instances > Agents > Generate Activation code 页面来配置内置代理。复制并粘贴 URL 和激活码到 NetScaler 实例，然后发现该实例。
内置代理启动后，导航到 Infrastructure > Instances > 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 中的 二进制日志。