3.4 Tomcat 端口配置

3.4 Tomcat 端口配置

3.4 Tomcat 端口配置

端口是网络通信的基础，对于任何网络应用程序来说，端口配置都是至关重要的环节。Tomcat 作为流行的 Java Servlet 容器，其端口配置直接关系到 Web 应用的访问方式和安全性。本章节将深入探讨 Tomcat 的端口配置，帮助您理解和掌握如何根据实际需求配置 Tomcat 的端口。

3.4.1 理解 Tomcat 中的关键端口

Tomcat 作为一个 Web 服务器，主要涉及以下几个关键端口：

• HTTP Connector 端口 (默认 8080): 这是 Tomcat 最常用的端口，用于接收 HTTP 请求。用户通过浏览器访问 Web 应用时，默认情况下就是通过这个端口与 Tomcat 服务器建立连接。

• HTTPS Connector 端口 (默认 8443): 用于配置安全连接（HTTPS）。当需要通过加密方式传输数据时，就需要配置 HTTPS Connector，并指定一个端口（通常是 8443）。

• AJP Connector 端口 (默认 8009): AJP (Apache JServ Protocol) 端口用于与前端 Web 服务器（如 Apache HTTP Server 或 Nginx）集成。在生产环境中，通常会使用前端 Web 服务器来处理静态资源和负载均衡，并将动态请求转发给 Tomcat 处理。AJP Connector 就是 Tomcat 用于接收这些转发请求的端口。

• Shutdown 端口 (默认 8005): 这是一个用于优雅关闭 Tomcat 服务器的端口。Tomcat 监听这个端口上的特定命令（默认是 "SHUTDOWN"），接收到命令后会执行关闭操作。

理解这些端口的作用是进行有效配置的基础。下图使用 Mermaid graph TD 图展示了这些端口在 Tomcat 中的角色和关系：

图 3.4.1 Tomcat 关键端口角色示意图

3.4.2 Tomcat 端口配置的核心文件：server.xml

Tomcat 的端口配置主要在 server.xml 文件中进行。该文件位于 Tomcat 安装目录的 conf 文件夹下。server.xml 是 Tomcat 的核心配置文件，包含了服务器级别的大部分配置信息，包括服务 (Service)、连接器 (Connector)、引擎 (Engine)、主机 (Host) 和上下文 (Context) 等组件的配置。

要配置 Tomcat 的端口，我们需要关注 server.xml 文件中的 <Service> 和 <Connector> 元素。一个 <Service> 元素通常包含一个 <Engine> 和多个 <Connector>。 <Connector> 元素负责接收客户端请求，并将其传递给 <Service> 的 <Engine> 进行处理。

以下是一个典型的 server.xml 文件中 <Service> 部分的结构示例：

<Service name="Catalina">
  <Connector port="8080" protocol="HTTP/1.1"
             connectionTimeout="20000"
             redirectPort="8443" />
  <Connector port="8009" protocol="AJP/1.3"
             redirectPort="8443" />
  <Connector port="8005" protocol="org.apache.catalina.core.AprLifecycleListener"
             shutdown="SHUTDOWN" />
  <!-- Engine, Realm, Valve and Cluster definitions -->
  <Engine name="Catalina" defaultHost="localhost">
    <Realm className="org.apache.catalina.realm.LockOutRealm">
      <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
             resourceName="UserDatabase"/>
    </Realm>
    <Host name="localhost"  appBase="webapps"
          unpackWARs="true" autoDeploy="true">
      <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
             prefix="localhost_access_log" suffix=".txt"
             pattern="%h %l %u %t &quot;%r&quot; %s %b" />
    </Host>
  </Engine>
</Service>
​

在这个示例中，我们可以看到三个 <Connector> 元素，分别配置了 HTTP Connector (端口 8080)、AJP Connector (端口 8009) 和 Shutdown Connector (端口 8005)。

3.4.3 配置 HTTP Connector 端口

HTTP Connector 是最常用的连接器，用于处理标准的 HTTP 请求。 要配置 HTTP Connector 的端口，我们需要修改 server.xml 中 HTTP Connector 的 <Connector> 元素的 port 属性。

代码实践 3.4.3.1：修改 HTTP Connector 端口

假设我们需要将 HTTP Connector 的端口从默认的 8080 修改为 80。 我们可以找到 server.xml 中配置 HTTP Connector 的 <Connector> 元素，并将其 port 属性值修改为 80。

修改前 (server.xml):

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />
​

修改后 (server.xml):

<Connector port="80" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />
​

内容详解：

• port="80": 将 HTTP Connector 监听的端口设置为 80。 80 端口是 HTTP 协议的默认端口。当用户在浏览器中输入域名或 IP 地址，且不指定端口号时，浏览器默认会访问 80 端口。 将 HTTP Connector 端口设置为 80，用户可以直接通过域名或 IP 地址访问 Web 应用，而无需在 URL 中显式指定端口号 (例如 http://yourdomain.com 而不是 http://yourdomain.com:8080)。

• protocol="HTTP/1.1": 指定连接器使用的协议为 HTTP/1.1。这是 HTTP 协议的一个版本。

• connectionTimeout="20000": 设置连接超时时间，单位是毫秒。 这里设置为 20000 毫秒 (20 秒)，表示服务器等待客户端完成连接的最大时间。

• redirectPort="8443": 指定重定向端口。当 HTTP Connector 接收到需要安全连接（例如，访问需要 HTTPS 的页面）的请求时，会将请求重定向到 redirectPort 指定的端口，通常指向 HTTPS Connector 的端口 (8443)。

重启 Tomcat 服务器后，HTTP Connector 将会监听 80 端口。

需要注意的是，如果将 HTTP 端口设置为 80，通常需要以 root 或具有特权的身份运行 Tomcat，因为 80 端口是特权端口（端口号小于 1024 的端口）。 在生产环境中，出于安全考虑，通常不建议直接以 root 身份运行 Tomcat。 更常见的做法是使用端口转发或反向代理的方式，将 80 端口的请求转发到 Tomcat 监听的非特权端口 (例如 8080)。

3.4.4 配置 HTTPS Connector 端口

HTTPS Connector 用于处理安全的 HTTPS 请求。配置 HTTPS Connector 除了需要指定端口外，还需要配置 SSL/TLS 证书，以启用加密连接。

代码实践 3.4.4.1：配置 HTTPS Connector 端口和 SSL

假设我们需要配置 HTTPS Connector 监听 443 端口（HTTPS 的默认端口），并启用 SSL/TLS。

修改后 (server.xml):

<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           maxThreads="150" SSLEnabled="true" scheme="https" secure="true"
           clientAuth="false" sslProtocol="TLS"
           keystoreFile="/path/to/your/keystore.jks" keystorePass="yourKeystorePassword" />
​

内容详解：

• port="443": 将 HTTPS Connector 监听的端口设置为 443。 443 端口是 HTTPS 协议的默认端口。

• protocol="org.apache.coyote.http11.Http11NioProtocol": 指定连接器使用的协议和实现。 org.apache.coyote.http11.Http11NioProtocol 是基于 NIO (Non-blocking I/O) 的 HTTP/1.1 连接器，性能较好。 也可以使用 org.apache.coyote.http11.Http11AprProtocol (基于 APR) 或 org.apache.coyote.http11.Http11BioProtocol (基于 BIO)，但通常 NIO 或 APR 性能更佳。

• SSLEnabled="true": 启用 SSL/TLS 加密。

• scheme="https": 设置 scheme 为 "https"，表示使用 HTTPS 协议。

• secure="true": 标记连接为安全连接。

• clientAuth="false": 是否需要客户端证书认证。设置为 "false" 表示不需要客户端证书认证，只进行服务器端证书认证。

• sslProtocol="TLS": 指定 SSL/TLS 协议版本。 "TLS" 表示使用 TLS 协议，通常使用最新的 TLS 版本。

• keystoreFile="/path/to/your/keystore.jks": 指定密钥库文件路径。 密钥库文件 (例如 .jks 或 .p12 文件) 存储了服务器的 SSL/TLS 证书和私钥。 你需要将 /path/to/your/keystore.jks 替换为实际的密钥库文件路径。

• keystorePass="yourKeystorePassword": 指定密钥库文件的密码。 你需要将 yourKeystorePassword 替换为实际的密钥库密码。

在配置 HTTPS Connector 之前，你需要先获取 SSL/TLS 证书。 通常可以从证书颁发机构 (CA) 购买证书，也可以使用自签名证书进行测试。 将证书导入到密钥库文件后，才能在 Tomcat 中配置 HTTPS Connector。

配置 redirectPort 属性非常重要。 在同时配置 HTTP 和 HTTPS Connector 时，通常将 HTTP Connector 的 redirectPort 指向 HTTPS Connector 的端口，这样当用户访问 HTTP 端口时，如果需要安全连接，Tomcat 会自动将请求重定向到 HTTPS 端口。

3.4.5 配置 AJP Connector 端口

AJP Connector 用于与前端 Web 服务器（如 Apache 或 Nginx）集成。 前端 Web 服务器通常监听 80 或 443 端口，并将动态请求通过 AJP 协议转发给 Tomcat 处理。

代码实践 3.4.5.1：配置 AJP Connector 端口

假设我们需要配置 AJP Connector 监听 8009 端口。 (默认端口通常已是 8009，如果需要修改，可以按照以下方式操作)

修改后 (server.xml):

<Connector port="8009" protocol="AJP/1.3"
           redirectPort="8443" />
​

内容详解：

• port="8009": 将 AJP Connector 监听的端口设置为 8009。 8009 是 AJP 协议的默认端口。

• protocol="AJP/1.3": 指定连接器使用的协议为 AJP/1.3。 AJP/1.3 是常用的 AJP 协议版本。

• redirectPort="8443": 与 HTTP Connector 类似，redirectPort 在 AJP Connector 中也有作用。 虽然 AJP 通常不直接处理重定向，但在某些情况下，如果需要将请求重定向到 HTTPS，仍然可以使用 redirectPort 指定 HTTPS Connector 的端口。

配置 AJP Connector 后，需要在前端 Web 服务器（例如 Apache 或 Nginx）中配置 AJP 代理，将匹配特定规则的请求转发到 Tomcat 的 AJP Connector 端口。

下图使用 Mermaid graph TD 图展示了前端 Web 服务器和 Tomcat 通过 AJP Connector 协同工作的场景：

图 3.4.5 前端 Web 服务器与 Tomcat AJP 集成示意图

3.4.6 配置 Shutdown 端口

Shutdown 端口用于优雅地关闭 Tomcat 服务器。 Tomcat 监听这个端口上的特定命令，接收到命令后会执行关闭操作。

代码实践 3.4.6.1：配置 Shutdown 端口和命令

假设我们需要将 Shutdown 端口修改为 8010，并将 Shutdown 命令修改为 "STOP_SERVER"。

修改后 (server.xml):

<Connector port="8010" protocol="org.apache.catalina.core.AprLifecycleListener"
           shutdown="STOP_SERVER" />
​

内容详解：

• port="8010": 将 Shutdown Connector 监听的端口设置为 8010。

• protocol="org.apache.catalina.core.AprLifecycleListener": Shutdown Connector 使用的协议。 org.apache.catalina.core.AprLifecycleListener 是一个特殊的协议，用于监听 Shutdown 命令。

• shutdown="STOP_SERVER": 指定 Shutdown 命令为 "STOP_SERVER"。 默认的 Shutdown 命令是 "SHUTDOWN"。 你可以修改为其他自定义的命令。

要关闭 Tomcat 服务器，需要通过 Telnet 或其他网络工具连接到 Shutdown 端口 (例如 8010)，并发送 Shutdown 命令 (例如 "STOP_SERVER")。 Tomcat 接收到命令后，会开始执行关闭操作，优雅地停止所有 Web 应用并退出。

出于安全考虑，Shutdown 端口应该只允许本地访问，或者通过防火墙进行限制，防止未经授权的远程关闭操作。

3.4.7 端口冲突与端口占用

在配置 Tomcat 端口时，需要注意端口冲突和端口占用问题。

• 端口冲突： 如果多个应用程序尝试使用同一个端口，就会发生端口冲突。 Tomcat 启动时，如果配置的端口已经被其他应用程序占用，Tomcat 将无法启动，并会报错。 例如，如果 8080 端口已经被其他 Web 服务器占用，Tomcat 的 HTTP Connector 将无法启动。

• 端口占用： 即使没有端口冲突，如果某个端口已经被其他进程占用，Tomcat 也无法使用该端口。 例如，如果另一个 Tomcat 实例已经占用了 8080 端口，新的 Tomcat 实例就无法再使用 8080 端口。

解决端口冲突和端口占用问题的方法：

1. 检查端口占用情况： 可以使用 netstat (Linux/macOS) 或 netstat -ano (Windows) 命令查看端口占用情况，找到占用端口的进程，并确定是否需要停止该进程或修改 Tomcat 的端口配置。

2. 修改 Tomcat 端口配置： 如果端口被占用，最直接的方法是修改 Tomcat 的 server.xml 文件，将冲突的端口修改为其他未被占用的端口。

3. 避免使用特权端口： 尽量避免将 HTTP 端口设置为 80，HTTPS 端口设置为 443，除非确实需要使用默认端口，并采取了相应的安全措施。 可以使用非特权端口 (端口号大于 1024) 作为 Tomcat 的监听端口，并通过端口转发或反向代理将请求转发到 Tomcat。

3.4.8 总结

关键要点回顾：

• server.xml 文件是 Tomcat 端口配置的核心文件。

• HTTP Connector (默认 8080) 用于处理 HTTP 请求。

• HTTPS Connector (默认 8443) 用于处理 HTTPS 请求，需要配置 SSL/TLS 证书。

• AJP Connector (默认 8009) 用于与前端 Web 服务器集成。

• Shutdown 端口 (默认 8005) 用于优雅关闭 Tomcat 服务器。

• 配置端口时需要注意端口冲突和端口占用问题。

掌握 Tomcat 端口配置是成为 Tomcat 技术专家的基础技能之一。 希望本章节的内容能够帮助您更好地理解和应用 Tomcat 端口配置。