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