主页
产品
Red Hat JBoss Enterprise Application Platform
8.0
配置指南
15.6. 配置默认欢迎 Web 应用

15.6. 配置默认欢迎 Web 应用

JBoss EAP 包含一个默认的 Welcome 应用，默认显示在端口 8080 上的根上下文中。

Undertow 中预先配置了提供欢迎内容的默认服务器。

默认的 Undertow 子系统配置

<subsystem xmlns="{UndertowSubsystemNamespace}" default-server="default-server" default-virtual-host="default-host" default-servlet-container="default" default-security-domain="other">
    ...
    <server name="default-server">
        <http-listener name="default" socket-binding="http" redirect-socket="https" enable-http2="true"/>
        <https-listener name="https" socket-binding="https" security-realm="ApplicationRealm" enable-http2="true"/>
        <host name="default-host" alias="localhost">
            <location name="/" handler="welcome-content"/>
            <http-invoker security-realm="ApplicationRealm"/>
        </host>
    </server>
    ...
    <handlers>
        <file name="welcome-content" path="${jboss.home.dir}/welcome-content"/>
    </handlers>
</subsystem>

<subsystem xmlns="{UndertowSubsystemNamespace}" default-server="default-server" default-virtual-host="default-host" default-servlet-container="default" default-security-domain="other">
    ...
    <server name="default-server">
        <http-listener name="default" socket-binding="http" redirect-socket="https" enable-http2="true"/>
        <https-listener name="https" socket-binding="https" security-realm="ApplicationRealm" enable-http2="true"/>
        <host name="default-host" alias="localhost">
            <location name="/" handler="welcome-content"/>
            <http-invoker security-realm="ApplicationRealm"/>
        </host>
    </server>
    ...
    <handlers>
        <file name="welcome-content" path="${jboss.home.dir}/welcome-content"/>
    </handlers>
</subsystem>

Copy to Clipboard

Toggle word wrap

默认服务器 default-server 配置了默认主机 default-host。默认主机被配置为使用 < location> 元素处理对服务器根 的请求，以及 welcome-content 文件处理程序。welcome-content 处理程序在 path 属性中指定的位置上提供内容。

此默认 Welcome 应用可以替换为您自己的 Web 应用。这可以通过以下两种方式之一进行配置：

您还可以禁用欢迎内容。

15.6.1. 更改 welcome-content 文件处理程序
复制链接

此流程解释了如何更改 welcome-content 文件处理程序，以指向您自己的 Web 应用。

先决条件

您可以访问管理 CLI。
有修改服务器配置的权限。

流程

修改现有 welcome-content 文件处理器的路径以指向您的新内容：

   ----
   /subsystem=undertow/configuration=handler/file=welcome-content:write-attribute(name=path,value="/path/to/your/content")
   ----

   ----
   /subsystem=undertow/configuration=handler/file=welcome-content:write-attribute(name=path,value="/path/to/your/content")
   ----

Copy to Clipboard

Toggle word wrap

另外，您可以创建一个新的文件处理程序，供服务器的 root 使用：

   ----
   /subsystem=undertow/configuration=handler/file=NEW_FILE_HANDLER:add(path="/path/to/your/content")
   /subsystem=undertow/server=default-server/host=default-host/location=\/:write-attribute(name=handler,value=NEW_FILE_HANDLER)
   ----

   ----
   /subsystem=undertow/configuration=handler/file=NEW_FILE_HANDLER:add(path="/path/to/your/content")
   /subsystem=undertow/server=default-server/host=default-host/location=\/:write-attribute(name=handler,value=NEW_FILE_HANDLER)
   ----

Copy to Clipboard

Toggle word wrap

重新载入服务器以使更改生效：
```
   ----
   reload
   ----
```
```
   ----
   reload
   ----
```
Copy to Clipboard Toggle word wrap

15.6.2. 更改 default-web-module
复制链接

此流程解释了如何通过更改 default-web-module 将部署的 Web 应用程序映射到服务器的 root。

先决条件

您可以访问管理 CLI。
有修改服务器配置的权限。

流程

将部署的 Web 应用映射到服务器的 root。

   ----
   /subsystem=undertow/server=default-server/host=default-host:write-attribute(name=default-web-module,value=your-application.war)
   ----

   ----
   /subsystem=undertow/server=default-server/host=default-host:write-attribute(name=default-web-module,value=your-application.war)
   ----

Copy to Clipboard

Toggle word wrap

重新载入服务器以使更改生效：

   ----
   reload
   ----

   ----
   reload
   ----

Copy to Clipboard

Toggle word wrap

15.6.3. 禁用默认的欢迎 Web 应用程序
复制链接

此流程解释了如何通过删除根上下文 的位置 条目来禁用默认的欢迎 Web 应用程序。

先决条件

您可以访问管理 CLI。
有修改服务器配置的权限。

流程

删除 default-host 的位置 条目 / ：

   ----
   /subsystem=undertow/server=default-server/host=default-host/location=\/:remove
   ----

   ----
   /subsystem=undertow/server=default-server/host=default-host/location=\/:remove
   ----

Copy to Clipboard

Toggle word wrap

重新载入服务器以使更改生效：
```
   ----
   reload
   ----
```
```
   ----
   reload
   ----
```
Copy to Clipboard Toggle word wrap

返回顶部

15.6. 配置默认欢迎 Web 应用

默认的 Undertow 子系统配置

15.6.1. 更改 welcome-content 文件处理程序
复制链接

15.6.2. 更改 default-web-module
复制链接

15.6.3. 禁用默认的欢迎 Web 应用程序
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

15.6. 配置默认欢迎 Web 应用

默认的 Undertow 子系统配置

15.6.1. 更改 welcome-content 文件处理程序复制链接链接已复制到粘贴板!

15.6.2. 更改 default-web-module复制链接链接已复制到粘贴板!

15.6.3. 禁用默认的欢迎 Web 应用程序复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

15.6.1. 更改 welcome-content 文件处理程序
复制链接

15.6.2. 更改 default-web-module
复制链接

15.6.3. 禁用默认的欢迎 Web 应用程序
复制链接