如何在Ubuntu上安装Tomcat管理插件

在 Ubuntu 上安装 Tomcat 管理插件

一 适用场景与准备

• 管理插件通常指 Tomcat 自带的 Manager App（部署/启停应用）和 Host Manager（虚拟主机管理）。在 Ubuntu 16.04/18.04/20.04/22.04 上，使用 apt 安装的 Tomcat 8/9 可直接安装对应管理包；若使用官方压缩包安装，通常已内置管理应用，仅需配置用户与访问权限。安装前确认已安装 OpenJDK 并能访问 8080 端口。

二 使用 apt 安装 Tomcat 管理组件

• 安装命令（以 Tomcat 9 为例，按需替换版本）：
  • 安装核心与可选组件：sudo apt-get install tomcat9 tomcat9-admin tomcat9-docs tomcat9-examples
  • 安装完成后可用：sudo systemctl start|stop|status|restart tomcat9 管理服务
• 配置文件与目录（apt 安装常见路径）：
  • 用户与角色：/etc/tomcat9/tomcat-users.xml
  • 服务与环境：/etc/default/tomcat9
  • 部署目录：/var/lib/tomcat9/webapps/
  • 日志目录：/var/log/tomcat9/
• 访问地址（安装成功且防火墙放行后）：
  • 主页：http://localhost:8080/
  • 管理页：http://localhost:8080/manager/html（Manager App）
  • 主机管理：http://localhost:8080/host-manager/html（Host Manager）

三 配置管理用户与访问权限

• 编辑 /etc/tomcat9/tomcat-users.xml，在 之前添加用户与角色（示例为同时启用 Manager 与 Host Manager）：
  • 建议仅授予必要权限，生产环境避免使用弱口令
  • 示例：

    <role rolename="manager-gui"/>
    <role rolename="admin-gui"/>
    <user username="admin" password="StrongPassw0rd!" roles="manager-gui,admin-gui"/>
    

• 若仍无法访问管理页，检查 /var/lib/tomcat9/webapps/manager/META-INF/context.xml 与 /var/lib/tomcat9/webapps/host-manager/META-INF/context.xml 中的 RemoteAddrValve 配置。默认仅允许 127.0.0.1 访问，可按需放宽（示例允许内网 192.168.1.0/24）：

  <Context>
    <Valve className="org.apache.catalina.valves.RemoteAddrValve"
           allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1|192\.168\.1\.\d+"/>
  </Context>
  

• 保存后重启：sudo systemctl restart tomcat9。

四 使用官方压缩包安装时的处理

• 若你是下载并解压 apache-tomcat-9.x.y.tar.gz 的方式安装，通常 webapps 目录下已包含 manager 与 host-manager 应用，无需额外安装“插件”，直接按上文配置 tomcat-users.xml 与 context.xml 的访问限制即可。

五 常见问题与排查

• 访问被拒绝或 403：确认 tomcat-users.xml 中已为用户分配 manager-gui/admin-gui 角色，且 context.xml 的 RemoteAddrValve 允许你的来源 IP。
• 页面 404：确认 manager 与 host-manager 目录存在于 webapps，且 Tomcat 已成功部署并启动（查看 /var/log/tomcat9/catalina.out）。
• 服务未启动：使用 sudo systemctl status tomcat9 查看报错，必要时检查 /etc/default/tomcat9 的 JAVA_HOME 与内存参数，或查看日志定位问题。