tomcat安装及配置教程

以下是 **Tomcat 安装及配置的详细教程**，适用于 **Windows** 和 **Linux** 系统，并涵盖常见问题的解决方案。

---

## **1. 下载 Tomcat**
- **官网下载**：[Apache Tomcat 官网](https://tomcat.apache.org/)  
- **选择版本**：
  - **Tomcat 9**（适用于 JDK 8+）  
  - **Tomcat 10**（适用于 JDK 11+）  
- **下载格式**：
  - **Windows**：`.zip` 或 `.exe`（推荐 `.zip`，无需安装）  
  - **Linux**：`.tar.gz`  

---

## **2. 安装 Tomcat**
### **Windows 系统**
1. **解压安装**：
   - 将 `.zip` 文件解压到目标目录（如 `C:\Tomcat`），**避免中文路径** 。
2. **配置环境变量（可选）**：
   - **`CATALINA_HOME`**：指向 Tomcat 安装目录（如 `C:\Tomcat\apache-tomcat-9.0.xx`）。
   - **`Path`**：添加 `%CATALINA_HOME%\bin`。

### **Linux 系统**
1. **解压安装**：
   ```bash
   tar -xzvf apache-tomcat-9.0.xx.tar.gz
   mv apache-tomcat-9.0.xx /usr/local/tomcat
   ```
2. **配置环境变量**：
   ```bash
   export CATALINA_HOME=/usr/local/tomcat
   export PATH=$PATH:$CATALINA_HOME/bin
   ```
   并运行 `source ~/.bashrc` 使配置生效。

---

## **3. 启动 Tomcat**
### **Windows**
- **方法 1**：进入 `bin` 目录，双击 `startup.bat`。
- **方法 2**（配置环境变量后）：在任意目录运行 `startup`。

### **Linux**
```bash
cd /usr/local/tomcat/bin
./startup.sh
```

### **验证是否启动成功**
- 浏览器访问 `http://localhost:8080`，若出现 Tomcat 欢迎页，则成功。

---

## **4. 常见问题及解决**
### **1. 启动闪退**
- **原因**：
  - **JDK 未正确安装**：确保 `JAVA_HOME` 指向 JDK（非 JRE）。
  - **端口 8080 被占用**：
    - **检查占用**：`netstat -ano | findstr 8080`（Windows）或 `netstat -tulnp | grep 8080`（Linux）。
    - **解决方案**：
      - **修改端口**：编辑 `conf/server.xml`，更改 `<Connector port="8080">`。
      - **结束占用进程**：`taskkill /PID <进程ID> /F`（Windows）或 `kill -9 <进程ID>`（Linux）。

### **2. 乱码问题**
- **解决方法**：
  - 修改 `conf/logging.properties`，设置：
    ```properties
    java.util.logging.ConsoleHandler.encoding = GBK
    ```
  。

### **3. 无法访问 Manager App**
- **解决方法**：
  - 编辑 `conf/tomcat-users.xml`，添加管理员权限：
    ```xml
    <role rolename="manager-gui"/>
    <user username="admin" password="admin123" roles="manager-gui"/>
    ```
  。

---

## **5. 进阶配置**
### **1. 修改默认端口**
- 编辑 `conf/server.xml`，更改 `<Connector port="8080">` 为其他端口（如 `8081`）。

### **2. 设置开机自启（Linux）**
```bash
vim /etc/systemd/system/tomcat.service
```
添加：
```ini
[Unit]
Description=Apache Tomcat
After=network.target

[Service]
Type=forking
ExecStart=/usr/local/tomcat/bin/startup.sh
ExecStop=/usr/local/tomcat/bin/shutdown.sh
User=tomcat
Group=tomcat
Restart=always

[Install]
WantedBy=multi-user.target
```
然后运行：
```bash
systemctl enable tomcat
systemctl start tomcat
```
。

---

## **总结**
- **安装**：下载 `.zip`/`.tar.gz`，解压到目标目录。
- **配置**：设置 `CATALINA_HOME`（可选），启动 `startup.bat`/`startup.sh`。
- **问题排查**：
  - **闪退** → 检查 `JAVA_HOME` 和端口占用。
  - **乱码** → 修改 `logging.properties`。
  - **Manager App 访问** → 配置 `tomcat-users.xml`。

如需更详细的配置（如 HTTPS、集群部署），可参考官方文档或云服务器指南。