Tomcat (arm64v8) Docker镜像文档

镜像概述与主要用途

本镜像为Tomcat官方镜像的arm64v8架构专用版本，基于Apache Tomcat构建。Apache Tomcat是开源的Web服务器和Servlet容器，实现Java Servlet和JavaServer Pages (JSP)规范，提供纯Java环境运行Java Web应用。

核心功能与特性

• 规范支持：完全实现Java Servlet和JSP规范，兼容Java Web应用开发标准
• 多线程处理：单进程多线程架构，高效处理并发HTTP请求
• 轻量级部署：精简镜像设计，降低资源占用，适合容器化环境
• 灵活配置：可通过环境变量和配置文件自定义Tomcat运行参数
• 多版本支持：提供Tomcat 9.0、10.1、11.0等稳定版本，适配JDK 8至25多种Java环境
• 架构优化：专为arm64v8架构构建，适配ARM服务器、嵌入式设备等平台

支持的标签与Dockerfile链接

Tomcat 11.0系列

Tomcat 10.1系列

Tomcat 9.0系列

完整标签列表参见官方仓库

使用场景与适用范围

• 开发环境：快速搭建本地Java Web应用测试环境，支持热部署
• 测试环境：自动化测试中部署Web应用，验证多JDK版本兼容性
• 生产环境：ARM架构服务器部署Java Web服务，如REST API、企业级应用
• 嵌入式场景：低功耗ARM设备（如树莓派）运行轻量级Web应用
• CI/CD流水线：作为构建阶段的运行环境，验证应用打包正确性

使用方法与配置说明

基本运行

启动默认Tomcat服务（端口8080，无默认Web应用）：

docker run -it --rm arm64v8/tomcat:9.0

端口映射

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

docker run -it --rm -p 8888:8080 arm64v8/tomcat:11.0

访问 http://localhost:8888 验证（默认返回404，需部署应用）。

环境变量

容器默认环境变量：

部署Web应用

方法1：挂载webapps目录

将本地Web应用（WAR包或解压目录）挂载到容器webapps：

docker run -it --rm -p 8080:8080 -v /local/path/to/webapp:/usr/local/tomcat/webapps/ROOT arm64v8/tomcat:10.1

方法2：使用webapps.dist中的示例应用

默认示例应用位于webapps.dist，可复制到webapps启用：

docker run -it --rm -p 8080:8080 arm64v8/tomcat:9.0 sh -c "cp -r webapps.dist/* webapps/ && catalina.sh run"

配置文件

配置文件路径：/usr/local/tomcat/conf/，包括：

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

配置manager-gui用户

编辑tomcat-users.xml添加管理员用户（用于访问/manager/html）：

<tomcat-users>
  <user username="admin" password="secret" roles="manager-gui,admin-gui"/>
</tomcat-users>

通过挂载配置文件应用修改：

docker run -it --rm -p 8080:8080 -v /local/tomcat-users.xml:/usr/local/tomcat/conf/tomcat-users.xml arm64v8/tomcat:11.0

Docker Compose示例

创建docker-compose.yml：

version: '3.8'
services:
  tomcat:
    image: arm64v8/tomcat:11.0-jdk21-temurin-noble
    ports:
      - "8080:8080"
    volumes:
      - ./webapps:/usr/local/tomcat/webapps
      - ./conf/tomcat-users.xml:/usr/local/tomcat/conf/tomcat-users.xml
    environment:
      - JAVA_OPTS=-Xms512m -Xmx1024m
    restart: unless-stopped

启动服务：

docker-compose up -d

维护与支持

• 维护者：Docker社区 (GitHub仓库)
• 获取帮助：
  • Docker Community Slack: [***]
  • Stack Overflow: 标签 docker 和 tomcat
  • Server Fault/Unix & Linux Stack Exchange
• 问题反馈：GitHub Issues

许可证

• Apache Tomcat：Apache License 2.0
• 基础镜像及依赖软件：可能包含其他许可证（如Debian组件的GPL、MIT等），详细信息见repo-info仓库

使用本镜像需遵守所有包含软件的许可证条款。