文档Experience Cloud KCS

解决AEM as a Cloud Service中专用出口IP的连接超时错误

最近更新： 2026年6月22日

本文介绍了在Adobe Experience Manager as a Cloud Service (AEMaaCS)中配置专用出口IP以安全路由外部API调用时出现的连接超时错误。 当出站流量默认为Adobe的共享IP池而不是使用配置的专用出口IP时，会出现此问题。 要解决此问题，请确保出站流量使用配置的专用出口IP。

描述 description

环境

产品： Adobe Experience Manager as a Cloud Service (AEMaaCS) 功能：专用出口IP配置 网络：使用HTTP/HTTPS代理的高级网络

问题/症状

  • 通过专用出口IP进行的外部API调用会导致连接超时错误。
  • 网络日志显示没有通过专用出口IP路由的流量。
  • 可公开访问的外部API端点成功，但使用共享IP地址。
  • System.getenv("AEM_HTTP_PROXY_PORT")返回null，导致无法进行正确的代理配置。

解决方法 resolution

要解决此问题，请执行以下步骤：

  1. 确认Cloud Manager中服务下的 专用出口IP地址 处于 就绪 状态 > 网络基础架构。

  2. 确保为 环境 下的相关环境启用高级联网 > 高级网络配置。

  3. 使用端口3128作为通过专用出口IP路由HTTP/HTTPS流量的默认代理端口。 更新应用程序代码以明确配置代理主机和端口，确保所有HTTP/HTTPS请求都使用以下代理配置：

    code language-none 
    String proxyHost = System.getenv("AEM_PROXY_HOST"); // Example: "proxy.tunnel"
int proxyPort = Integer.parseInt(System.getenv().getOrDefault("AEM_HTTP_PROXY_PORT", "3128"));

  4. 删除不需要的标准HTTP/HTTPS端口（80和443）的端口转发规则，因为它们不是必需的。 如果现有配置与此设置冲突，请删除“高级联网”下的任何现有配置。

  5. 通过验证API调用是否成功通过专用出口IP路由、监控网络日志或针对列入白名单的端点进行测试，来测试连接。

  6. 在代码中实施回退逻辑以动态检索或默认使用端口3128（如果System.getenv("AEM_HTTP_PROXY_PORT")返回null）。 此外，监控Adobe文档以了解有关默认代理配置的更新或网络行为的更改。

执行以下步骤可确保通过您配置的专用出口IP安全可靠地路由外部API调用。

相关阅读

专用出口 IP 地址

recommendation-more-help
experience-cloud-kcs-help-kbarticles