第 15 章 Web 子系统


15.1. 配置 Web 子系统

您可以用基于 Web 的管理控制台或命令行管理 CLI 配置 Web 子系统的大多数方面。我们会按管理控制台里出现的顺序逐一解释每个设置,同时也提供对管理 CLI 命令的解释。
用管理控制台查看 Web 子系统

要使用基于 Web 的管理控制台配置 Web 子系统,请点击右上角的 Profile(s) 标签页。对于受管域,从左上角的 Profile(s) 里选择您要配置的服务器配置集。展开 Subsystems 菜单,然后展开 Web 菜单。屏幕会显示 Web 子系统的每个可配置部分。

注意

对于受管域,只有您的配置集是 hafull-ha 时,或者如果您用 standalone-hastandalone-full-ha 配置集启动独立服务器时,mod_cluster 组件才可用;mod_cluster 配置的详情请参考 第 16.5.2 节 “配置 mod_cluster 子系统”
配置 JSP 容器、HTTP 连接器和虚拟 HTTP 服务器

要配置 JSP 容器、HTTP 连接器和虚拟 HTTP 服务器,请点击 Servlet/HTTP 菜单条目。点击 Edit 按钮修改任何值。点击 Advanced 按钮查看高级选项。下面解释了这些选项。HTTP 连接器和虚拟服务器的选项显示在单独的表里。

Expand
表 15.1. Servlet/HTTP 配置选项
选项 描述 CLI 命令
Disabled?
如果为 true,禁用 JSP 容器。默认是 false。如果您没有使用任何 JSP,这会很有用。
/profile=full-ha/subsystem=web/configuration=jsp-configuration/:write-attribute(name=disabled,value=false)
Copy to Clipboard Toggle word wrap
Development?
如果为 true,则启用 Development Mode,这会产生更多冗余的调试信息。默认是 false
/profile=full-ha/subsystem=web/configuration=jsp-configuration/:write-attribute(name=development,value=false)
Copy to Clipboard Toggle word wrap
Keep Generated?
如果这个选项是隐藏的,点击 Advanced 查看这个选项。如果为 true 则保持生成的 Servlets。它默认是启用的。
/profile=full-ha/subsystem=web/configuration=jsp-configuration/:write-attribute(name=keep-generated,value=true)
Copy to Clipboard Toggle word wrap
Check Interval?
如果这个选项是隐藏的,点击 Advanced 查看这个选项。这个值以秒为单位,它确定用后台进程检查 JSP 更新的频率。默认值是 0
/profile=full-ha/subsystem=web/configuration=jsp-configuration/:write-attribute(name=check-interval,value=0)
Copy to Clipboard Toggle word wrap
Display Source?
如果这个选项是隐藏的,点击 Advanced 查看这个选项。如果为 true,当 runtime 错误发生时会显示 JSP 源码片段。默认值是 true
/profile=full-ha/subsystem=web/configuration=jsp-configuration/:write-attribute(name=display-source-fragment,value=true)
Copy to Clipboard Toggle word wrap
对于负载平衡和 HA 群集,AJP 和 HTTP 连接器使用 mod_clustermod_jkmod_proxyISAPINSAPI。要配置连接器,请选择 Connectors 标签并点击 Add。要删除连接器,请选中这个条目并点击 Remove。要编辑连接器,选中后点击 Edit
如下列命令所示,当您用管理 CLI 创建新的连接器时,可以立即设置所需选项。

例 15.1. 创建新的连接器

/profile=full-ha/subsystem=web/connector=ajp/:add(socket-binding=ajp,scheme=http,protocol=AJP/1.3,secure=false,name=ajp,max-post-size=2097152,enabled=true,enable-lookups=false,redirect-port=8433,max-save-post-size=4096)
Copy to Clipboard Toggle word wrap
Expand
表 15.2. 连接器选项
选项 描述 CLI 命令
Name
连接器的唯一名称,用于显示目的。
/profile=full-ha/subsystem=web/connector=ajp/:read-attribute(name=name)
Copy to Clipboard Toggle word wrap
Socket Binding
连接器应该绑定的命名套接字绑定。套接字绑定是套接字名称和网络端口之间的映射。套接字绑定是对每个独立服务器配置的,对于受管域则通过套接字绑定组进行配置。套接字绑定组应用于服务器组。
/profile=full-ha/subsystem=web/connector=ajp/:write-attribute(name=socket-binding,value=ajp)
Copy to Clipboard Toggle word wrap
Scheme
Web 连接器 scheme,如 HTTP 或 HTTPS。
/profile=full-ha/subsystem=web/connector=ajp/:write-attribute(name=scheme,value=http)
Copy to Clipboard Toggle word wrap
Protocol
要使用的 Web 连接器协议,如 AJP 或 HTTP。
/profile=full-ha/subsystem=web/connector=ajp/:write-attribute(name=protocol,value=AJP/1.3)
Copy to Clipboard Toggle word wrap
Enabled
是否启用这个 Web 连接器。
/profile=full-ha/subsystem=web/connector=ajp/:write-attribute(name=enabled,value=true)
Copy to Clipboard Toggle word wrap
要配置虚拟服务器,请点击 Virtual Servers 标签页。请用 Add 按钮来添加新的虚拟服务器。要编辑或删除虚拟服务器,选中相关条目并点击 EditRemove 按钮。
如下列命令所示,当您用管理 CLI 添加新的虚拟服务器时,可以立即设置所需选项。

例 15.2. 添加新的虚拟服务器

/profile=full-ha/subsystem=web/virtual-server=default-host/:add(enable-welcome-root=true,default-web-module=ROOT.war,alias=["localhost","example.com"],name=default-host)
Copy to Clipboard Toggle word wrap
Expand
表 15.3. 虚拟服务器选项
选项 描述 CLI 命令
Name
虚拟服务器的唯一名称,用于显示目的。
Alias
应该匹配这个虚拟服务器的主机名的列表。在管理控制台里,请为每一行使用一个主机名。
/profile=full-ha/subsystem=web/virtual-server=default-host/:write-attribute(name=alias,value=["localhost","example.com"])
Copy to Clipboard Toggle word wrap
Default Module
模块里的 web 应用程序应该部署在虚拟服务器的根节点,且 HTTP 请求里没有给出目录时将显示。
/profile=full-ha/subsystem=web/virtual-server=default-host/:write-attribute(name=default-web-module,value=ROOT.war)
Copy to Clipboard Toggle word wrap
配置 Web Services 选项

要配置 Web Services 选项,请点击 Web Services 菜单条目。下表解释了这些选项。

Expand
表 15.4. Web Services 的配置选项
选项 描述 CLI 命令
修改 WSDL 地址
指定应用程序是否可以修改 WSDL 地址。默认值是 true
/profile=full-ha/subsystem=webservices/:write-attribute(name=modify-wsdl-address,value=true)
Copy to Clipboard Toggle word wrap
WSDL 主机
JAX-WS Web Service 的 WSDL 合约包括 <soap:address> 元素,它指向端点的位置。如果 <soap:address> 的值是一个有效的 URL,除非设置 modify-wsdl-addresstrue,它不会被覆盖。如果 <soap:address> 的值不是一个有效的 URL,它会用 wsdl-hostwsdl-portwsdl-secure-port 的值进行覆盖。如果wsdl-host 被设置为 jbossws.undefined.host,覆盖 <soap-address> 时请求者的主机地址将被使用。它的默认值是 ${jboss.bind.address:127.0.0.1},当 JBoss EAP 6 启动时如果没有指定绑定地址,将使用 127.0.0.1
/profile=full-ha/subsystem=webservices/:write-attribute(name=wsdl-host,value=127.0.0.1)
Copy to Clipboard Toggle word wrap
WSDL 端口
用于重写 SOAP 端口的非安全端口。如果为 0(默认值),端口将通过查询安装的连接器列表来确定。
/profile=full-ha/subsystem=webservices/:write-attribute(name=wsdl-port,value=80)
Copy to Clipboard Toggle word wrap
WSDL 安全端口
用于重写 SOAP 端口的安全端口。如果为 0(默认值),端口将通过查询安装的连接器列表来确定。
/profile=full-ha/subsystem=webservices/:write-attribute(name=wsdl-secure-port,value=443)
Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat