Debian上Tomcat部署Web应用步骤是什么

在 Debian 上部署 Tomcat Web 应用的步骤

一 准备环境

• 安装 Java（推荐 OpenJDK 11）：
  • 执行：sudo apt update && sudo apt install -y openjdk-11-jdk
  • 验证：java -version
• 安装 Tomcat 9（两种常见方式，二选一）
  • 方式A 使用系统仓库安装（便于管理）：sudo apt install -y tomcat9 tomcat9-admin
  • 方式B 手动安装二进制包（便于多版本并存与自定义）：
    • 下载：wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.98/bin/apache-tomcat-9.0.98.tar.gz
    • 解压：sudo tar xf apache-tomcat-9.0.98.tar.gz -C /opt
    • 重命名：sudo mv /opt/apache-tomcat-9.0.98 /opt/tomcat9
• 创建专用系统用户（手动安装时强烈建议）：
  • sudo groupadd --system tomcat
  • sudo useradd -s /usr/sbin/nologin -g tomcat -d /opt/tomcat9 tomcat
  • 赋权：sudo chown -R tomcat:tomcat /opt/tomcat9 与 sudo chmod -R g+r /opt/tomcat9/conf

二 配置 Tomcat 服务与权限

• 方式A 系统服务（推荐，适用于仓库安装与手动安装）
  • 创建服务文件：sudo nano /etc/systemd/system/tomcat9.service
  • 示例内容（按需调整 JAVA_HOME 与路径）：

    [Unit]
    Description=Apache Tomcat 9
    After=network.target
    
    [Service]
    Type=forking
    User=tomcat
    Group=tomcat
    Environment="JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64"
    Environment="CATALINA_PID=/opt/tomcat9/temp/tomcat.pid"
    Environment="CATALINA_HOME=/opt/tomcat9"
    Environment="CATALINA_BASE=/opt/tomcat9"
    ExecStart=/opt/tomcat9/bin/startup.sh
    ExecStop=/opt/tomcat9/bin/shutdown.sh
    Restart=on-failure
    
    [Install]
    WantedBy=multi-user.target
    

  • 启用与启动：
    • sudo systemctl daemon-reload
    • sudo systemctl enable --now tomcat9
• 方式B 仓库包自带服务（若使用 apt install tomcat9）
  • 常用命令：
    • 启动/停止/重启：sudo systemctl start|stop|restart tomcat9
    • 开机自启：sudo systemctl enable tomcat9
• 防火墙放行（如启用 UFW）
  • sudo ufw allow 8080/tcp
• 管理界面用户（可选，便于使用 Manager）
  • 编辑：sudo nano /etc/tomcat9/tomcat-users.xml
  • 在 <tomcat-users> 内添加（请使用强密码）：

    <role rolename="manager-gui"/>
    <role rolename="admin-gui"/>
    <user username="admin" password="YourStrongPass" roles="manager-gui,admin-gui"/>
    

  • 重启服务：sudo systemctl restart tomcat9

三 部署 Web 应用

• 准备应用包
  • 使用构建工具生成 WAR：mvn clean package（产物在 target/xxx.war）
• 部署方式
  • 自动热部署（最简便）：将 WAR 复制到 webapps 目录
    • 仓库安装：sudo cp target/app.war /var/lib/tomcat9/webapps/
    • 手动安装：sudo cp target/app.war /opt/tomcat9/webapps/
    • Tomcat 会自动解压并部署，应用上下文路径通常为 /app
  • 管理控制台部署：访问 http://服务器IP:8080/manager/html，登录后上传 WAR 并部署
  • 指定应用路径（可选）：在 conf/server.xml 的 <Host> 内添加

    <Context docBase="/opt/tomcat9/webapps/app" path="/yourapp" reloadable="true"/>
    

    修改后重启 Tomcat
• 访问验证
  • 应用默认访问地址：http://服务器IP:8080/app（若使用 ROOT 部署则为根路径 /）

四 验证与常见问题

• 验证与日志
  • 访问应用首页或接口，确认返回正常
  • 查看日志定位问题：
    • 仓库安装：sudo tail -f /var/log/tomcat9/catalina.out
    • 手动安装：sudo tail -f /opt/tomcat9/logs/catalina.out
• 常见问题速查
  • 端口占用：检查 8080 是否被占用，必要时修改 conf/server.xml 的 <Connector port="8080">
  • 权限错误：确保 Tomcat 用户对 webapps、logs、work、temp、conf 等目录具备正确权限
  • 应用启动失败：优先查看 catalina.out 与应用的专有日志，核对数据库连接、JDK 版本与依赖冲突
  • 管理界面无法登录：核对 tomcat-users.xml 中角色与用户名密码是否正确并已重启服务

五 进阶与安全建议

• 运行用户与最小权限：生产环境使用专用 tomcat 用户，避免以 root 运行
• 内存与 GC 调优（在 systemd 服务或 setenv.sh 中设置 CATALINA_OPTS）
  • 示例：CATALINA_OPTS="-Xms512M -Xmx1024M -server -XX:+UseParallelGC"
• 启用 HTTPS（生产推荐）
  • 获取证书（如 Let’s Encrypt），在 conf/server.xml 配置 8443 连接器并指向证书，重启 Tomcat
• 访问控制：限制管理界面与敏感路径的访问来源 IP，使用强密码与定期轮换策略