在 Debian 上配置 JSP 运行环境

一 安装 Java 运行环境

• 更新索引并安装 OpenJDK（推荐 OpenJDK 11 LTS）：
  • sudo apt update
  • sudo apt install -y openjdk-11-jdk
• 验证安装：
  • java -version
  • javac -version
• 可选 配置 JAVA_HOME（便于后续组件识别）：
  • 编辑全局环境：echo ‘JAVA_HOME=“/usr/lib/jvm/java-11-openjdk-amd64”’ | sudo tee -a /etc/environment
  • 使配置生效：source /etc/environment
  • 验证：echo $JAVA_HOME
• 如需管理多版本 JDK，可使用 update-alternatives 切换默认 java/javac。

二 安装与运行 Tomcat

• 方式 A 使用系统仓库安装 Tomcat 9（最简）：
  • sudo apt install -y tomcat9 tomcat9-admin
  • sudo systemctl enable --now tomcat9
  • 默认管理后台：http://服务器IP:8080/manager/html（需在 /etc/tomcat9/tomcat-users.xml 配置角色如 manager-gui）
• 方式 B 手动安装二进制包（便于自定义目录与权限）：
  • 安装 wget：sudo apt install -y wget
  • 下载并解压（示例为 Tomcat 9.0.76）：
    • wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.76/bin/apache-tomcat-9.0.76.tar.gz
    • sudo tar -xzf apache-tomcat-9.0.76.tar.gz -C /opt
    • sudo mv /opt/apache-tomcat-9.0.76 /opt/tomcat
  • 创建专用用户与权限：
    • sudo groupadd --system tomcat
    • sudo useradd --system --gid tomcat --home /opt/tomcat --shell /usr/sbin/nologin tomcat
    • sudo chown -R tomcat:tomcat /opt/tomcat
    • sudo chmod +x /opt/tomcat/bin/*.sh
  • 创建 systemd 服务（/etc/systemd/system/tomcat.service）：
    • [Unit] Description=Apache Tomcat Web Application Container After=network.target
    • [Service] Type=forking User=tomcat Group=tomcat 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 Restart=on-failure
    • [Install] WantedBy=multi-user.target
  • 启动与开机自启：
    • sudo systemctl daemon-reload
    • sudo systemctl enable --now tomcat
• 访问测试：打开浏览器访问 http://服务器IP:8080，出现 Tomcat 欢迎页即表示运行正常。

三 部署与验证 JSP

• 快速验证：在 /opt/tomcat/webapps/ROOT/ 创建测试页 index.jsp
  • 内容：
    • <%@ page contentType=“text/html;charset=UTF-8” language=“java” %>

      Hello, JSP!

  • 访问：http://服务器IP:8080/index.jsp
• 部署应用：将项目打包为 WAR 并放入 webapps
  • sudo cp your-app.war /opt/tomcat/webapps/
  • Tomcat 会自动解压并部署，访问：http://服务器IP:8080/your-app。

四 防火墙与端口开放

• 如使用 UFW：
  • 放行 8080（Tomcat 默认）：sudo ufw allow 8080/tcp
  • 若配置了 Apache 与 Tomcat 联动或启用 HTTPS，按需放行 80/443
• 如使用 firewalld：
  • sudo firewall-cmd --permanent --add-port=8080/tcp && sudo firewall-cmd --reload

五 常见问题与优化

• 端口冲突：编辑 /opt/tomcat/conf/server.xml 中的 修改为未占用端口，重启 Tomcat 生效。
• 权限问题：确保 /opt/tomcat 及其子目录（尤其是 conf、logs、work、temp、webapps）属主为 tomcat:tomcat，且 conf 目录权限为 755。
• JVM 内存与启动参数：在 systemd 的 CATALINA_OPTS 中调整堆大小（如 -Xms512M -Xmx1024M），按需增加 -server、GC 策略等。
• 管理端访问：如需使用 /manager 与 /host-manager，在 /etc/tomcat9/tomcat-users.xml 配置用户与角色（manager-gui、admin-gui），并注意仅限内网或加固访问。
• 日志与排错：查看 /opt/tomcat/logs/catalina.out、localhost.log*，依据报错信息调整配置或权限。