Firebase 云消息传递

Last published : Oct 21, 2026

注意：

Firebase Cloud Messaging (FCM) 以前称为 Google Cloud Messaging (GCM)。某些 Citrix Endpoint Management 控制台标签和消息使用 GCM 术语。

Citrix 建议您使用 Firebase Cloud Messaging (FCM) 来控制 Android 设备连接到 Citrix Endpoint Management 的方式和时间。Citrix Endpoint Management 在配置为 FCM 时，会向已启用 FCM 的 Android 设备发送连接通知。任何安全操作或部署命令都会触发推送通知，以提示用户重新连接到 Citrix Endpoint Management 服务器。

完成本文中的配置步骤并且设备签入后，设备会在 Citrix Endpoint Management 中向 FCM 服务注册。该连接通过使用 FCM 实现了从 Citrix Endpoint Management 服务到设备的近实时通信。FCM 注册适用于新设备注册和以前注册的设备。

当 Citrix Endpoint Management 需要启动与设备的连接时，它会连接到 FCM 服务。然后，FCM 服务会通知设备进行连接。这种连接类型类似于 Apple 用于其推送通知服务的方式。

先决条件

最新 Citrix Secure Hub 客户端
Google 开发者帐户凭据
在启用 FCM 的 Android 设备上安装 Google Play 服务

防火墙端口

在 Citrix Endpoint Management 上打开端口 443 以连接到 fcm.googleapis.com 和 Google.com。
为设备 Wi-Fi 打开端口 5228、5229 和 5230 上的出站 Internet 通信。
为了允许出站连接，FCM 建议将端口 5228 到 5230 添加到允许列表，且不设 IP 限制。但是，如果需要 IP 限制，FCM 建议将 IPv4 和 IPv6 块中的所有 IP 地址添加到允许列表。这些块列在 Google ASN of 15169 中。每月更新该列表。

有关详细信息，请参阅端口要求。

架构

此图显示了 FCM 在外部和内部网络中的通信流。

为 FCM 配置您的 Google 帐户

使用您的 Google 开发者帐户凭据登录以下 URL：

<https://console.firebase.google.com/>
单击“添加项目”。
创建项目后，单击“项目设置”。

注意：

Google 将弃用用于 HTTP 的 FCM 旧版 API，该 API 目前在我们的 FCM 实现中使用。迁移截止日期为 June 21, 2024。我们需要将 FCM 从旧版 FCM API 迁移到 HTTP v1 API。有关详细信息，请参阅从旧版 FCM API 迁移到 HTTP v1。
单击“云消息传递”选项卡。验证 Firebase Cloud Messaging API 已启用，然后单击“管理服务帐户”。
1. 迁移之前，您可以使用旧版 API，请确保已启用 Cloud Messaging API（旧版）。从“密钥”和“发件人 ID”字段复制值。
  
  如果未列出密钥，请单击“操作”下的省略号以添加密钥。
2. 迁移后，Google 将弃用旧版 API。您必须启用 Firebase Cloud Messaging API (V1)。有关详细信息，请参阅从旧版 FCM API 迁移到 HTTP v1。
  
  从“项目设置”下的“服务帐户”下载服务帐户 JSON 文件。请参阅手动提供凭据部分，为您的服务帐户生成私钥文件。单击“生成新私钥”以下载服务帐户密钥 JSON 文件。