Windows 環境下的 Kibana 安裝指南

TLDR

• Kibana 必須使用 kibana_system 帳號連線至 Elasticsearch，若遺失密碼可透過 elasticsearch-reset-password -u kibana_system 重設。
• elasticsearch.hosts 設定中必須使用 IP 或 Domain，不可使用 localhost。
• 若啟用 SSL，需將 Elasticsearch 產生的 CA 憑證放入 Kibana 目錄，並在 kibana.yml 中設定 elasticsearch.ssl.certificateAuthorities。
• 敏感資訊（如 SSL 密碼）建議使用 kibana-keystore 管理，而非直接寫入設定檔。
• 登入 Kibana 管理介面請使用 elastic 超級管理員帳號。

下載與安裝

• 前往官方網站下載 Windows 版本的 Kibana：https://www.elastic.co/downloads/kibana。
• 下載 Windows 的 .zip 檔案並解壓縮。

目錄結構說明

• bin：執行檔目錄。
• config：設定檔目錄。
• node：包含 Node.js 執行環境。
• node_modules：儲存 Node.js 套件。
• packages：核心程式庫與相依性套件。
• plugins：外掛目錄。
• src：Kibana 的原始碼。
• x-pack：Elastic Stack 的付費功能。
• .i18nrc.json：國際化 (i18n) 設定檔。

YAML 設定檔 (config/kibana.yml)

網路設定

什麼情況下會遇到：當需要從外部網路存取 Kibana 或調整監聽埠號時。

# 網路設定
network.host: 0.0.0.0 # 允許所有連線
http.port: 5601       # 預設埠號

Elasticsearch 連線設定

什麼情況下會遇到：Kibana 啟動時無法與 Elasticsearch 建立連線，或認證失敗。

• Kibana 必須使用 kibana_system 帳號進行連線。若遺失密碼，請在 Elasticsearch 的 bin 目錄下執行：

  elasticsearch-reset-password -u kibana_system

• 設定範例：

  # 必須使用 IP 或 Domain，不可使用 localhost
  elasticsearch.hosts: ["https://127.0.0.1:9200"]
  elasticsearch.username: "kibana_system"
  elasticsearch.password: "pass"
  # 若啟用 SSL，需指定 CA 憑證路徑
  elasticsearch.ssl.certificateAuthorities: [ "certs/kibana/elasticsearch-ca.pem" ]

語系設定

i18n.locale: "zh-CN"

設定 SSL 憑證

什麼情況下會遇到：當 Elasticsearch 啟用 HTTPS 傳輸，Kibana 需要透過 SSL 進行安全連線時。

1. 將 Elasticsearch 的 http.p12 憑證複製到 Kibana 目錄。
2. 在 kibana.yml 中啟用 SSL：

   server.ssl.enabled: true
   server.ssl.keystore.path: "certs/elasticsearch/http.p12"

3. 使用 kibana-keystore 安全儲存密碼：

   kibana-keystore create
   kibana-keystore add server.ssl.keystore.password

啟動服務

什麼情況下會遇到：安裝完成後，需驗證系統是否正常運作。

1. 以系統管理員權限開啟命令提示字元。
2. 切換至 bin 目錄並執行 kibana.bat。
3. 瀏覽器開啟 http://localhost:5601 或 https://localhost:5601。
4. 若 CMD 顯示 Native global console methods have been overridden in production environment.，代表服務已啟動。

登入與權限管理

什麼情況下會遇到：初次登入或需要建立一般使用者帳號時。

• 登入 Kibana 請使用 elastic 超級管理員帳號。若忘記密碼，請執行 elasticsearch-reset-password -u elastic 重設。
• 建立新用戶：進入 Kibana 介面後，前往 Stack Management -> Security -> Users 進行設定。

異動歷程

1. 2025-03-18

   • 初版文件建立。