- 下载Tomcat
- 访问官网:
前往Apache Tomcat官网,选择稳定版本(如Tomcat 10或9)。 - 选择安装包:
Windows:下载 .zip 压缩包(如 apache-tomcat- 10.0.27.zip)。
Linux:下载 .tar.gz 压缩包(如 apache-tomcat-10.0.27.tar.gz)。
- 访问官网:
- 安装JDK(前提条件)
Tomcat依赖Java环境,需提前安装JDK 8或更高版本。
1. 验证JDK安装:
java -version # 检查Java版本
2. 设置 JAVA_HOME 环境变量:
Windows:
# 系统环境变量中添加:JAVA_HOME = C:\Program Files\Java\jdk1.8.0_301
Linux:
# 将以上内容添加到 ~/.bashrc 或 ~/.profile :export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
- 安装Tomcat
Windows:
1. 解压文件:
将下载的 .zip 文件解压到目标目录(如 C:\apache-tomcat-10.0.27)。
2. 配置环境变量(可选):
添加系统环境变量 CATALINA_HOME,值为Tomcat根目录(如 C:\apache-tomcat-10.0.27)。
3. 启动Tomcat:
进入 bin 目录,双击 startup.bat。
访问 http://localhost:8080,若看到Tomcat欢迎页,表示启动成功。
4. 停止Tomcat:
双击 shutdown.bat。
Linux:- 解压文件:
bash tar -zxvf apache-tomcat-10.0.27.tar.gz -C /opt
- 配置环境变量(可选):
export CATALINA_HOME=/opt/apache-tomcat-10.0.27 # 将以上内容添加到 ~/.bashrc 或 ~/.profile source ~/.bashrc 使配置生效
- 启动Tomcat:
cd $CATALINA_HOME/bin./startup.sh
- 验证启动:
curl http://localhost:8080 # 或浏览器访问
- 停止Tomcat:
./shutdown.sh
- 解压文件:
4.基础配置
修改默认端口(可选):
1. 打开conf/server.xml
2. 找到 <Connector port=“8080” …>,修改 port 值(如 8080 → 8888)。
<Connector port="8888" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
配置管理员用户:
1. 打开 conf/tomcat-users.xml。
2.添加角色和用户(用于访问管理界面):
<role rolename="manager-gui"/>
<role rolename="admin-gui"/>
<user username="admin" password="admin123"
roles="manager-gui,admin-gui"/>
3.重启Tomcat使配置生效。
- 部署Web应用
方式1:直接复制WAR包
1. 将WAR文件(如 myapp.war)放入 webapps 目录。
2. Tomcat会自动解压并部署,访问路径http://localhost:8080/myapp
方式2:通过管理界面(Manager App)
1. 访问 http://localhost:8080/manager/html,使用配置的用户名密码 登录。
2. 上传WAR文件并部署。 - 配置HTTPS(SSL)
1. 生成密钥库:
keytool -genkey -alias tomcat -keyalg RSA -keystore keystore.jks# 输入密码(如 changeit)和基本信息
2. 修改 server.xml:
#找到以下内容并取消注释,配置密钥库路径和密码:
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="150" SSLEnabled="true">
<SSLHostConfig>
<Certificate certificateKeystoreFile="conf/keystore.jks"
certificateKeystorePassword="changeit"
type="RSA" />
</SSLHostConfig>
</Connector>
3. 重启Tomcat,访问 https://localhost:8443。
- 常见问题解决
端口冲突- 检查端口占用:
netstat -ano | findstr :8080 # Windows
lsof -i :8080 # Linux
- 修改 server.xml 中的端口号。
应用部署失败:
1. 检查 logs/catalina.out 中的错误日志。
2. 确保WAR文件无损坏,且 webapps 目录有写入权限。
内存不足:
调整JVM参数(编辑 bin/catalina.sh 或 catalina.bat):
# 在文件开头添加:
export JAVA_OPTS="-Xms512m -Xmx1024m -XX:MaxMetaspaceSize=256m"
- 安全建议
- 禁用管理界面(生产环境):
删除 webapps 目录下的 manager 和 host-manager 文件夹。 - 限制访问权限:
在 conf/server.xml 中配置IP白名单。 - 定期更新:
关注Tomcat安全公告,及时升级版本。
- 禁用管理界面(生产环境):