GoAccess 網頁報告帳號密碼保護設定指南
適用環境:AlmaLinux 10、Apache HTTP Server、Webmin / Virtualmin、GoAccess、WSL2
本文件整理 GoAccess 靜態 HTML 報表的產生方式,以及使用 Apache HTTP Basic Authentication 保護報表目錄的部署流程。
重要: 請先確認主機實際的 Virtualmin 版本、Apache 虛擬主機設定、Access Log 路徑、Linux 帳號與 SELinux 狀態。下列
YOUR_USER、example.com、日誌路徑均為範例,不能未經確認直接照抄。
1. 架構與安全原則
GoAccess 主要負責讀取 Web Server 日誌並產生統計報表。它不負責網站會員帳號管理。此處採用:
- GoAccess 定期產生靜態 HTML 報表。
- 報表放在 Virtualmin 網站的專用
report目錄。 - Apache 以 HTTP Basic Authentication 驗證使用者。
- 使用 HTTPS 保護瀏覽器與 Apache 之間的傳輸。
- Cron 或 systemd timer 負責更新報表。
1.1 Basic Authentication 不是報表加密
HTTP Basic Authentication 是存取驗證,不是 HTML 檔案加密。Basic Authentication 的憑證若透過未加密的 HTTP 傳輸,可能遭攔截,因此必須搭配 HTTPS/TLS。
1.2 靜態報表與即時報表不同
本指南以 GoAccess 靜態 HTML 報表為主。一般靜態報表不需要 GoAccess
WebSocket 服務,也不需要 --real-time-html。
若要使用即時報表,必須另外規劃 GoAccess WebSocket
監聽、反向代理、防火牆及 TLS;不能只加上 --real-time-html
就假設即時功能已完整部署。
2. 部署前檢查
2.1 確認 Apache 正在執行
sudo systemctl status httpd
sudo apachectl -t
預期設定檢查結果:
Syntax OK
2.2 確認 Virtualmin 虛擬主機與日誌設定
先列出 Apache 虛擬主機:
sudo httpd -S
再檢查 Apache 設定中與目標網域有關的
DocumentRoot、CustomLog、ErrorLog:
sudo grep -RniE 'ServerName|DocumentRoot|CustomLog|ErrorLog' \
/etc/httpd/conf /etc/httpd/conf.d
Virtualmin
的日誌位置會依版本、虛擬主機設定及系統配置而異。不要假設所有網站都使用
/var/log/httpd/access_log。
確認目標網站的實際 Access Log 後,設定變數,例如:
ACCESS_LOG="/實際/日誌/路徑/example.com_access_log"
檢查檔案是否存在及是否有資料:
sudo ls -l "$ACCESS_LOG"
sudo tail -n 5 "$ACCESS_LOG"
2.3 確認日誌格式
GoAccess 的 --log-format=COMBINED 適用於 Apache Combined Log
Format。先查看實際日誌內容:
sudo head -n 2 "$ACCESS_LOG"
如果 Apache 使用自訂 LogFormat,不能直接假設 COMBINED
一定吻合;應依實際欄位調整 GoAccess 的 --log-format、--date-format
及 --time-format。
3. 建立報表目錄
以下以 Virtualmin 網站帳號 YOUR_USER、網域 example.com 為例。
SITE_USER="YOUR_USER"
REPORT_DIR="/home/${SITE_USER}/public_html/report"
sudo install -d -o "$SITE_USER" -g "$SITE_USER" -m 0750 "$REPORT_DIR"
請先確認網站實際的 DocumentRoot。若不是
/home/YOUR_USER/public_html,請依實際路徑調整。
檢查目錄權限:
namei -l "$REPORT_DIR"
sudo ls -ld "$REPORT_DIR"
Apache
必須能夠穿越父目錄並讀取報表檔案。不要為了排除權限問題而直接對整個網站目錄執行
chmod -R 777。
4. 方法 A:透過 Virtualmin 圖形介面設定(優先考慮)
Virtualmin 不同版本或佈景主題的選單文字可能不同,以下為常見操作方向:
- 登入 Virtualmin。
- 選擇目標 Virtual Server。
- 進入 Web Configuration。
- 找到 Protected Directories。
- 新增受保護目錄。
- 目錄路徑指定為網站內的
/report。 - 設定 Authentication Realm,例如
GoAccess Report。 - 儲存後,依該版本介面新增允許登入的使用者,並確認該使用者具有此目錄的存取權限。
4.1 驗證圖形介面設定
使用瀏覽器開啟:
https://example.com/report/
預期應出現帳號密碼提示。輸入正確帳密後,才可以讀取報表。
若 Virtualmin 的介面選項與上述不同,請以該版本實際提供的 Protected Directories 說明為準;不要自行假設某個選單一定存在。
5. 方法 B:手動設定 Apache HTTP Basic Authentication
若希望直接管理 Apache 設定,可使用本節方法。方法 A 與方法 B 擇一即可,不要在 Virtualmin 與手動設定中重複建立互相衝突的驗證規則。
5.1 安裝 htpasswd 工具
AlmaLinux / RHEL 系列通常由 httpd-tools 套件提供 htpasswd:
sudo dnf install -y httpd-tools
確認指令存在:
command -v htpasswd
htpasswd -h
5.2 建立密碼檔
密碼檔必須放在網站 DocumentRoot 之外,避免被 HTTP 直接下載。
第一次建立密碼檔:
sudo htpasswd -cB /etc/httpd/.htpasswd reportadmin
系統會要求輸入並確認密碼。-B 使用 bcrypt 雜湊。
設定檔案權限。以下假設 Apache 執行群組為
apache;若系統實際群組不同,請先確認:
ps -eo user,group,comm | grep '[h]ttpd'
sudo chown root:apache /etc/httpd/.htpasswd
sudo chmod 0640 /etc/httpd/.htpasswd
新增第二個使用者時,不要再加 -c:
sudo htpasswd -B /etc/httpd/.htpasswd anotheruser
-c會建立新檔案;若檔案已存在,再使用-c可能覆蓋原有帳號資料。
5.3 作法 B-1:在 Apache 主設定檔使用 <Directory>
這是較建議的方式。將設定放入目標 VirtualHost 可讀取的 Apache
設定檔,或放在適當的主設定檔中。<Directory>
內的路徑必須是實際的檔案系統路徑:
<Directory "/home/YOUR_USER/public_html/report">
AuthType Basic
AuthName "GoAccess Traffic Report"
AuthBasicProvider file
AuthUserFile /etc/httpd/.htpasswd
Require valid-user
</Directory>
注意:
<Directory>是 Apache 主設定檔中的區段容器,不能放進.htaccess。- 不要直接修改 Virtualmin 自動產生且可能被重建的設定檔,除非你清楚該版本的設定管理方式。
- 建議先備份將要修改的設定檔。
- 若將設定放在 VirtualHost 之外,請確認路徑只對目標網站生效,不要意外保護其他網站的同一路徑。
5.4 作法 B-2:使用 .htaccess
若確實要使用 .htaccess,檔案內容只能放目錄層級允許的指令,不能包含
<Directory>:
在:
/home/YOUR_USER/public_html/report/.htaccess
放入:
AuthType Basic
AuthName "GoAccess Traffic Report"
AuthBasicProvider file
AuthUserFile /etc/httpd/.htpasswd
Require valid-user
並在 Apache 主設定檔中,對應目錄允許 AuthConfig:
<Directory "/home/YOUR_USER/public_html/report">
AllowOverride AuthConfig
</Directory>
若 Apache 對該目錄設定了 AllowOverride None,.htaccess
中的驗證指令不會生效。若 Virtualmin 已有更精確的 AllowOverride
設定,應先確認再調整,不要盲目覆蓋其他網站規則。
5.5 檢查並重新載入 Apache
sudo apachectl configtest
只有在結果為 Syntax OK 時才重新載入:
sudo systemctl reload httpd
若檢查失敗,先修正錯誤,不要直接 reload 或 restart。
6. 測試目錄保護是否生效
6.1 未提供帳密時應回傳 401
curl -I https://example.com/report/
預期回應包含:
HTTP/1.1 401 Unauthorized
實際狀態行可能因 HTTP/2 或代理環境而不同,重點是未驗證請求不能取得報表內容。
6.2 提供帳密後應可讀取
curl -I -u reportadmin https://example.com/report/
curl 會提示輸入密碼。預期成功時回傳 200 或適當的成功狀態。
不要把密碼直接寫在命令列參數中,以免留在 Shell history 或程序資訊中。
6.3 確認密碼檔不能從網站下載
密碼檔位於 /etc/httpd/,不應位於網站公開目錄。可另外確認:
curl -I https://example.com/.htpasswd
預期不能取得密碼檔內容。
7. GoAccess 安裝與基本測試
先確認 GoAccess 是否已安裝:
goaccess --version
若尚未安裝,請先依 GoAccess 官方下載頁及 AlmaLinux 10 可用套件來源選擇安裝方式。不要假設所有啟用的 AlmaLinux 軟體庫都一定提供相同版本。
安裝後先用實際日誌測試解析:
sudo goaccess "$ACCESS_LOG" --log-format=COMBINED
這會進入終端機互動介面。確認日期、請求、狀態碼等資料能正常解析後,按 q
離開。
產生一次靜態 HTML 報表:
sudo goaccess "$ACCESS_LOG" \
--log-format=COMBINED \
-o /tmp/goaccess-test.html
檢查輸出:
sudo test -s /tmp/goaccess-test.html && echo "HTML report generated"
若出現大量無法解析的日誌紀錄,先檢查 Apache LogFormat,不要直接建立
Cron 排程。
8. 自動更新報表:建議使用腳本與 Cron
8.1 先決定由誰執行
GoAccess 必須:
- 能讀取目標網站的 Access Log。
- 能寫入報表輸出位置。
- 不需要對網站公開目錄取得不必要的寫入權限。
Virtualmin 的每個虛擬主機可能有不同日誌路徑與檔案權限。請先確認日誌擁有者、群組、ACL 及 SELinux 政策。
可以檢查:
sudo ls -l "$ACCESS_LOG"
sudo namei -l "$ACCESS_LOG"
sudo getfacl "$ACCESS_LOG"
不要為了讓 Cron 成功而把日誌改成 chmod 644、把網站目錄改成
chmod 777,或停用 SELinux。
8.2 建立更新腳本
以下範例使用 root 執行 GoAccess 以讀取日誌,再將產出的 HTML 設為一般可讀檔案。請先替換網域、網站帳號、日誌路徑及報表目錄。
建立:
sudo vi /usr/local/sbin/update-goaccess-example.sh
內容:
#!/usr/bin/env bash
set -Eeuo pipefail
PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
umask 027
ACCESS_LOG="/實際/日誌/路徑/example.com_access_log"
REPORT_DIR="/home/YOUR_USER/public_html/report"
REPORT_FILE="${REPORT_DIR}/index.html"
TMP_FILE="${REPORT_DIR}/.index.html.tmp"
LOCK_FILE="/run/lock/goaccess-example.lock"
exec 9>"$LOCK_FILE"
/usr/bin/flock -n 9 || exit 0
if [[ ! -r "$ACCESS_LOG" ]]; then
echo "Cannot read access log: $ACCESS_LOG" >&2
exit 1
fi
if [[ ! -d "$REPORT_DIR" ]]; then
echo "Report directory does not exist: $REPORT_DIR" >&2
exit 1
fi
/usr/bin/goaccess "$ACCESS_LOG" \
--log-format=COMBINED \
-o "$TMP_FILE"
# 確認報表不是空檔後,再替換正式報表。
test -s "$TMP_FILE"
chmod 0644 "$TMP_FILE"
mv -f "$TMP_FILE" "$REPORT_FILE"
# 依網站帳號調整檔案擁有者;請替換成實際帳號及群組。
chown YOUR_USER:YOUR_USER "$REPORT_FILE"
# 若系統啟用 SELinux,依既有網站目錄政策還原標籤。
if command -v restorecon >/dev/null 2>&1; then
restorecon "$REPORT_FILE" || true
fi
設定腳本權限:
sudo chown root:root /usr/local/sbin/update-goaccess-example.sh
sudo chmod 0750 /usr/local/sbin/update-goaccess-example.sh
執行一次測試:
sudo /usr/local/sbin/update-goaccess-example.sh
確認報表:
sudo ls -l /home/YOUR_USER/public_html/report/index.html
注意:上面的範例假設網站帳號及群組名稱相同。若實際群組不同,請修改
chown。Apache 仍必須能穿越父目錄並讀取index.html;應依 Virtualmin 的權限模型及 SELinux 政策調整,而不是直接放寬整棵網站目錄。
8.3 設定 root Cron
編輯 root 的排程:
sudo crontab -e
例如每小時第 5 分鐘更新:
5 * * * * /usr/local/sbin/update-goaccess-example.sh >> /var/log/goaccess-example-cron.log 2>&1
檢查排程:
sudo crontab -l
檢查執行紀錄:
sudo tail -n 100 /var/log/goaccess-example-cron.log
8.4 關於 Logrotate 與歷史資料
若只分析目前的 Access Log,Logrotate 輪替後,舊日誌資料不會自動包含在新報表中。
若希望報表涵蓋輪替後的歷史資料,必須明確規劃讀取目前日誌及相關輪替檔案。GoAccess 支援從標準輸入讀取資料;例如在確認檔案命名及格式一致後,可評估:
zcat -f /實際/日誌/路徑/example.com_access_log* \
| goaccess - --log-format=COMBINED -o /tmp/report.html
使用前必須確認:
- Glob 只匹配該網站的日誌,不會混入其他虛擬主機。
- 未壓縮與 gzip 壓縮檔都符合預期格式。
- 輪替檔案沒有重複或不必要的資料。
- 所有日誌均可讀取。
- 日誌檔案排序及時間範圍符合報表需求。
不要未經測試就將此命令直接套用到正式 Cron。
9. SELinux 檢查
AlmaLinux 10 可能啟用 SELinux。先確認狀態:
getenforce
若回傳 Enforcing,應檢查目錄標籤及拒絕紀錄:
ls -Zd /home/YOUR_USER
ls -Zd /home/YOUR_USER/public_html
ls -Zd /home/YOUR_USER/public_html/report
sudo ausearch -m AVC -ts recent
若 Apache 無法讀取報表,先從 AVC 記錄判斷原因,再依該目錄用途設定正確的 SELinux file context。
不要把 setenforce 0 或停用 SELinux 當成正式解決方案。 Virtualmin
可能有自己的網站目錄標籤及政策配置;變更前應先確認該主機目前的 SELinux
管理方式。
10. 最終驗收清單
- 已確認目標 Virtual Server 的 DocumentRoot。
- 已確認該網站真正使用的 Apache Access Log。
- 已確認日誌格式與 GoAccess
COMBINED相符。 - 報表目錄位於正確網站目錄。
-
.htpasswd位於 DocumentRoot 之外。 - 未驗證的 HTTPS 請求無法讀取報表(401)。
- 正確帳密可以讀取報表(成功狀態)。
- HTTP 會導向 HTTPS,或不提供未加密的登入入口。
-
apachectl configtest回傳Syntax OK。 - GoAccess 可以成功產生非空 HTML 檔案。
- Cron 執行帳號具有必要且最小化的讀寫權限。
- 報表檔案可由 Apache 讀取。
- SELinux 沒有阻擋 Apache 存取報表。
- 已決定 Logrotate 後是否需要合併歷史日誌。
- 已檢查 Cron 執行紀錄,確認排程沒有持續失敗。
11. 常見問題排查
現象 優先檢查
開啟報表沒有跳出登入視窗 Apache 驗證設定是否載入、.htaccess
是否允許 AuthConfig
輸入帳密仍然 401 使用者是否存在於正確的 htpasswd 檔、檔案權限是否允許 Apache 讀取
回傳 403 目錄權限、父目錄穿越權限、Apache Require
規則、SELinux
報表為空 Access Log 路徑、檔案是否有資料、GoAccess 日誌格式
手動執行成功但 Cron 失敗 Cron 執行者、PATH、檔案權限、SELinux、腳本紀錄
Logrotate 後統計資料減少 是否只讀取目前日誌,是否需要解析輪替檔
Apache reload 失敗 先執行 apachectl configtest,再查 Apache
error log
12. 官方參考文件
-
Apache HTTP Server --- Authentication and Authorization
https://httpd.apache.org/docs/2.4/howto/auth.html -
Apache HTTP Server ---
.htaccessFiles
https://httpd.apache.org/docs/2.4/howto/htaccess.html -
Apache HTTP Server --- Override Class Index
https://httpd.apache.org/docs/2.4/mod/overrides.html -
GoAccess --- Get Started
https://goaccess.io/get-started -
GoAccess --- Frequently Asked Questions
https://goaccess.io/faq -
GoAccess --- Manual
https://goaccess.io/man
版本與環境備註
本文件提供的是可供部署前核對的通用流程。Virtualmin 的選單名稱、Apache 設定檔位置、網站帳號群組、日誌路徑、SELinux policy 及 GoAccess 套件版本,均可能因安裝方式及主機設定不同而異。
正式套用前,請以該主機的實際設定為準。尤其是日誌路徑、Apache 讀取權限與 SELinux 標籤,不應只依照範例猜測。