Tomcat Docker镜像文档

镜像概述和主要用途

本镜像是Tomcat官方镜像的amd64架构专用仓库，Apache Tomcat（简称Tomcat）是由Apache软件基金会开发的开源Web服务器和Servlet容器。它实现了Java Servlet和JavaServer Pages（JSP）规范，提供纯Java环境用于运行Java Web应用程序。在简单配置下，Tomcat以单进程模式运行，通过Java虚拟机（JVM）处理HTTP请求，每个请求由独立线程处理。

核心功能和特性

• 规范支持：实现Java Servlet和JSP规范，兼容Java EE标准
• 纯Java环境：完全基于Java开发，具备跨平台运行能力
• 多线程处理：通过独立线程处理每个HTTP请求，支持高并发
• 可配置性：提供灵活的配置文件（如server.xml、web.xml），支持自定义服务器行为
• 轻量级架构：相比完整Java EE服务器更轻量，资源占用低
• 安全性：默认禁用示例Web应用，遵循上游安全建议
• 扩展性：支持多种连接器（HTTP、AJP等）和生命周期监听器

使用场景和适用范围

• Java Web应用部署：作为生产环境中的Java Web应用服务器，运行Servlet、JSP应用
• 开发测试环境：快速搭建本地开发环境，验证Web应用功能
• CI/CD流水线：集成到持续集成/部署流程，自动化测试和部署Java应用
• 微服务架构：作为微服务架构中的应用节点，处理HTTP请求
• 教学和演示：用于Java Web开发教学，展示Servlet和JSP技术实现

支持的标签及Dockerfile链接

Tomcat 11.x

Tomcat 10.x

Tomcat 9.x

标签说明：标签格式为[Tomcat版本]-[JDK/JRE版本]-[JVM提供商]-[基础镜像]，如11.0.13-jdk25-temurin-noble表示Tomcat 11.0.13、JDK 25、Temurin JVM、基于Ubuntu Noble。

详细使用方法和配置说明

基本运行

运行默认Tomcat服务器（使用catalina.sh run启动）：

docker run -it --rm amd64/tomcat:latest

端口映射

将容器的8080端口映射到主机的8888端口，便于外部访问：

docker run -it --rm -p 8888:8080 amd64/tomcat:9.0

访问http://localhost:8888或[***]即可访问Tomcat（默认无Web应用，会显示404页面）。

部署Web应用

通过挂载本地Web应用到容器的webapps目录部署应用：

docker run -it --rm -p 8080:8080 -v /path/to/your/webapp:/usr/local/tomcat/webapps/your-webapp amd64/tomcat:latest

注意：上游提供的示例Web应用默认未启用，位于容器内/usr/local/tomcat/webapps.dist目录，如需启用可复制到webapps目录：

docker run -it --rm -p 8080:8080 amd64/tomcat:latest bash -c "cp -r /usr/local/tomcat/webapps.dist/* /usr/local/tomcat/webapps/ && catalina.sh run"

Docker Compose部署

创建docker-compose.yml文件：

version: '3.8'
services:
  tomcat:
    image: amd64/tomcat:11.0-jdk21-temurin-noble
    container_name: tomcat-server
    ports:
      - "8080:8080"  # HTTP端口
      - "8009:8009"  # AJP端口（如需要）
    volumes:
      - ./webapps:/usr/local/tomcat/webapps  # 挂载Web应用目录
      - ./conf:/usr/local/tomcat/conf        # 挂载配置文件目录（可选）
      - tomcat-logs:/usr/local/tomcat/logs   # 挂载日志目录
    environment:
      - CATALINA_OPTS=-Xms512m -Xmx1024m     # JVM内存配置
      - TZ=Asia/Shanghai                     # 设置时区
    restart: unless-stopped

volumes:
  tomcat-logs:  # 持久化日志数据

启动服务：

docker-compose up -d

配置文件

Tomcat配置文件位于容器内/usr/local/tomcat/conf/目录，主要配置文件包括：

• server.xml：服务器核心配置（端口、连接器、引擎等）
• web.xml：Web应用默认配置
• tomcat-users.xml：用户认证配置
• context.xml：上下文配置

如需自定义配置，可通过挂载本地配置文件覆盖：

docker run -it --rm -p 8080:8080 -v /path/to/your/server.xml:/usr/local/tomcat/conf/server.xml amd64/tomcat:latest

添加管理用户

默认tomcat-users.xml中无用户配置，无法访问"/manager/html"管理页面。需编辑tomcat-users.xml添加用户：

<tomcat-users xmlns="[***]"
              xmlns:xsi="[***]"
              xsi:schemaLocation="[***] tomcat-users.xsd"
              version="1.0">
  <user username="admin" password="securepassword" roles="manager-gui,admin-gui"/>
</tomcat-users>

挂载修改后的配置文件启动：

docker run -it --rm -p 8080:8080 -v /path/to/your/tomcat-users.xml:/usr/local/tomcat/conf/tomcat-users.xml amd64/tomcat:latest

配置参数与环境变量

容器内