背景与适用场景

1panel 是一款轻量级、开源的服务器管理面板，支持快速部署多种运行环境。Tomcat 作为 Java 应用最常用的 Servlet 容器，常用于部署 JSP、Spring Boot 等 Web 应用。本文详细介绍在 1panel 面板中搭建并适配 Tomcat 站点环境的完整流程。

准备工作

• 已安装 1panel 面板（版本 ≥ 1.6.0）的 Linux 服务器（CentOS 7+ 或 Ubuntu 20.04+）
• 已绑定域名（可选，用于站点访问）
• 服务器开放 8080（Tomcat 默认端口）或自定义端口

第一步：在 1panel 中安装 Tomcat

1. 登录 1panel 面板，进入“应用商店”页面。

2. 在搜索框输入“Tomcat”，选择官方提供的 Tomcat 应用（如 Tomcat 9 或 Tomcat 10）。

3. 点击“安装”，根据需要设置以下参数：

• 版本：推荐 Tomcat 9（兼容 Java 8 / 11）
• 端口映射：保持默认 8080，或修改为自定义端口（如 8090）
• 数据目录：默认挂载到宿主机 /opt/1panel/apps/tomcat/数据目录，建议保持
• 内存限制：根据服务器内存设置，Java 应用建议 ≥ 512MB

4. 点击“确认”安装，等待容器启动完成。

第二步：校验 Tomcat 运行状态

安装完成后，进入“容器”管理页，确认 Tomcat 容器状态为“运行中”。访问 http://服务器IP:端口（如 http://192.168.1.100:8080），页面显示默认的 Tomcat 欢迎页面即表示安装成功。

第三步：创建站点并关联 Tomcat

1panel 的“站点”功能可自动配置反向代理，将域名或端口请求转发至 Tomcat 容器。

1. 进入“网站” → “站点”页面，点击“添加站点”。
2. 填写站点域名（如 tomcat.example.com），选择“反向代理”类型。
3. 目标 URL：填写 http://127.0.0.1:8080（Tomcat 容器内部监听端口）。
4. 其他设置保持默认，点击“确认”。
5. 系统会自动创建 Nginx 配置并重载生效。

此时通过绑定域名即可访问 Tomcat 应用。如需非 80/443 端口访问，可在站点设置中修改“监听端口”。

第四步：部署 Java 应用

1. 将待部署的 .war 文件上传至 Tomcat 数据目录下的 webapps 文件夹（通常位于 /opt/1panel/apps/tomcat/xxx/webapps）。

2. 重启 Tomcat 容器：在 1panel 容器管理页面，点击对应的 Tomcat 容器，选择“重启”。

3. 观察容器日志，确认应用部署成功。例如 Spring Boot 应用日志会显示 Started Application in xxx seconds。

4. 访问 http://域名/war包名 即可看到应用页面。若需要部署多个独立应用，建议分别放置到不同子目录，或使用不同虚拟主机。

第五步：配置 SSL（HTTPS）

通过 1panel 的站点证书功能可一键申请 Let's Encrypt 证书：

• 在站点设置 → “SSL” 中开启“自动证书”。
• 填写邮箱，选择域名，系统自动完成验证并配置。
• 若使用自定义证书，上传证书文件并指定密钥路径即可。

常见问题与适配注意

Q：Tomcat 容器无法启动，日志报端口冲突？
A：检查宿主机 8080 端口是否已被占用，可在安装时修改端口映射，或停止占用该端口的进程。

Q：文件上传后页面访问 404？
A：确认 .war 文件是否完整，重新上传并重启容器。同时检查 webapps 目录权限（建议保持 755）。

Q：如何修改 Tomcat 内存参数？
A：1panel 的应用安装参数中不直接提供 JVM 设置，可在宿主机对应应用的 docker-compose.yml 文件中增加 JAVA_OPTS 环境变量，之后重建容器。

Q：是否需要开启 Tomcat 管理界面？
A：生产环境不建议开启，如需远程管理请通过 SSH 或 1panel 的文件管理功能操作。

总结

通过 1panel 面板部署 Tomcat 环境，大幅简化了 Java 应用运行环境的搭建过程。结合反向代理、SSL 证书等功能，可快速实现安全、稳定的站点服务。建议定期检查容器日志与更新，确保环境稳定。