✨ 博客简介Tomcat是Java Web开发最常用的轻量级服务器日常开发分为本地部署Windows开发调试和远程部署Linux云服务器线上上线两种场景。很多新手会混淆两种部署的配置差异、端口放行、项目上线流程。本文从零手把手教学分别讲解Windows本地Tomcat部署、Linux云服务器远程Tomcat部署包含环境配置、服务启动、项目部署、端口配置、常见报错解决全程实操可直接复刻适合入门学习和项目上线使用。 环境说明本地环境Windows 10/11 JDK1.8 Tomcat9.0通用稳定版远程环境阿里云/腾讯云Linux服务器CentOS7/8 JDK1.8 Tomcat9.0部署项目普通Java Web项目war包部署通用所有SSM/SpringBoot旧版Web项目一、前置必备JDK环境安装配置Tomcat运行依赖JDK环境必须提前配置本地和远程服务器都需要安装对应版本JDK推荐JDK1.8兼容性最强。1.1 Windows本地JDK配置安装JDK1.8安装路径建议纯英文无中文无空格如D:\Java\jdk1.8配置系统环境变量新增JAVA_HOME值为JDK安装根目录在Path变量中添加%JAVA_HOME%\binCMD输入java -version输出版本号即配置成功1.2 Linux远程服务器JDK配置CentOS服务器可直接yum安装简单高效yum install java-1.8.0-openjdk-devel -y # 验证版本 java -version二、Windows本地Tomcat部署开发调试专用本地部署核心用于项目本地调试、功能测试、开发预览无需配置防火墙、公网IP操作简单仅需本地环境配置。2.1 Tomcat下载与解压官网下载Tomcat9.0压缩包zip格式Apache Tomcat官网解压到纯英文路径禁止中文、空格、特殊字符推荐D:\Java\apache-tomcat-9.0无需安装解压即能用2.2 配置Tomcat环境变量可选推荐配置新增系统变量CATALINA_HOMETomcat解压根目录Path追加%CATALINA_HOME%\bin2.3 启动、关闭Tomcat服务进入Tomcatbin目录启动服务双击startup.bat黑窗口不闪退即为启动成功关闭服务双击shutdown.bat访问测试浏览器输入http://localhost:8080出现Tomcat官方欢迎页面说明本地部署成功。2.4 本地部署Java Web项目两种方式方式1自动部署最简单推荐新手将项目打包好的xxx.war文件直接复制到Tomcatwebapps目录重启Tomcat后服务器会自动解压war包、加载项目。访问地址http://localhost:8080/项目名方式2手动配置虚拟路径自定义项目路径修改conf/server.xml在Host标签内添加配置Context path/myweb docBaseD:\Java\webproject reloadabletrue crossContexttrue/path浏览器访问项目路径docBase本地项目真实存放路径reloadabletrue修改代码自动热部署无需重启服务2.5 本地部署常见问题启动窗口闪退JDK环境未配置、端口8080被占用、路径含中文端口占用解决修改conf/server.xml中8080端口为8081/8082三、Linux远程服务器Tomcat部署项目上线专用远程部署是将项目部署到云服务器公网环境实现外网访问供用户线上浏览使用相比本地部署多了服务器端口放行、防火墙配置、远程文件上传、开机自启等核心配置。3.1 上传并解压Tomcat安装包本地下载Tomcat9.0 tar.gz压缩包通过Xshell、FinalShell、rz命令上传到服务器推荐上传目录/usr/local/解压命令# 解压tomcat tar -zxvf apache-tomcat-9.0.tar.gz -C /usr/local/ # 重命名方便后续操作 mv /usr/local/apache-tomcat-9.0 /usr/local/tomcat93.2 服务器核心配置重中之重远程部署最大的坑启动成功但外网无法访问本质是防火墙和安全组未放行端口。3.2.1 防火墙放行8080端口# CentOS7 放行端口 firewall-cmd --permanent --add-port8080/tcp # 重启防火墙生效 firewall-cmd --reload # 查看已放行端口 firewall-cmd --list-ports3.2.2 云服务器安全组配置阿里云/腾讯云后台进入服务器安全组配置手动添加规则协议TCP端口8080授权对象0.0.0.0/0允许所有外网访问3.3 启动、停止、重启Tomcat# 启动 /usr/local/tomcat9/bin/startup.sh # 停止 /usr/local/tomcat9/bin/shutdown.sh # 查看运行日志排查报错 tail -f /usr/local/tomcat9/logs/catalina.out访问测试浏览器输入http://服务器公网IP:8080出现Tomcat首页即远程部署成功。3.4 远程部署Java Web项目方式1war包直接部署主流上线方式本地将项目打成war包通过rz/ftp工具上传到服务器Tomcatwebapps目录重启Tomcat服务自动解压部署项目外网访问http://公网IP:8080/项目名方式2Tomcat后台可视化部署适合频繁更新项目无需重启服务。配置管理员账号修改conf/tomcat-users.xml末尾添加role rolenamemanager-gui/ user usernameadmin password123456 rolesmanager-gui/重启Tomcat访问http://公网IP:8080/manager/html输入账号密码上传war包一键部署3.5 配置Tomcat开机自启服务器必备防止服务器重启后Tomcat服务失效配置开机自启# 创建服务文件 vim /etc/systemd/system/tomcat.service写入以下内容[Unit] DescriptionTomcat9 Server Afternetwork.target [Service] Typeforking EnvironmentJAVA_HOME/usr/lib/jvm/java-1.8.0-openjdk ExecStart/usr/local/tomcat9/bin/startup.sh ExecStop/usr/local/tomcat9/bin/shutdown.sh PrivateTmptrue [Install] WantedBymulti-user.target生效配置systemctl daemon-reload systemctl enable tomcat systemctl start tomcat四、本地部署 VS 远程部署 核心区别对比对比维度本地Tomcat部署远程Tomcat部署使用场景开发调试、代码测试、本地预览项目上线、外网访问、正式运营访问方式localhost/127.0.0.1仅本机访问公网IP/域名全网可访问端口配置无需放行防火墙仅本地端口不冲突即可必须放行服务器防火墙云平台安全组端口项目更新热部署、重启本地服务即可上传war包、后台部署、重启远程服务额外配置无复杂配置开机自启、权限配置、日志监控、安全配置 Tomcat本地部署+远程服务器部署超详细教程
✨ 博客简介Tomcat是Java Web开发最常用的轻量级服务器日常开发分为本地部署Windows开发调试和远程部署Linux云服务器线上上线两种场景。很多新手会混淆两种部署的配置差异、端口放行、项目上线流程。本文从零手把手教学分别讲解Windows本地Tomcat部署、Linux云服务器远程Tomcat部署包含环境配置、服务启动、项目部署、端口配置、常见报错解决全程实操可直接复刻适合入门学习和项目上线使用。 环境说明本地环境Windows 10/11 JDK1.8 Tomcat9.0通用稳定版远程环境阿里云/腾讯云Linux服务器CentOS7/8 JDK1.8 Tomcat9.0部署项目普通Java Web项目war包部署通用所有SSM/SpringBoot旧版Web项目一、前置必备JDK环境安装配置Tomcat运行依赖JDK环境必须提前配置本地和远程服务器都需要安装对应版本JDK推荐JDK1.8兼容性最强。1.1 Windows本地JDK配置安装JDK1.8安装路径建议纯英文无中文无空格如D:\Java\jdk1.8配置系统环境变量新增JAVA_HOME值为JDK安装根目录在Path变量中添加%JAVA_HOME%\binCMD输入java -version输出版本号即配置成功1.2 Linux远程服务器JDK配置CentOS服务器可直接yum安装简单高效yum install java-1.8.0-openjdk-devel -y # 验证版本 java -version二、Windows本地Tomcat部署开发调试专用本地部署核心用于项目本地调试、功能测试、开发预览无需配置防火墙、公网IP操作简单仅需本地环境配置。2.1 Tomcat下载与解压官网下载Tomcat9.0压缩包zip格式Apache Tomcat官网解压到纯英文路径禁止中文、空格、特殊字符推荐D:\Java\apache-tomcat-9.0无需安装解压即能用2.2 配置Tomcat环境变量可选推荐配置新增系统变量CATALINA_HOMETomcat解压根目录Path追加%CATALINA_HOME%\bin2.3 启动、关闭Tomcat服务进入Tomcatbin目录启动服务双击startup.bat黑窗口不闪退即为启动成功关闭服务双击shutdown.bat访问测试浏览器输入http://localhost:8080出现Tomcat官方欢迎页面说明本地部署成功。2.4 本地部署Java Web项目两种方式方式1自动部署最简单推荐新手将项目打包好的xxx.war文件直接复制到Tomcatwebapps目录重启Tomcat后服务器会自动解压war包、加载项目。访问地址http://localhost:8080/项目名方式2手动配置虚拟路径自定义项目路径修改conf/server.xml在Host标签内添加配置Context path/myweb docBaseD:\Java\webproject reloadabletrue crossContexttrue/path浏览器访问项目路径docBase本地项目真实存放路径reloadabletrue修改代码自动热部署无需重启服务2.5 本地部署常见问题启动窗口闪退JDK环境未配置、端口8080被占用、路径含中文端口占用解决修改conf/server.xml中8080端口为8081/8082三、Linux远程服务器Tomcat部署项目上线专用远程部署是将项目部署到云服务器公网环境实现外网访问供用户线上浏览使用相比本地部署多了服务器端口放行、防火墙配置、远程文件上传、开机自启等核心配置。3.1 上传并解压Tomcat安装包本地下载Tomcat9.0 tar.gz压缩包通过Xshell、FinalShell、rz命令上传到服务器推荐上传目录/usr/local/解压命令# 解压tomcat tar -zxvf apache-tomcat-9.0.tar.gz -C /usr/local/ # 重命名方便后续操作 mv /usr/local/apache-tomcat-9.0 /usr/local/tomcat93.2 服务器核心配置重中之重远程部署最大的坑启动成功但外网无法访问本质是防火墙和安全组未放行端口。3.2.1 防火墙放行8080端口# CentOS7 放行端口 firewall-cmd --permanent --add-port8080/tcp # 重启防火墙生效 firewall-cmd --reload # 查看已放行端口 firewall-cmd --list-ports3.2.2 云服务器安全组配置阿里云/腾讯云后台进入服务器安全组配置手动添加规则协议TCP端口8080授权对象0.0.0.0/0允许所有外网访问3.3 启动、停止、重启Tomcat# 启动 /usr/local/tomcat9/bin/startup.sh # 停止 /usr/local/tomcat9/bin/shutdown.sh # 查看运行日志排查报错 tail -f /usr/local/tomcat9/logs/catalina.out访问测试浏览器输入http://服务器公网IP:8080出现Tomcat首页即远程部署成功。3.4 远程部署Java Web项目方式1war包直接部署主流上线方式本地将项目打成war包通过rz/ftp工具上传到服务器Tomcatwebapps目录重启Tomcat服务自动解压部署项目外网访问http://公网IP:8080/项目名方式2Tomcat后台可视化部署适合频繁更新项目无需重启服务。配置管理员账号修改conf/tomcat-users.xml末尾添加role rolenamemanager-gui/ user usernameadmin password123456 rolesmanager-gui/重启Tomcat访问http://公网IP:8080/manager/html输入账号密码上传war包一键部署3.5 配置Tomcat开机自启服务器必备防止服务器重启后Tomcat服务失效配置开机自启# 创建服务文件 vim /etc/systemd/system/tomcat.service写入以下内容[Unit] DescriptionTomcat9 Server Afternetwork.target [Service] Typeforking EnvironmentJAVA_HOME/usr/lib/jvm/java-1.8.0-openjdk ExecStart/usr/local/tomcat9/bin/startup.sh ExecStop/usr/local/tomcat9/bin/shutdown.sh PrivateTmptrue [Install] WantedBymulti-user.target生效配置systemctl daemon-reload systemctl enable tomcat systemctl start tomcat四、本地部署 VS 远程部署 核心区别对比对比维度本地Tomcat部署远程Tomcat部署使用场景开发调试、代码测试、本地预览项目上线、外网访问、正式运营访问方式localhost/127.0.0.1仅本机访问公网IP/域名全网可访问端口配置无需放行防火墙仅本地端口不冲突即可必须放行服务器防火墙云平台安全组端口项目更新热部署、重启本地服务即可上传war包、后台部署、重启远程服务额外配置无复杂配置开机自启、权限配置、日志监控、安全配置