Tomcat 9 如何根据访问方式条件化部署Web应用至根目录

要实现这个需求，核心是利用Tomcat的**虚拟主机（Virtual Host）**功能，或者结合Rewrite Valve根据请求的主机名（Host头）路由到不同应用。下面是两种最常用的实现方法，选一种适合你的即可：

方法一：配置虚拟主机（推荐，清晰易维护） #

这种方法通过在Tomcat中配置两个独立的虚拟主机，分别对应localhost和你的服务器IP，各自绑定不同的根应用。

步骤1：编辑Tomcat的server.xml配置文件 #

找到Tomcat安装目录下的conf/server.xml，用文本编辑器打开它。

步骤2：保留默认的localhost主机配置 #

默认的<Host>节点已经对应localhost，它会加载webapps目录下的默认应用（包括ROOT、manager等），不需要修改：

<Host name="localhost"  appBase="webapps"
      unpackWARs="true" autoDeploy="true">
  <!-- 原有配置（比如AccessLogValve等）保持不变 -->
  <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
         prefix="localhost_access_log" suffix=".txt"
         pattern="%h %l %u %t &quot;%r&quot; %s %b"/>
</Host>

步骤3：添加对应IP的虚拟主机 #

在<Engine>节点内部（和默认Host同级），添加一个新的<Host>节点，替换name属性为你的服务器IP（比如192.168.1.100），并配置根应用指向你的自定义项目：

<Host name="192.168.1.100"  appBase="custom_webapps"
      unpackWARs="true" autoDeploy="true">
  <!-- 将自定义应用设为该主机的根应用 -->
  <Context path="" docBase="/绝对路径/到/你的自定义应用" reloadable="true"/>
  
  <!-- 可选：添加访问日志，方便排查问题 -->
  <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
         prefix="192.168.1.100_access_log" suffix=".txt"
         pattern="%h %l %u %t &quot;%r&quot; %s %b"/>
</Host>

• appBase：可以指定一个单独的目录存放IP访问的应用（比如custom_webapps），避免和默认应用混在一起；如果你的自定义应用已经在webapps里，也可以把appBase设为webapps。
• docBase：填写你的自定义应用的绝对路径（或者相对于Tomcat安装目录的相对路径），确保Tomcat有读取权限。
• path=""：表示将该应用设为这个虚拟主机的根路径（访问http://你的IP直接打开它）。

步骤4：重启Tomcat #

保存配置后，重启Tomcat服务，新的虚拟主机配置就会生效。

方法二：使用Rewrite Valve（适合不想新增虚拟主机的场景） #

如果不想配置多个虚拟主机，可以利用Tomcat的Rewrite Valve，根据请求的Host头动态转发到不同的应用。

步骤1：启用Rewrite Valve #

编辑conf/server.xml，在默认的<Host>节点中添加Rewrite Valve：

<Host name="localhost"  appBase="webapps"
      unpackWARs="true" autoDeploy="true">
  <!-- 启用Rewrite Valve -->
  <Valve className="org.apache.catalina.valves.rewrite.RewriteValve"/>
  
  <!-- 原有配置保持不变 -->
  <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
         prefix="localhost_access_log" suffix=".txt"
         pattern="%h %l %u %t &quot;%r&quot; %s %b"/>
</Host>

步骤2：编写Rewrite规则 #

在conf/Catalina/localhost目录下创建rewrite.config文件（如果目录不存在，手动创建），添加以下规则：

# 匹配所有IP格式的请求Host（比如192.168.1.100）
RewriteCond %{HTTP_HOST} ^\d+\.\d+\.\d+\.\d+$
# 将根路径请求转发到自定义应用（替换custom-app为你的应用目录名）
RewriteRule ^/(.*)$ /custom-app/$1 [L]

• 如果你的自定义应用已经是ROOT，可以调整规则；或者如果只想匹配特定IP，把^\d+\.\d+\.\d+\.\d+$替换成你的具体IP（比如^192\.168\.1\.100$）。
• [L]表示这是最后一条规则，匹配后不再执行后续规则。

步骤3：重启Tomcat #

保存文件后重启Tomcat，规则即可生效。

测试验证 #

• 访问http://localhost：应该看到Tomcat默认的欢迎页面，包含manager、host-manager等链接。
• 访问http://你的服务器IP：应该直接打开你的自定义应用的首页。

注意事项 #

• 确保Tomcat对自定义应用的目录有读取权限，否则会出现404或权限错误。
• 如果你的服务器IP是动态的，方法一中的虚拟主机配置需要手动更新IP；方法二中的通配符规则可以自动匹配所有IP，但要注意不要影响其他合法域名的访问。
• 如果你使用的是Windows系统，路径分隔符用\或者转义的\\；Linux/macOS用/。

内容的提问来源于stack exchange，提问作者Ullas Hunka