Tomcat 安装与常用配置方法

更新时间：2026年05月04日 09:11:40 作者：流星雨在线

Tomcat的下载、安装、启动、常用配置和常见问题解决方法,包括修改tomcat密码、修改端口号、文件共享等内容,本文给大家介绍Tomcat 安装与常用配置,感兴趣的朋友一起看看吧

一、下载与启动

下载 Tomcat
- 前往官网下载：https://tomcat.apache.org/download-10.cgi
- macOS 选择 tar.gz 或 zip 包。

添加执行权限
- 进入 Tomcat 的 bin 目录，执行：

chmod +x startup.sh
chmod +x shutdown.sh
chmod +x catalina.sh
# 或一键授权
chmod u+x *.sh

启动与关闭

cd /Users/你的用户名/Library/ApacheTomcat/bin
./startup.sh   # 启动
./shutdown.sh  # 关闭

二、常用配置

1. 修改tomcat密码

编辑 conf/tomcat-users.xml，在 <tomcat-users> 标签内添加：

<role rolename="manager"/>
<role rolename="manager-gui"/>
<role rolename="admin"/>
<role rolename="admin-gui"/>
<role rolename="manager-script"/>
<role rolename="manager-jmx"/>
<role rolename="manager-status"/>
<user username="admin" password="000000" roles="admin-gui,admin,manager-gui,manager,manager-script,manager-jmx,manager-status"/>

2. 修改端口号

编辑 conf/server.xml，找到以下配置修改端口：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           maxParameterCount="1000"
/>

三、常见问题解决

1. 安装tomcat权限报错403

报错类似：

By default the Manager is only accessible from a browser running on the same machine
403 Access Denied
You are not authorized to view this page.

解决：

编辑 webapps/manager/META-INF/context.xml，注释掉 RemoteAddrValve 限制：

<Context antiResourceLocking="false" privileged="true" >
  <CookieProcessor className="org.apache.tomcat.util.http.Rfc6265CookieProcessor"
                   sameSiteCookies="strict" />
  <!--
  <Valve className="org.apache.catalina.valves.RemoteAddrValve"
         allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />
  -->
  <Manager sessionAttributeValueClassNameFilter="xxx"/>
</Context>

修改后重启 Tomcat。

2. 静态资源不可访问报错

表现：直接访问 webapps/files/xxx 目录失败。

解决：编辑 conf/web.xml，找到 default servlet，将：

<init-param>
    <param-name>listings</param-name>
    <param-value>false</param-value>
</init-param>

<init-param>
    <param-name>listings</param-name>
    <param-value>true</param-value>
</init-param>

修改后无需重启即可生效。

3. 静态资源整体异常、无法访问

若整体静态资源访问异常，可直接替换一份正确的 conf/web.xml 配置文件。

四、Tomcat 文件共享

将文件放在 webapps/files/ 等目录下，访问 http://localhost:8080/files/ 失败，

解决方法同上：修改 conf/web.xml 中 listings 为 true 即可实现目录浏览。

到此这篇关于Tomcat 安装与常用配置方法的文章就介绍到这了,更多相关Tomcat 安装与配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

关于tomcat的server.xml里host节点配置的一些说明
今天在帮客户配置iis+tomcat实现jsp运行环境的时候发现的这个问题，一直没研究，今天正好参考了多篇文章发现并解决了问题，特分享下
2014-07-07
在Tomcat中配置404自定义错误页面详解
这篇文章主要介绍了在Tomcat中配置404自定义错误页面全解,需要的朋友可以参考下
2017-03-03
Tomcat安装与配置Native APR模式的教程
APR是Apache HTTP服务器的支持库，提供了一组映射到下层操作系统的API。通过 tomcat-native 库，使tomcat运行时通过APR更多的调用本地API，达到提升性能的目的。下面这篇文章详细介绍了Tomcat安装与配置Native APR模式的教程,需要的朋友可以参考借鉴，一起来看看吧。
2017-02-02
tomcat中Servlet对象池介绍及如何使用
这篇文章主要介绍了tomcat中Servlet对象池介绍及简单使用的相关资料,需要的朋友可以参考下
2016-12-12
tomcat的webapps和ROOT目录的区别及说明
这篇文章主要介绍了tomcat的webapps和ROOT目录的区别及说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-06-06
tomcat设置开机自启的几种方法(包含无service.bat文件设置)
工作中需要设置windows系统下的tomcat开机自启,本文主要介绍了tomcat设置开机自启的几种方法,包含正常安装版本tomcat和免安装tomcat(无service.bat)两种情况,具有一定的参考价值,感兴趣的可以了解一下
2024-06-06
tomcat优化配置小结
本文主要介绍了tomcat优化配置小结，介绍了十一个方面的优化问题，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-05-05
解决应用启动失败但tomcat不报错的方法
这篇文章主要给大家介绍了关于解决应用启动失败但tomcat不报错的方法，文中介绍的非常详细，对大家具有一定的参考学习价值，需要的朋友们下面来一起看看吧。
2017-06-06
新版Eclipse集成Tomcat时找不到server选项的解决方法
这篇文章主要给大家分享了新版Eclipse集成Tomcat时找不到server选项的解决方案,文章通过图文介绍讲解的非常详细,具有一定的参考价值,需要的朋友可以参考下
2023-10-10
解决tomcat启动 ssm项目出现乱码的问题
这篇文章主要介绍了tomcat启动 ssm项目出现乱码的解决,解决方式需要在tomcat 的配置文件web.xml 中添加上请求编码过滤器即可，详细过程跟随小编一起看看吧
2022-03-03