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时出现的问题
这篇文章主要介绍了解决安装tomcat时出现的问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-02-02
Tomcat配置访问日志和线程数的实现步骤
本文主要介绍了Tomcat配置访问日志和线程数的实现步骤，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-05-05
Tomcat修正JDK原生线程池bug的实现原理
这篇文章主要介绍了Tomcat是如何修正JDK原生线程池bug的，本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
2021-08-08
tomcat多实例部署的项目实践
Tomcat多实例是指在一台设备上运行多个Tomcat服务,这些Tomcat相互独立,本文主要介绍了tomcat多实例部署的项目实践,具有一定的参考价值,感兴趣的可以了解一下
2025-03-03
Tomcat解决catalina.out文件过大的问题
本文主要介绍了Tomcat解决catalina.out文件过大的问题，文件过大，不仅占系统的存储，我们还将无法使用过常规的编辑工具进行查看，感兴趣的可以了解一下
2022-02-02
Tomcat接收UTF-8编码的GET参数请求的配置步骤
在Web开发中,处理不同编码的请求是一个常见的需求,特别是对于国际化的应用,确保服务器能够正确解析和响应UTF-8编码的GET请求至关重要,本文将详细介绍如何配置Tomcat以支持UTF-8编码的GET参数请求,需要的朋友可以参考下
2025-11-11
在同一台服务器上配置多个Tomcat的方法
本篇文章主要讲诉了在同一台服务器上配置多个Tomcat的方法，主要是解决端口冲突问题，有需要的可以了解一下。
2016-11-11
如何修改tomcat项目的图标(两种)
这篇文章主要介绍了修改tomcat项目图标的方法，一种形式是修改页面，另一种形式是修改webapps/root 图标，具体修改方法大家参考下本文
2018-03-03
Tomcat端口仅允许本地访问设置的两种方法
本文主要介绍了Tomcat端口仅允许本地访问设置的两种方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2025-05-05
tomcat+nginx实现多应用部署的示例代码
本文主要介绍了tomcat+nginx实现多应用部署的示例代码，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-11-11