Tomcat 移除專案名與端口號：直接用 IP 訪問配置詳解

目標

將 https://10.10.153.86:8080/projectName 簡化為 https://10.10.153.86/

步驟 1：修改端口 8080 → 80

編輯 $CATALINA_HOME/conf/server.xml

<!-- 修改前 -->
<Connector port="8080" protocol="HTTP/1.1"
    connectionTimeout="40000"
    redirectPort="8443" 
    enableLookups="false"
    minProcessors="10" maxProcessors="1024" acceptCount="1024" />

<!-- 修改後 -->
<Connector port="80" protocol="HTTP/1.1"
    connectionTimeout="40000"
    redirectPort="8443"
    enableLookups="false"
    minProcessors="10" maxProcessors="1024" acceptCount="1024" />

注意：Linux 端口 < 1024 需 root 權限，或用 `authbind`/`setcap` 提權

步驟 2：移除專案名稱 (配置 Root Context)

在同檔案 `` 標籤內新增：

<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">
    <!-- 新增：空路徑映射到專案 -->
    <Context path="" docBase="projectName" debug="0" reloadable="true"/>
    
    <Valve className="org.apache.catalina.valves.AccessLogValve" ... />
</Host>

關鍵屬性：

• path=""：根路徑 (空字串)
• docBase="projectName"：專案目錄名 (webapps 下) 或 WAR 檔名
• reloadable="true"：開發模式熱重載

步驟 3：清理工作目錄並重啟

# 清除編譯緩存
rm -rf $CATALINA_HOME/work/Catalina/localhost/*

# 重啟 Tomcat
$CATALINA_HOME/bin/shutdown.sh
$CATALINA_HOME/bin/startup.sh

驗證

curl https://10.10.153.86/
# 應直接返回專案首頁

替代方案對比

Nginx 反向代理配置範例 (生產推薦)

server {
    listen 80;
    server_name 10.10.153.86;
    
    location / {
        proxy_pass https://127.0.0.1:8080/projectName/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
    
    # 靜態資源直接由 Nginx 服務
    location /static/ {
        alias /opt/tomcat/webapps/projectName/static/;
        expires 30d;
    }
}

常見問題

1. 端口 80 權限不足：`setcap 'cap_net_bind_service=+ep' /path/to/java` 或用 Nginx 監聽 80 轉發 8080
2. 多專案衝突：只能有一個 `path=""`，其他專案需用 Nginx 路徑分發
3. 靜態資源 404：檢查 `docBase` 路徑、專案內 `webapp` 目錄結構
4. Session 丟失：Nginx 代理需配置 `proxy_cookie_path` 或 Tomcat `sessionCookiePath="/"`

總結

最簡單方式：修改 server.xml port=80 + Context path=""。生產環境建議：**Nginx 監聽 80/443 反向代理 Tomcat 8080**，實現靜態資源分離、多應用路由、SSL 終結、負載均衡等企業級功能。