全局设置¶

代理基URL¶

geoserver可以让功能文档正确地报告代理。”proxy base url”字段是反向代理之外的基本URL。

代理基URL字段支持环境参数化(请参见 Parameterize catalog settings )通过激活JVM参数：：

-DALLOW_ENV_PARAMETRIZATION=true

一旦激活，环境参数化代理基URL可以是参数占位符，如：：

${proxy.base.url}

使用代理URL的标题¶

选中此框允许使用模板（基于HTTP代理头的模板）按请求修改代理URL。

支持的代理头包括：

1. X-Forwarded-Proto 请求使用的协议

2. X-Forwarded-Host 代理URL的主机名和端口

3. X-Forwarded-For 客户端IP地址

4. X-Forwarded-Path 代理URL的路径（这不是一个正式的HTTP头，尽管它被一些web服务器支持）

5. 转发的 取代“x-forwarded”的标题- * “上面的标题。它有以下组件：“by”、“for”、“host”、“proto”、“path”（此组件不是正式的，而是为了与 X-Forwarded-Path ）

6. Host 等同于 X-Forwarded

例如，允许不同的协议 (http 和 https )以及不同的主机名，proxy base URL字段可以更改为： ${{X-Forwarded-Proto}}://${{X-Forwarded-Host}}/geoserver 使用的 Forwarded 头部稍微复杂一点，因为其组件必须在带有点符号的模板中引用，如： {{Forwarded.proto}}://${{Forwarded.host}}/geoserver .

“代理基URL”中可以放入多个模板。这些模板提供后备，因为只使用第一个完全匹配的模板。例如，代理基URL为 http://${X-Forwarded-Host}/geoserver http://www.foo.org/geoserver (注意：模板以空格分隔)可能导致以下任一结果： http://www.example.com/geoserver (如果 X-Forwarded-Host 设置为 www.example.com )或 http://www.foo.org/geoserver (如果 X-Forwarded-Host 未设置。)

标题名称和附加路径（例如 /geoserver ）在模板中不区分大小写。

当使用代理URL的Header支持激活环境参数化时，求值顺序为：

1. 环境参数化占位符替换(如果在环境变量上找不到占位符，则它保持不变)。

2. 页眉占位符替换。

启用全局服务¶

启用后，允许访问全局服务和 virtual services 。禁用后，客户端将只能访问虚拟服务。如果Geoserver托管大量层，并且您希望确保客户端始终请求有限的层列表，则禁用非常有用。出于安全原因，禁用也很有用。

允许每个工作区存储的查询¶

启用后，允许持久化每个工作区的存储查询，使在工作区内创建的查询仅在工作区虚拟服务中可用。

不受限制的XML外部实体解析¶

发送到Geoserver的XML请求可以包括对其他XML文档的引用。由于这些文件是由Geoserver处理的，该设施可用于访问服务器上的文件，这是一个安全问题。

• 启用 Unrestricted XML External Entity Resolution 在使用应用程序架构扩展以允许使用本地XSD定义时选择。

  此选项禁用所有其他外部实体解析限制(请参见 外部实体解析 )

字符集¶

指定将在XML响应中使用的全局字符编码。缺省值为 UTF-8 ，这是推荐给大多数用户的。上提供了支持的字符集的完整列表 IANA Charset Registry 。

小数位数¶

指在GML GetFeature响应中返回的小数位数。在优化带宽方面也很有用。缺省值为 8 。

详细的XML输出¶

启用详细消息时，将导致Geoserver返回包含换行符和缩进的XML。

由于此类XML响应包含较大的数据量，进而需要较大的带宽，因此建议仅出于测试目的使用此选项。

如何处理数据和配置问题¶

此设置确定当某个层由于某种原因变得不可访问时，Geoserver将如何响应。

默认情况下，当层有错误时(例如，删除层的默认样式时)，服务异常将作为功能文档的一部分打印，从而使文档无效。对于依赖有效功能文档的客户端，这可以有效地使Geoserver看起来像是“离线”。

管理员可能更喜欢将geoserver配置为简单地从功能文档中省略问题层，从而保持文档完整性，并允许客户机连接到其他发布的层。

有两种选择：

• OGC_EXCEPTION_REPORT ：这是默认行为。任何层错误都将在功能文档中显示为服务异常，从而使其无效。

• SKIP_MISCONFIGURED_LAYERS ：在此设置下，Geoserver将选择根本不描述问题层，将其从功能文档中删除，并保留文档其余部分的完整性。

  请注意，让一个层“消失”可能会导致客户端功能中的其他错误。

  这是从geoserver 2.11开始的默认设置，允许更快的启动，因为不需要提前检查存储连接。

在服务异常中包括堆栈跟踪¶

详细异常报告返回带有完整Java堆栈跟踪的服务异常(类似于它们在Geoserver日志文件中的显示方式)。

默认情况下，此设置处于禁用状态，Geoserver返回单行错误消息。

仅建议将此设置用于本地故障排除和调试。过高的详细程度可能会成为安全漏洞(例如，揭示服务器文件夹结构的文件未找到异常)。

日志位置¶

Sets the written output location for the logs. A log location may be a directory or a file, and can be specified as an absolute path (e.g., C:\GeoServer\GeoServer.log) or a relative one (for example, geoserver.log). Relative paths are relative to the GeoServer data directory. Default is logs/geoserver.log.

这 Log location 设置可以被重写为 GEOSERVER_LOG_LOCATION 属性，请参见 高级日志配置 有关详细信息(此设置适用于FileAppender或RollingFile geoserverlogfile 附加器)。

日志配置文件¶

选择一个 Logging profile 以确定Geoserver运行期间的详细日志量。

全局设置页面上提供的内置日志记录配置文件包括：

• Default Logging (DEFAULT_LOGGING) — Provides a good mix of detail without being too verbose.

  默认日志记录启用 CONFIG 和 INFO 消息，几个(喋喋不休的)Geoserver和GeoTools包减少到 WARN 。

  此日志记录级别可用于查看Geoserver的传入请求，以便再次检查正在接收的请求是否已被正确解析。

• GeoServer Developer Logging (GEOSERVER_DEVELOPER_LOGGING) - A verbose logging profile that includes DEBUG information for GeoServer activities.

  建议将此开发人员配置文件用于Geoserver的主动调试。

• GeoTools Developer Logging (GEOTOOLS_DEVELOPER_LOGGING) - A verbose logging profile that includes DEBUG messages for the GeoTools library.

  建议将此开发人员配置文件用于GeoTool的主动调试。这对于解决渲染和数据访问问题特别有用。

• Production Logging (PRODUCTION_LOGGING) - Minimal logging profile, with only WARN log messages.

  对于生产级日志记录，只有问题会写入日志文件。

• Quiet Logging (QUIET_LOGGING) - Turns off logging.

• Verbose Logging (VERBOSE_LOGGING) - Provides more detail by enabling DEBUG messages.

  此配置文件仅在故障排除时有用。

每个配置文件对应于Geoserver数据目录(阿帕奇)中的一个log4j配置文件 log4j 是一个基于Java的日志记录实用程序)。可以通过复制上面的一个内置配置文件来添加其他自定义配置文件，在 logs 文件夹，并编辑log4j文件。可以使用以下命令禁用log4j RELINQUISH_LOG4J_CONTROL 财产。看见 高级日志配置 以获取更多信息。

登录到stdout¶

标准输出确定程序将其输出数据写入何处。在Geoserver中，Log to StdOut设置允许记录到启动程序的文本终端。

如果您在大型的J2EE容器中运行Geoserver，您可能不希望容器范围的日志中充满Geoserver信息。清除此选项将禁止大多数Geoserver日志记录，只有致命异常仍会输出到控制台日志。

此设置可由系统属性覆盖，请参见 高级日志配置 有关详细信息(此设置将删除控制台 stdout 附加器)。

启用请求日志记录¶

这些设置允许为发送到Geoserver的所有请求记录请求的URL，以及可选的请求头和POST请求的内容。

• Enable Request Logging ：选择以启用传入请求的日志记录，这将包括操作 (GET 、``POST``等...)和所请求的URL。

• Log Request Bodies ：选择以启用记录传入请求的正文。将记录文本内容或二进制内容的字节数，具体取决于下面设置的传入请求要记录的字符数设置。

• Number of characters to log for incoming POST requests ：在更详细的日志记录级别中，Geoserver将记录传入请求的正文。不过，它只记录请求的初始部分，因为它必须存储(缓冲)记录的所有内容，以便在Geoserver正常使用它的部分使用。此设置以字符为单位设置此缓冲区的大小。设置为 0 将禁用记录请求正文。

• Log Request Headers ：选择以启用请求标头信息的日志记录。

我们建议在日常操作中禁用这些设置。有关应用这些设置及其在故障排除中的用法的更多信息，请参见 troubleshooting 。

功能类型缓存大小¶

由于性能原因，geoserver可以在内存中缓存数据存储连接和模式。缓存大小通常应大于预期同时访问的不同FeatureType的数量。如果可能，请使该值大于服务器上的FeatureType总数，但设置太高可能会导致内存不足错误。另一方面，低于已注册功能类型总数的值可能会更频繁地清除和重新加载资源缓存，这可能很昂贵，例如同时延迟WFS请求。功能类型缓存大小的默认值为100。

文件锁定¶

此配置设置允许控制访问Geoserver数据目录时使用的文件锁定类型。此设置用于保护Geoserver配置不会被同时编辑的多方破坏。使用REST API配置Geoserver时应使用文件锁定，并且当多个管理员同时进行更改时可以保护Geoserver。

有三种选择：

• NIO文件锁定 ：使用适合在群集环境中使用的Java新IO文件锁（多个地理服务器共享同一数据目录）。

• In-process locking ：用于确保两个web管理或REST会话不能同时修改单个配置文件。

• 禁用锁定 ：不使用文件锁定。

WebUI模式¶

此配置设置允许控制WebUI重定向行为。默认情况下，当用户加载包含输入的页面时，将返回HTTP302重定向响应，该响应会导致在请求参数中使用生成的会话ID重新加载该响应。此会话ID允许在刷新后记住页面的状态，并防止发生“双重提交问题”。但是，此行为与多个Geoserver实例的群集不兼容。

有三种选择：

• DEFAULT ：除非已加载群集模块，否则使用重定向。

• REDIRECT ：始终使用重定向（与群集不兼容）。

• DO_NOT_REDIRECT ：从不使用重定向（重新加载页面时不记得状态，可能导致双重提交）。

请注意，要使设置中的更改生效，必须重新启动geoserver。

REST禁用资源未找到日志记录¶

此参数可用于在执行REST操作且请求的资源不存在时禁用异常日志记录。通过向REST调用添加以下参数，可以覆盖此默认设置： quietOnNotFound=true/false .

REST路径映射器根目录路径¶

restful api将此参数用作 Root Directory 对于新上载的文件，请遵循以下结构：

${rootDirectory}/workspace/store[/<file>]

在管理列表上显示创建时间戳¶

这些复选框可用于在工作空间、商店、层、图层组和样式管理列表页上切换创建日期。

可以通过将鼠标光标悬停在日期上来查看创建时间。

在管理列表上显示修改时间戳¶

这些复选框可用于在工作空间、商店、层、图层组和样式管理列表页上切换修改日期。

通过将鼠标光标悬停在日期上可以查看修改时间。

将URL与尾部斜杠匹配¶

此设置确定Geoserver是否与URL匹配，无论请求是否带有尾随斜杠。如果启用，则映射到“/OGC/Collection”的请求也与“/OGC/Collection/”匹配。需要重新启动才能使对此设置的更改生效。

请注意，由于引入了可能导致安全漏洞的歧义，因此在未来版本的Geoserver中可能会完全删除尾随斜杠匹配。有关这一问题的讨论可在 this Spring issue 。