Debian上Tomcat虚拟主机怎么配置

Debian 上 Tomcat 虚拟主机配置指南

一前置准备

安装 Java 与 Tomcat（Debian 11/12 可直接使用包管理器安装 tomcat9；若手动安装，请准备 JDK 并创建专用系统用户）。
规划目录：为每个站点准备应用目录（如 /var/www/example.com 或 /opt/tomcat/webapps/example.com），并确保 tomcat 用户对其有读写权限。
网络与解析：开放防火墙的 8080/80/443 端口；将域名 example.com 的 A 记录指向服务器，或在测试环境写入 /etc/hosts。
可选：如需对外仅暴露 80/443，建议前置 Apache/Nginx 做反向代理或 AJP 连接。

二方案一仅用 Tomcat 的 Host 方式（直接 8080 端口）

编辑 server.xml（Debian 包安装通常为 /etc/tomcat9/server.xml；手动安装为 $CATALINA_HOME/conf/server.xml），在内新增：

<Host name="example.com" appBase="webapps/example"
      unpackWARs="true" autoDeploy="true">
  <Alias>www.example.com</Alias>
  <!-- 将 ROOT 应用指向外部目录 -->
  <Context path="" docBase="/var/www/example.com" reloadable="true"/>
</Host>

sudo mkdir -p /var/www/example.com
echo "<h1>Hello example.com</h1>" | sudo tee /var/www/example.com/index.html
sudo chown -R tomcat:tomcat /var/www/example.com
# 如需部署 WAR，放入：/opt/tomcat/webapps/example/

重启 Tomcat 并验证：

sudo systemctl restart tomcat9
# 访问：http://example.com:8080/

说明：每个域名对应一个 Host；如需多个站点，重复添加并使用不同 appBase/docBase。

三方案二 Apache 反向代理或 AJP 方式（端口 80/443）

安装组件并启用模块：

sudo apt update
sudo apt install tomcat9 apache2 libapache2-mod-jk
sudo a2enmod jk proxy proxy_http ssl

配置 workers.properties（常见路径：/etc/libapache2-mod-jk/workers.properties 或 /etc/apache2/workers.properties）：

worker.list=worker1
worker.worker1.type=ajp13
worker.worker1.host=localhost
worker.worker1.port=8009

配置 Apache 虚拟主机（启用 AJP 转发）：

<VirtualHost *:80>
  ServerName www.example.com
  JkMount /* worker1
  ErrorLog ${APACHE_LOG_DIR}/example_error.log
  CustomLog ${APACHE_LOG_DIR}/example_access.log combined
</VirtualHost>

启用站点并重启：

sudo a2ensite your-site.conf   # 文件名自定义
sudo systemctl restart apache2
# 访问：http://www.example.com/

如需 HTTPS，在 Apache 中启用 SSL 并配置证书（端口 443），保持 JkMount 规则不变。

四常见问题与排查

目录权限：确保 /var/www/example.com 或 appBase 目录属主为 tomcat:tomcat，否则会出现 403/404。
配置生效：修改 server.xml 后必须重启 Tomcat；修改 Apache 虚拟主机需执行 a2ensite 并重启 Apache。
端口连通：确认防火墙放行 8080/80/443；云服务器还需在安全组放行对应端口。
本地测试：在 /etc/hosts 添加 “127.0.0.1 example.com”，再用 curl 验证：

curl -I http://example.com:8080/
curl -I http://www.example.com/

日志定位：Tomcat 日志在 $CATALINA_HOME/logs/（如 catalina.out、localhost.log*）；Apache 日志在 /var/log/apache2/。
多站点建议：为每个站点使用独立的 Host/appBase，避免应用相互覆盖。

最新问答

相关标签