apachectl (Apache Control) 是 Apache HTTP Server 隨附的控制腳本,提供統一介面管理 httpd 守護進程。它有兩種運作模式:
httpd 二進制,傳遞參數,設定環境變數 (LD_LIBRARY_PATH 等)。start, stop, restart...) 轉換為信號發送給 httpd。注意:非所有 Linux 發行版都包含 apachectl (如 Debian/Ubuntu 預設用 systemctl 或 apache2ctl),但原始碼編譯安裝、RHEL/CentOS 系列通常內建。
apachectl [configtest|fullstatus|graceful|help|restart|start|status|stop]
| 參數 | 動作 | 對應信號/行為 | 適用場景 |
|---|---|---|---|
start | 啟動 httpd | 若未運行則啟動 | 開機、手動啟動 |
stop | 立即停止 | 發送 SIGTERM,強制結束所有連線 | 緊急停機、維護窗口 |
restart | 重新啟動 | 等同 stop 後 start,中斷現有連線 | 配置修改後生效 |
graceful | 優雅重啟 | 發送 SIGUSR1,等待現有請求完成後重載配置,不中斷連線 | 生產環境熱部署、配置更新 |
graceful-stop | 優雅停止 | 發送 SIGWINCH,停止接受新連線,等待現有完成 | 計畫性下線、藍綠部署切換 |
configtest | 語法檢查 | 執行 httpd -t,驗證 httpd.conf 語法 | 每次修改配置後必跑 |
status | 顯示摘要狀態 | 需載入 mod_status,顯示簡要分數 | 快速健康檢查 |
fullstatus | 顯示完整狀態 | 需 mod_status + ExtendedStatus On | 深度監控、效能分析 |
help | 顯示幫助 | 列出所有參數 | 忘記參數時 |
# 環境變數覆蓋
HTTPD=/usr/local/apache2/bin/httpd
APACHE_CONFDIR=/etc/apache2
apachectl -f /custom/path/httpd.conf configtest
# 直接傳遞 httpd 參數 (前端模式)
apachectl -k start -D FOREGROUND -c "LogLevel debug"
| 參數 | 說明 |
|---|---|
-t | 配置檔語法測試 (同 configtest) |
-T | 測試但不檢查 DocumentRoot 存在性 |
-v | 顯示版本資訊 |
-V | 顯示編譯參數 (MPM、模組、路徑) |
-l | 列出編譯內建模組 |
-L | 列出指令定義 (允許的指令、參數、作用域) |
-S | 顯示虛擬主機解析結果 (極佳除錯工具) |
-X | 單程序前景模式 (除錯用) |
-D NAME | 定義 |
-c "directive" | 啟動前處理指令 |
-C "directive" | 讀取配置後處理指令 |
# 1. 語法檢查 (必做)
apachectl configtest
# 輸出:Syntax OK
# 2. 優雅重啟 (零停機)
apachectl graceful
apachectl -S
# 輸出虛擬主機名稱、埠口、DocumentRoot、配置檔行號
apachectl -t -D DUMP_MODULES
# 或
httpd -M
現代系統 (RHEL 7+, Ubuntu 16.04+) 推薦使用 systemctl:
systemctl start httpd # 啟動
systemctl stop httpd # 停止
systemctl restart httpd # 重啟
systemctl reload httpd # 優雅重載 (相當於 graceful)
systemctl status httpd # 狀態
systemctl enable httpd # 開機自啟
journalctl -u httpd -f # 即時日誌
apachectl graceful仍可用,但systemctl reload更符合現代服務管理規範。
| 現象 | 可能原因 | 排查指令 |
|---|---|---|
| apachectl: command not found | 未安裝 / 路徑不在 PATH | which apachectl、find / -name apachectl、yum provides apachectl |
| configtest 通過但 start 失敗 | 埠口佔用、權限、SELinux、模組缺失 | ss -tlnp | grep :80, journalctl -u httpd, audit2why |
| graceful 後配置未生效 | 模組不支援優雅重載、語法錯誤未被偵測 | apachectl configtest、檢查錯誤日誌、改用 restart |
| status/fullstatus 顯示 404 | 未載入 mod_status 或 Location 未設定 | 檢查 LoadModule status_module、<Location /server-status> |
熟練掌握 apachectl 的各種模式與參數,配合 configtest 守護配置品質、graceful 實現零停機部署、-S 除錯虛擬主機,是 Linux 系統管理員與 DevOps 工程師的必備技能。在 systemd 普及的今天,理解其與 systemctl 的對應關係,更能遊刃有餘地管理 Apache 服務。