第 18 章 配置远程

远程 子系统 允许您为本地和远程服务配置入站和出站连接，以及这些连接的设置。

JBoss Remoting 项目包括以下可配置的元素：端点、连接器、http-connector 以及一系列本地和远程连接 URI。

对于大多数用例，您可能不需要配置 remoting 子系统。如果为您的应用程序使用自定义连接器，您必须配置 remoting 子系统。

充当远程客户端的应用（如 Jakarta Enterprise Beans）需要独立的配置来连接特定的连接器。

默认删除子系统配置

<subsystem xmlns="urn:jboss:domain:remoting:4.0">
    <endpoint/>
    <http-connector name="http-remoting-connector" connector-ref="default" security-realm="ApplicationRealm"/>
</subsystem>

<subsystem xmlns="urn:jboss:domain:remoting:4.0">
    <endpoint/>
    <http-connector name="http-remoting-connector" connector-ref="default" security-realm="ApplicationRealm"/>
</subsystem>

如需了解可用于 远程子系统的属性 的完整列表，请参阅 删除子系统属性。

远程端点

远程端点使用由 io 子系统声明和配置的 XNIO 工作程序。

如需有关如何 配置远程端点的详情，请参阅配置 Endpoint。

connector

连接器 是 JBoss Remoting 项目的主要 remoting 配置元素，用于允许外部客户端连接到给定端口上的服务器。通过 连接器 需要连接到服务器的客户端必须使用指向服务器的 URL 中的 Remoting remote 协议，如 remote://localhost:4447。

您可以配置多个连接器。每个连接器由一个 < connector&gt; 元素组成，具有多个子元素和几个其他属性，如 socket-binding 和 ssl-context。

多个 JBoss EAP 子系统可以使用默认连接器。自定义连接器元素和属性的具体设置取决于您的应用程序。请联系红帽全球支持服务以了解更多信息。

有关如何 配置连接器 的详情，请参阅配置连接器。

http-connector

http-connector 元素是一个特殊的连接器配置元素。外部客户端可以使用 undertow 的 HTTP 升级功能使用此元素来连接到服务器。

使用这个配置，客户端首先使用 HTTP 协议与服务器建立连接，然后通过同一连接使用 远程协议。这有助于使用不同协议的客户端通过同一端口连接，如 undertow 的默认端口 8080。通过同一端口连接可减少服务器上的开放端口数。

通过 HTTP 升级需要连接到服务器的客户端必须使用 remoting remote+http 协议进行未加密的连接，或 remoting remote+https 协议进行加密。

出站连接

您可以指定三种不同类型的出站连接：

其他配置

远程操作取决于在远程 子系统 之外配置的多个元素，如网络接口和 IO 工作程序。

如需更多信息，请参阅 附加远程配置。