虚拟主机 (virtualHost)
虚拟主机将提供用于将 Web 应用程序配置为特定主机名的逻辑分组。缺省虚拟主机 (default_host) 适合于大多数简单配置。
| 属性名称 | 数据类型 | 缺省值 | 描述 |
|---|---|---|---|
| allowFromEndpointRef | 顶级 httpEndpoint 元素的引用列表(以逗号分隔的字符串)。 | 指定一个或多个 HTTP 端点的标识以将此虚拟主机的入站流量限制为所指定的端点。 | |
| enabled | 布尔型 | true | 启用此虚拟主机。 |
| id | string | 唯一配置标识。 |
- allowFromEndpoint
描述: 指定一个或多个 HTTP 端点的标识以将此虚拟主机的入站流量限制为所指定的端点。必需: False数据类型: 属性名称 数据类型 缺省值 描述 accessLoggingRef 对顶级 httpAccessLogging 元素的引用(字符串)。 端点的 HTTP 访问日志记录配置。 enabled 布尔型 true 切换端点的可用性。值为 true 时,分派器将激活此端点以处理 HTTP 请求。 主机 string localhost 客户机用于请求资源的 IP 地址、带域名后缀的域名服务器 (DNS) 主机名,或仅 DNS 主机名。可使用“*”来表示所有可用网络接口。 httpOptionsRef 对顶级 httpOptions 元素的引用(字符串)。 defaultHttpOptions 端点的 HTTP 协议选项。 httpPort 整型 最小值:-1
最大值:65535
用于客户机 HTTP 请求的端口。使用 -1 来禁用此端口。 httpsPort 整型 最小值:-1
最大值:65535
用于通过 SSL (https) 来保护的客户机 HTTP 请求的端口。使用 -1 来禁用此端口。 id string 唯一配置标识。 onError - IGNORE
- FAIL
- WARN
WARN 启动端点失败后要执行的操作。 - IGNORE
- 服务器在引发配置错误时将不会发出任何警告和错误消息。
- FAIL
- 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。
- WARN
- 服务器在引发配置错误时将发出警告和错误消息。
sslOptionsRef 对顶级 sslOptions 元素的引用(字符串)。 端点的 SSL 协议选项。 tcpOptionsRef 对顶级 tcpOptions 元素的引用(字符串)。 defaultTCPOptions 端点的 TCP 协议选项。 - allowFromEndpoint > accessLogging
描述: 端点的 HTTP 访问日志记录配置。必需: False数据类型: 属性名称 数据类型 缺省值 描述 enabled 布尔型 true 启用访问日志记录。 filePath 文件路径 ${server.output.dir}/logs/http_access.log 访问日志文件的目录路径和名称。指定目录路径时可以使用标准变量替换,如 ${server.output.dir}。 logFormat string %h %u %{t}W "%r" %s %b 指定在日志记录客户机访问信息时所使用的日志格式。 maxFileSize 整型 最小值:0
20 回滚之前日志文件的最大大小,以兆字节计;值为 0 时意味着无限制。 maxFiles 整型 最小值:0
2 移除最旧的日志文件之前将保留的最大日志文件数;值为 0 时意味着无限制。
- allowFromEndpoint > httpOptions
描述: 端点的 HTTP 协议选项。必需: False数据类型: 属性名称 数据类型 缺省值 描述 keepAliveEnabled 布尔型 true 启用持续连接(HTTP 保持活动)。如果为 true,那么连接将保持活动状态,以供多个顺序请求和响应复用。如果为 false,那么发送响应之后会关闭连接。 maxKeepAliveRequests 整型 最小值:-1
100 启用持续连接时,单个 HTTP 连接上可接受的最大持续请求数。值为 -1 时意味着不受限制。 persistTimeout 精度为秒的时间段 30s 将允许套接字在两个请求之间保持空闲的时间量。仅当启用持续连接时,此设置才适用。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 readTimeout 精度为秒的时间段 60s 发生第一次读取之后,用于等待读请求在套接字上完成的时间量。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 removeServerHeader 布尔型 False 从 HTTP 头中移除服务器实现信息,并且还要禁用缺省 Liberty 概要文件欢迎页面。 writeTimeout 精度为秒的时间段 60s 响应数据的每个部分在套接字上等待传输的时间量。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
- allowFromEndpoint > sslOptions
描述: 端点的 SSL 协议选项。必需: False数据类型: 属性名称 数据类型 缺省值 描述 sessionTimeout 精度为秒的时间段 1d 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 sslRef 对顶级 ssl 元素的引用(字符串)。 缺省 SSL 配置指令表。缺省值为 defaultSSLSettings。 suppressHandshakeErrors 布尔型 False 禁止记录 SSL 握手错误。正常操作期间可能会发生 SSL 握手错误,但是如果 SSL 行为异常,那么这些消息很有用。
- allowFromEndpoint > tcpOptions
描述: 端点的 TCP 协议选项。必需: False数据类型: 属性名称 数据类型 缺省值 描述 inactivityTimeout 具有毫秒精度的时间段 60s 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,将 500 毫秒指定为 500ms。可以将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 soReuseAddr 布尔型 true 允许立即重新绑定到没有任何处于活动状态的侦听器的端口。
参考主题