web server apache tomcat11-15-proxy

前言

整理这个官方翻译的系列，原因是网上大部分的 tomcat 版本比较旧，此版本为 v11 最新的版本。

开源项目

从零手写实现 tomcat minicat 别称【嗅虎】心有猛虎，轻嗅蔷薇。

系列文章

web server apache tomcat11-01-官方文档入门介绍

web server apache tomcat11-02-setup 启动

web server apache tomcat11-03-deploy 如何部署

web server apache tomcat11-04-manager 如何管理？

web server apache tomcat11-06-Host Manager App -- Text Interface

web server apache tomcat11-07-Realm Configuration

web server apache tomcat11-08-JNDI Resources

web server apache tomcat11-09-JNDI Datasource

web server apache tomcat11-10-Class Loader

...

代理支持如何操作

介绍

在使用标准配置的 Tomcat 时，Web 应用程序可以请求处理请求的服务器名称和端口号。

当 Tomcat 以 HTTP/1.1 连接器独立运行时，它通常报告请求中指定的服务器名称和连接器侦听的端口号。

关键的 servlet API 调用包括：

• ServletRequest.getServerName(): 返回发送请求的服务器的主机名。

• ServletRequest.getServerPort(): 返回发送请求的服务器的端口号。

• ServletRequest.getLocalName(): 返回接收请求的 IP 接口的主机名。

• ServletRequest.getLocalPort(): 返回接收请求的 IP 接口的端口号。

然而，当在代理服务器后运行时（或将 Web 服务器配置为代理），您可能希望管理这些调用返回的值。

Apache httpd 代理支持

Apache httpd 1.3 版及更高版本支持一个可选的模块（mod_proxy），该模块配置 Web 服务器以充当代理服务器。这可以用于将特定 Web 应用程序的请求转发到 Tomcat 实例，而无需配置像 mod_jk 这样的 Web 连接器。要实现这一点，您需要执行以下任务：

1. 配置您的 Apache 副本，以包含 mod_proxy 模块。如果您从源代码构建，则最简单的方法是在 ./configure 命令行上包含 --enable-module=proxy 指令。

2. 如果尚未为您添加，请确保在 Apache 启动时通过在 httpd.conf 文件中使用以下指令加载 mod_proxy 模块：

   LoadModule proxy_module {path-to-modules}/mod_proxy.so
   

3. 对于您希望转发到 Tomcat 的每个 Web 应用程序，在 httpd.conf 文件中包含两个指令。例如，要转发上下文路径为 /myapp 的应用程序：

   ProxyPass         /myapp  http://localhost:8081/myapp
   ProxyPassReverse  /myapp  http://localhost:8081/myapp
   1

   这告诉 Apache 将形如 http://localhost/myapp/* 的 URL 转发到端口 8081 上侦听的 Tomcat 连接器。

4. 配置您的 Tomcat 副本以包含一个特殊的 元素，并具有适当的代理设置，例如：

   1
   2

   这将导致此 Web 应用程序中的 Servlet 认为所有代理请求都是发往 www.mycompany.com 的端口 80。

可以省略 元素中的 proxyName 属性。如果您这样做，则 request.getServerName() 返回 Tomcat 正在运行的主机名。在上面的示例中，它将是 localhost。

如果您还有一个 侦听端口 8080（嵌套在同一个 Service 元素中），则对任一端口的请求将共享相同的虚拟主机和 Web 应用程序。

您可能希望使用操作系统的 IP 过滤功能来限制对端口 8081（在此示例中）的连接，只允许来自运行 Apache 的服务器。

或者，您可以设置一系列仅通过代理访问的 Web 应用程序，如下所示：

1. 配置另一个只包含代理端口 的 。

2. 为通过代理访问的虚拟主机和 Web 应用程序配置适当的 Engine、Host 和 Context 元素。

3. 可选地，像前面描述的那样使用 IP 过滤器保护端口 8081。

通过 Apache 代理时，Web 服务器将在其访问日志中记录这些请求。因此，您通常希望禁用 Tomcat 本身执行的任何访问日志记录。

以这种方式代理请求时，所有针对配置的 Web 应用程序的请求都将由 Tomcat 处理（包括针对静态内容的请求）。您可以通过使用 mod_jk Web 连接器而不是 mod_proxy 来提高性能。

mod_jk 可以配置为使 Web 服务器提供未在 Web 应用程序的部署描述符 (/WEB-INF/web.xml) 中定义的过滤器或安全约束处理的静态内容。

参考资料

https://tomcat.apache.org/tomcat-11.0-doc/proxy-howto.html