JBoss 5.1 安裝配置完整教學：JDK 環境、端口調整與日誌管理

JBoss AS 5.1.0.GA 企業級部署全流程指南

本文詳述 JBoss 5.1.0.GA (JDK6 版) 在 Windows 環境下的完整安裝、環境變數配置、啟動驗證、端口衝突解決、日誌與 Web 連接器配置等企業級部署全流程，適用於傳統 Java EE 專案遷移與維護場景。

第一階段：JDK 環境變數配置

1. JAVA_HOME：指向 JDK 安裝根目錄（如 C:\Java\jdk1.6.0）
2. CLASSPATH：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;
3. Path：在系統變數 Path 末尾追加 ;%JAVA_HOME%\bin

驗證： CMD 執行 java -version 與 javac -version 應正確顯示版本資訊。

第二階段：JBoss 安裝與環境變數

1. 下載：官方下載頁 取得 jboss-5.1.0.GA-jdk6.zip
2. 解壓至無空格路徑（如 D:\jboss-5.1.0.GA），避免空格路徑導致類載入異常
3. 新增系統變數 JBOSS_HOME = 解壓根目錄

第三階段：啟動驗證

cd %JBOSS_HOME%\bin
run.bat

成功標誌： 控制台輸出 Started in 1m:6s:110ms 且無異常堆疊。
訪問： https://localhost:8080 → JMX Console 進入管理主控台。

常見啟動失敗原因與解決

第四階段：核心配置調整

1. 日誌配置 (log4j)

編輯 %JBOSS_HOME%\server\default\conf\jboss-log4j.xml：

• 調整 DailyRollingFileAppender 輸出路徑（預設 server/default/log/server.log）
• 修改 Threshold 控制日誌級別 (DEBUG/INFO/WARN/ERROR)
• 配置 PatternLayout 統一日誌格式

2. Web 連接器端口修改

編輯 %JBOSS_HOME%\server\default\deploy\jbossweb.sar\server.xml：

<Connector port="8080" address="${jboss.bind.address}" 
    maxThreads="250" maxHttpHeaderSize="8192" 
    emptySessionPath="true" protocol="HTTP/1.1"
    enableLookups="false" redirectPort="8443"
    acceptCount="100" connectionTimeout="20000"
    disableUploadTimeout="true" />

將 port="8080" 改為所需端口（如 8088），重啟生效。同目錄下亦可配置 AJP、HTTPS 連接器。

生產環境部署建議

• 獨立使用者： 建立專用 jboss 系統使用者，限制目錄權限
• 服務化： 使用 JavaServiceWrapper 或 systemd (Linux) 註冊為系統服務
• JVM 調優： 編輯 run.conf.bat 設定 JAVA_OPTS="-Xms2g -Xmx4g -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m"
• 叢集模式： 啟用 all 或 ha profile，配置 partition-name 與多播地址
• 安全加固： 修改 JMX Console 預設帳密、啟用 HTTPS、關閉不必要的管理端口

遵循本指南可快速完成 JBoss 5.1 從開發環境到生產環境的標準化部署，解決端口衝突、日誌管理、JVM 調優等常見運維痛點，為傳統 Java EE 應用提供穩定可靠的運行基座。