Bridge adapter

Zabbix bridge adapter 可让您的 Zabbix 服务器与 Zabbix 移动应用进行通信。

Zabbix 移动应用不会直接连接到您的 Zabbix 服务器。 相反,两个组件会在它们之间传递数据:

  • Zabbix Bridge - 一个集中托管的服务,用于与移动设备上的 Zabbix 移动应用交换数据。
  • Zabbix bridge adapter - 您需要安装并运行的组件。 它将您的 Zabbix 服务器连接到 Zabbix Bridge。

您可以使用软件包将 bridge adapter 安装在与 Zabbix 服务器相同的系统上,也可以安装在其他系统上。

要配置 Zabbix bridge adapter,请更新其配置文件(默认路径:/etc/zabbix/zabbix_bridge_adapter.conf)。

要确保 Zabbix bridge adapter 的安全性,请参阅安全的移动访问。

网络连接

Zabbix bridge adapter 会发起与 Zabbix Bridge 的所有连接,因此您无需允许来自互联网的入站连接。

以下连接在您的网络内部进行:

  • Zabbix 服务器 → Bridge adapter(HTTP(S):ListenPort)- 发送推送通知和设备管理请求。
  • Bridge adapter → Zabbix API(HTTP(S):ZabbixAPIURL 端口)- 如果 AllowedAPIMethods 允许,则转发来自移动应用的请求。
  • Health-check client → Bridge adapter(HTTP:ListenHealthPort)- 检查 /health 和 /ready 端点(例如来自负载均衡器或容器编排器),前提是已设置 ListenHealthPort。

您可以加密 Zabbix 服务器、Zabbix bridge adapter 和 Zabbix API 之间的连接。

以下连接通过互联网进行(始终加密,TLS 1.2/1.3):

  • Bridge adapter → Bridge(HTTPS:443):
    • 启动时,从 ZabbixBridgeURL 获取服务端点列表。
    • 在 https://auth.mobilebridge.zabbix.com/oauth2/token 从 Zabbix Bridge 身份提供商(OAuth 2.0)获取访问令牌。
  • Bridge adapter → Bridge(gRPC:443):
    • 启动时,通过 enroll.mobilebridge.zabbix.com:443 为 Zabbix 服务器注册(仅一次)。
    • 保持与 api.mobilebridge.zabbix.com:443 的开放连接,以接收来自移动应用的查询。
    • 向 register.mobilebridge.zabbix.com:443 发送设备管理请求。
    • 向 api.mobilebridge.zabbix.com:443 发送推送通知。
  • 移动应用 → Bridge(HTTPS:443):
    • 从 https://config.mobilebridge.zabbix.com/.well-known/bridge-configuration 获取服务端点列表。
    • 在 https://auth.mobilebridge.zabbix.com/oauth2/token 从 Zabbix Bridge 身份提供商(OAuth 2.0)获取访问令牌。
  • 移动应用 → Bridge(gRPC:443):
    • 当您添加设备并扫描二维码时,通过 enroll.mobilebridge.zabbix.com:443 为移动设备注册。
    • 向 api.mobilebridge.zabbix.com:443 发送查询(例如,当您更新问题时)。