### Docker 中运行 Tomcat 镜像后无法访问网页并显示 404 的解决方案 当在 Docker 容器中部署 Tomcat 并遇到无法访问网页的情况时，通常是由以下几个原因引起的： #### 1. **Webapps 文件夹配置错误** 官方的 Tomcat 镜像可能包含两个 `webapps` 文件夹：一个是空的 `webapps` 文件夹，另一个是带有默认应用的 `webapps.dist` 文件夹。如果未正确处理这两个文件夹，则可能导致容器启动后找不到任何可用的应用程序。 解决方法如下： - 进入正在运行的容器内部： ```bash docker exec -it <container_id> /bin/bash ``` - 备份当前的 `webapps` 文件夹（如果是空的可以跳过此步）： ```bash mv webapps webapps-bak ``` - 将 `webapps.dist` 移动到 `webapps` 路径下： ```bash mv webapps.dist webapps ``` 通过以上操作，确保 `webapps` 文件夹中有实际的内容[^1]。 --- #### 2. **端口映射设置不正确** Tomcat 默认监听的是 8080 端口。如果在创建容器时没有正确绑定宿主机的端口到容器内的 8080 端口，也可能导致外部无法访问。 检查命令： ```bash docker ps --filter ancestor=tomcat ``` 确认是否有 `-p 8080:8080` 参数存在。如果没有，请重新启动容器并指定正确的端口映射参数： ```bash docker run -d -p 8080:8080 tomcat ``` --- #### 3. **Tomcat 主页未启用** 即使解决了 Webapps 文件夹的问题，默认情况下 Tomcat 可能不会自动加载主页内容。可以通过手动复制示例项目来验证是否正常工作。 进入容器后的路径 `/usr/local/tomcat/webapps/ROOT` 是用于存储根目录下的静态资源的地方。如果该位置为空，则会返回 404 错误。 修复方式： - 如果 `ROOT` 文件夹不存在或者为空，可以从其他地方下载简单的 HTML 页面放入其中作为测试。 - 或者直接保留原有的 `examples` 和 `manager` 应用以查看效果。 具体步骤： ```bash cd /usr/local/tomcat/webapps/ wget https://example.com/test.html -O index.html ``` --- #### 4. **权限问题** 某些情况下，由于 SELinux 设置或其他安全策略的影响，可能会阻止 Tomcat 正常读取其所需的文件或响应请求。此时需要调整相应的权限。 例如，在 Linux 上执行以下指令允许更广泛的网络连接尝试： ```bash setenforce 0 ``` 另外也可以考虑修改用户的组属性以及更改文件夹所有权至适当范围： ```bash chown -R tomcat:tomcat /usr/local/tomcat/webapps/* chmod u+xr /usr/local/tomcat/bin/catalina.sh ``` --- #### 5. **防火墙拦截流量** 最后一种可能性就是本地系统的防火墙规则阻碍了对外部服务的暴露。请核查 iptables 是否开放了目标端口号 (即 8080)，必要时添加例外项： ```bash iptables -A INPUT -p tcp --dport 8080 -j ACCEPT service iptables save ``` 完成这些排查之后再次刷新浏览器地址栏即可看到预期的结果[^2]。 --- ### 总结 综上所述，针对 Docker 中运行 Tomcat 镜像后出现的 404 错误现象，主要涉及到了几个方面的因素分析与对应措施实施。按照上述指导逐一排除潜在障碍应该能够顺利解决问题。