访问Tomcat的管理端

SE_Yang

2026-1-9

知道如何访问 Tomcat 的管理端（Manager App/Host Manager），核心是先配置访问权限、再通过浏览器访问指定地址，以下是完整的步骤、权限配置、访问方式和常见问题排查，适用于 Tomcat 8/9/10 主流版本（外置 Tomcat，Spring Boot 内嵌 Tomcat 无原生管理端）。

一、核心前提：配置管理端访问权限（必做）

Tomcat 管理端默认关闭匿名访问，需先配置有权限的用户，否则访问会提示 403 错误。

步骤 1：配置管理用户（修改 tomcat-users.xml）

打开 Tomcat 安装目录下的 conf/tomcat-users.xml 文件；
在 <tomcat-users> 标签内添加用户配置（按需赋予权限）：

xml

<tomcat-users xmlns="http://tomcat.apache.org/xml"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://tomcat.apache.org/xml tomcat-users.xsd"
              version="1.0">
    <!-- 核心：配置管理用户，至少包含 manager-gui 权限（访问 Manager App） -->
    <user username="admin"        <!-- 自定义用户名（如 tomcat_admin） -->
          password="123456"       <!-- 自定义密码（生产环境建议复杂密码） -->
          roles="manager-gui,admin-gui,host-manager-gui"/>  <!-- 权限组合 -->
</tomcat-users>

关键权限说明：

权限名称	作用
`manager-gui`	允许访问「Manager App」（核心，查看线程池、部署应用等）
`admin-gui`	允许访问「Host Manager」（管理虚拟主机）
`host-manager-gui`	等价于 `admin-gui`，Tomcat 9+ 推荐用此名称

步骤 2：解除 IP 访问限制（可选，允许远程访问）

Tomcat 默认仅允许本地 127.0.0.1/localhost 访问管理端，若需从远程服务器 / 其他电脑访问，需解除 IP 限制：

（1）解除 Manager App 的 IP 限制

打开 webapps/manager/META-INF/context.xml 文件，注释掉 IP 过滤的 Valve 标签：

xml

<!-- 注释以下内容，允许任意 IP 访问（生产环境可指定具体 IP，如 allow="192.168.1.*"） -->
<!--
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
       allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />
-->

（2）解除 Host Manager 的 IP 限制（如需）

打开 webapps/host-manager/META-INF/context.xml 文件，同样注释 IP 过滤标签：

xml

<!-- 注释 IP 限制 -->
<!--
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
       allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />
-->

步骤 3：重启 Tomcat 使配置生效

Windows：双击 bin/startup.bat 重启，或在服务中重启 Tomcat；

Linux/Mac：

bash

运行

# 进入 Tomcat 安装目录
cd /usr/local/tomcat
# 停止 Tomcat
./bin/shutdown.sh
# 启动 Tomcat
./bin/startup.sh

二、访问 Tomcat 管理端（两种核心入口）

方式 1：从 Tomcat 首页进入（最直观）

打开浏览器，访问 Tomcat 首页：http://[服务器IP]:[端口]

示例：
- 本地访问：http://localhost:8080；
- 远程访问：http://192.168.1.100:8080（替换为你的服务器 IP 和 Tomcat 端口）。
首页下方找到「Manager App」和「Host Manager」入口，点击「Manager App」：
弹出登录框，输入第一步配置的用户名（如 admin）和密码（如 123456），点击「Log in」即可进入管理端。

方式 2：直接访问管理端地址（快捷）

Manager App（核心，查看线程池 / 部署应用）：

http://[服务器IP]:[端口]/manager/html

示例：http://localhost:8080/manager/html
Host Manager（管理虚拟主机）：

http://[服务器IP]:[端口]/host-manager/html

示例：http://localhost:8080/host-manager/html

三、管理端核心功能（你可能用到的）

Thread Pool（线程池）：查看 maxThreads、acceptCount、当前活跃线程数等（验证参数配置的核心入口）；
Connector Status：查看 Connector 端口、IO 模型、连接数等；
Applications：部署 / 卸载 / 重启 Web 应用；
Server Status：查看 JVM 内存、CPU 使用率等；
Log Viewer：查看 Tomcat 日志（无需登录服务器）。

四、常见问题与排查

问题现象	原因	解决方案
访问管理端提示 403 Forbidden	1. 未配置 `manager-gui` 权限； 2. IP 限制未解除； 3. 用户名 / 密码错误	1. 确认 `roles` 包含 `manager-gui`； 2. 注释 `context.xml` 中的 IP 限制； 3. 核对用户名密码
访问地址提示 404 Not Found	1. Tomcat 未启动； 2. `webapps/manager` 目录被删除； 3. 端口错误	1. 检查 Tomcat 进程（`ps -ef	grep tomcat`）；<br>2. 重新解压 Tomcat 包恢复` manager` 目录； 3. 确认 Tomcat 端口（默认 8080，若修改需对应）
登录后页面空白 / 功能不全	1. 浏览器缓存问题； 2. Tomcat 版本过低； 3. 缺少依赖包	1. 清空浏览器缓存 / 换浏览器； 2. 升级到 Tomcat 8+； 3. 重新安装 Tomcat 避免文件缺失
生产环境无法访问	1. 服务器防火墙拦截端口； 2. 云服务器安全组未开放端口	1. 开放 Tomcat 端口（如 8080）：`firewall-cmd --add-port=8080/tcp --permanent`； 2. 云服务器（阿里云 / 腾讯云）在安全组中放行 8080 端口