Debian Tomcat部署Web应用步骤

在 Debian 上部署 Tomcat Web 应用

一 准备环境

• 更新系统并安装 OpenJDK 11（或更高版本）：
  • 命令：sudo apt update && sudo apt install -y openjdk-11-jdk
  • 验证：java -version
• 创建专用系统用户（提升安全性，可选但推荐）：
  • 命令：sudo groupadd tomcat && sudo useradd -s /bin/false -g tomcat -d /opt/tomcat tomcat
• 说明：Tomcat 9 与 Java 8+ 兼容，本示例选用 OpenJDK 11。

二 安装与配置 Tomcat

• 下载并解压（示例为 Tomcat 9，建议选择最新稳定小版本）：
  • 命令：wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.56/bin/apache-tomcat-9.0.56.tar.gz
  • 解压：sudo tar xvf apache-tomcat-9.0.56.tar.gz -C /opt
  • 重命名：sudo mv /opt/apache-tomcat-9.0.56 /opt/tomcat
• 设置环境变量（推荐在 $CATALINA_HOME/bin/setenv.sh 中配置）：
  • 新建：sudo nano /opt/tomcat/bin/setenv.sh
  • 内容：
    • export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
    • export CATALINA_HOME=/opt/tomcat
• 目录权限（若创建了 tomcat 用户）：
  • 命令：sudo chown -R tomcat:tomcat /opt/tomcat
• 可选：修改 server.xml 以变更端口或添加 SSL/Connector 配置（默认 HTTP 端口为 8080）。

三 以 systemd 管理 Tomcat（推荐）

• 创建服务文件：sudo nano /etc/systemd/system/tomcat.service
• 示例内容（按需调整内存与路径）：

  • [Unit]
    Description=Apache Tomcat Web Application Container
    After=network.target
    
    [Service]
    Type=forking
    Environment=JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
    Environment=CATALINA_PID=/opt/tomcat/temp/tomcat.pid
    Environment=CATALINA_HOME=/opt/tomcat
    Environment=CATALINA_BASE=/opt/tomcat
    Environment='CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC'
    Environment='JAVA_OPTS=-Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom'
    ExecStart=/opt/tomcat/bin/startup.sh
    ExecStop=/opt/tomcat/bin/shutdown.sh
    User=tomcat
    Group=tomcat
    UMask=0007
    RestartSec=10
    Restart=always
    
    [Install]
    WantedBy=multi-user.target
    

• 启用与启动：
  • 命令：sudo systemctl daemon-reload && sudo systemctl start tomcat && sudo systemctl enable tomcat
  • 验证：sudo systemctl status tomcat 或 curl http://localhost:8080
• 说明：也可直接使用 $CATALINA_HOME/bin/startup.sh 与 shutdown.sh 脚本进行启停（适合测试）。

四 部署 Web 应用

• 方式一 自动部署（最常用）：
  • 将 WAR 包复制到：sudo cp your-app.war /opt/tomcat/webapps/
  • Tomcat 会自动解压并部署，访问：http://<服务器IP>:8080/your-app
• 方式二 Context 文件部署（外部目录或自定义路径）：
  • 在 $CATALINA_HOME/conf/Catalina/localhost/ 创建文件 myapp.xml：
    • 内容：<Context docBase="/path/to/your-app.war" reloadable="true"/>
  • 访问：http://<服务器IP>:8080/myapp
• 方式三 管理界面部署（需先配置用户）：
  • 编辑 $CATALINA_HOME/conf/tomcat-users.xml，添加角色与用户：

    • <tomcat-users>
        <role rolename="manager-gui"/>
        <user username="admin" password="StrongPass!2025" roles="manager-gui"/>
      </tomcat-users>
      

  • 重启后在浏览器访问：http://<服务器IP>:8080/manager/html 上传并部署 WAR。

五 网络与安全配置

• 防火墙放行（若启用 UFW）：sudo ufw allow 8080/tcp
• 生产建议：
  • 使用反向代理（如 Nginx/Apache HTTPD）终止 TLS，对外提供 443，Tomcat 仅监听本地或内网端口。
  • 配置强密码与最小权限的管理用户，谨慎开放 manager-gui。
  • 调整 JVM 参数（如 -Xms/-Xmx）、开启访问日志与 GC 日志，便于排障与容量规划。
• 常用运维命令：
  • 查看日志：tail -f /opt/tomcat/logs/catalina.out
  • 热部署：替换 webapps 下的 WAR 文件或更新 Catalina/localhost/*.xml 后自动生效（取决于 reloadable 设置）。