Composer 中的 ThingWorx 模型定义 > 系统 > 对出站请求使用代理服务器
对出站请求使用代理服务器
自 9.3.4 起,ThingWorx Platform 支持针对大多数出站请求使用 HTTP/HTTPS 代理。ThingWorx Platform 的某些区域支持显式代理,例如 ContentLoaderFunctions。如果未提供显式代理,则 ThingWorx Platform 会使用为 ThingWorx Platform 配置的代理 (若有)。
* 
当前仅 ThingWorx Platform 支持显式代理。当前不支持同 DPM 类似的解决方案与代理支持搭配使用,否则可能会导致意外结果。
ThingWorx Platform 代理功能不支持需进行身份验证的代理。代理服务器当前不支持单一登录和 ActiveDirectory DirectoryService。要使用 JVM 设置更改代理支持,请于更改后重新启动 ThingWorx Platform
配置
代理支持使用 Java 运行时的基础支持,该支持于 ThingWorx Platform 启动后由 Java 系统属性指定。将 Java 系统属性作为 -Dkey=value 添加至 Apache Tomcat。添加属性的位置因所安装的操作系统而异。可配置多个代理属性,具体取决于所需的特定代理设置。有关详细信息,请参阅 Java 文档
HTTP/HTTPS 代理
在请求 HTTP 资源时,ThingWorx Platform 将使用已配置的 HTTP 代理。Java 系统属性 http.proxyHosthttp.proxyPort 将分别定义主机和端口。要包含所有不得通过代理的资源,请指定 http.nonProxyHosts。由于 ThingWorx Platform 需访问仅限内部使用的资源,因此具有此类资源非常有用。使用竖线 (|) 分隔各个值。http.nonProxyHosts 的默认值包括用于访问本地系统 (localhost|127.*|[::1]) 的所有变型。提供需添加的默认值和所有自定义值。
在请求 HTTPS 资源时,ThingWorx Platform 将使用已配置的 HTTPS 代理。Java 系统属性 https.proxyHosthttps.proxyPort 将分别定义主机和端口。HTTPS 代理使用与 HTTP (http.nonProxyHosts) 相同的非代理主机列表。
* 
PTC 强烈建议使用 https 代理。
使用主机代理设置
Java 运行时还允许使用在主机上定义的代理设置,而非直接配置 HTTP/HTTPS 代理。要在操作系统设置中启用代理配置,请在 CATALINA_OPTS 下将 Java 系统属性 java.net.useSystemProxies 设置为 true。操作系统设置可启用复杂的代理设置,具体取决于主机系统中使用的代理自动配置 (PAC) 文件和 Web 代理自动发现 (WPAD)。
如果将 ThingWorx Platform 配置为使用主机代理设置,则可在运行时更改代理。
使用容器的主机代理设置
在 Docker 或 Kubernetes 环境中运行的容器对于实际的主机系统处于隐藏状态。因此,使用主机代理设置可能无法按预期运行。如果容器需要出站代理,则必须直接通过 Apache Tomcat 的 HTTP/HTTPS 代理属性对其进行配置。使用 CATALINA_OPTS 环境变量配置这些 Java 系统属性。
这对您有帮助吗?