安裝 Excubius
Excubius 在你控制的一部 Linux 伺服器上運行,伺服器可以位於你的雲端訂閱或數據中心。互動式安裝程式會檢查伺服器、詢問一份簡短的問題清單、安裝容器並取得證書。本文列出你需要準備的項目、安裝程式會詢問及執行的內容,以及後續每項工作的參考位置。
開始之前
| 項目 | 需求 |
|---|---|
| 伺服器 | Rocky Linux 9 或 10(或其他 RHEL 系列系統),x86-64,systemd。至少 2 vCPU、4 GiB 記憶體及 20 GiB 可用磁碟空間;在 Azure 中,Standard_B2ms(2 vCPU、8 GiB)是不錯的起點,日後可以調整大小。如果由你的雲端團隊建立伺服器,請參閱申請 Azure 伺服器 |
| 存取 | 伺服器上具備 sudo 權限的帳戶,並可從你的工作站透過 SSH 連線 |
| 用戶網絡 | 伺服器上的連接埠 80 和 443 未被佔用,並且從用戶使用 Excubius 的位置開放 |
| 出站連線 | 除非使用離線套件,否則需要透過 HTTPS 連線到 ghcr.io 和 docker.io 以提取映像 |
| 通往受監控系統的網絡 | 從伺服器連到每個實例、複本及接聽程式 IP 的 SQL 連接埠(沒有固定連接埠的具名實例還需要 UDP 1434),以及連到你要測試的網頁端點的 HTTPS。不會有任何連線連入採集器 |
| 安裝程式套件 | excubius-installer-<version>.tar.gz,或內含映像的離線套件。已登入的用戶可以從下載取得兩者 |
| 登入 | Microsoft Entra ID 應用程式註冊、Google OAuth 用戶端,或兩者皆有。請參閱設定登入提供者 |
| 監控登入 | 供你要監控的系統使用的唯讀登入,例如可用性群組的先決條件中的 SQL Server 登入 |
| 證書 | 使用 Let's Encrypt 時,需要一個指向伺服器的公開 DNS 名稱,或其 DNS 區域的 API 存取權。如果使用自己的證書、自簽證書,或由閘道終止 TLS,則不需要 |
安裝的運作方式
預檢涵蓋作業系統及其版本、架構、systemd 和 dnf、記憶體、CPU、磁碟、可用的連接埠 80 和 443、SELinux、對容器登錄庫或映像封存檔的存取,以及時鐘同步。
伺服器會收到發行套件、一個設定檔和容器映像。它不會收到原始碼,也不會連線到程式碼存放庫。
安裝
-
將安裝程式套件複製到伺服器並解壓縮:
tar -xzf excubius-installer-0.4.0.tar.gzcd excubius-installer-0.4.0 -
你也可以只執行預檢。預檢不會變更任何內容:
sudo ./install.sh --check-only -
執行安裝程式並回答它的問題。按 Enter 接受方括號內的值:
sudo ./install.sh安裝程式會按版本保留你的答案,因此升級時只會詢問該版本新增的問題。
-
安裝完成後,開啟安裝程式列印的公開網址,並以你在安裝期間指定的管理員身分登入。然後設定登入,並邀請將使用 Excubius 的人員。
安裝程式執行的所有操作都會記錄到 /var/log/excubius-install.log,記錄中不包含機密。
安裝程式的問題
| 問題 | 預設值 | 說明 |
|---|---|---|
| 安裝目錄 | /opt/excubius | 任何絕對路徑 |
| 服務帳戶 | excubius | 如果不存在就會建立。它以非 root 權限執行容器 |
| 公開網址 | https://monitoring.example.com | 用戶將開啟的網址。其主機是伺服器的主要名稱 |
| 別名 | 無 | 用戶可以開啟的其他名稱,以空格分隔,例如你控制的域名中的別名 |
| TLS | letsencrypt | letsencrypt(透過 HTTP)、letsencrypt-dns(透過 DNS)、selfsigned、custom(你自己的 PEM 檔案)、gateway(TLS 在前端終止)或 later(暫時使用純 HTTP) |
| 證書中的名稱 | all | 有別名時才會詢問:排除證書無法涵蓋的名稱 |
| Let's Encrypt 的電郵 | — | 兩種 Let's Encrypt 模式都需要 |
| DNS 提供者及憑證 | — | 僅限 letsencrypt-dns:acme.sh 的 dnsapi 識別碼,例如 dns_cf、dns_dreamhost 或 dns_azure,以及它的變數,逐一輸入且不顯示輸入內容 |
| 證書和金鑰檔案 | — | 僅限 custom:PEM 證書鏈(伺服器證書在前)和未加密的金鑰 |
| 管理員用戶名稱和密碼 | 建議的用戶名稱 | 用於首次登入的帳戶,登入位置是安裝程式完成時列印的網址。密碼至少需要 12 個字元,並會要求輸入兩次 |
| 基本預設 | enterprise | enterprise、databases 或 core;請參閱設定實例 |
| 容器登錄庫的用戶和權杖 | — | 隨授權一併提供。使用離線套件時不會詢問 |
| Slack 機械人權杖和頻道 | — 和 #alerts | 選用;日後也可以設定。請參閱設定 Slack 通知 |
| Entra ID 租用戶 ID、用戶端 ID 和密碼 | — | 選用;日後也可以設定 |
使用 Let's Encrypt 模式時,安裝程式接著會在公開 DNS 中檢查這些名稱,並透過 HTTP 確認它們指向這部伺服器。如果沒有指向,安裝程式會說明其他做法,但不會因此中止。
安裝程式會一次性產生數據庫密碼、工作階段簽署金鑰、加密已儲存機密的金鑰,以及採集器權杖,並且不會詢問這些內容。平台儲存管理員密碼、DNS 憑證和私密金鑰後,會將它們從設定檔中移除。
若要免問答安裝,請使用 --answers 以檔案提供答案;請參閱安裝程式參考。
名稱和 TLS
| 模式 | 適用情況 |
|---|---|
| Let's Encrypt,HTTP 驗證 | 名稱可以公開解析到伺服器,而且連接埠 80 可從互聯網存取 |
| Let's Encrypt,DNS 驗證 | 伺服器是私有的,但你可以透過 API 建立 DNS 記錄 |
| 你自己的證書 | 你的機構自行簽發證書 |
| 自簽證書 | 實驗環境或首次測試 |
| 閘道 | 前端的負載平衡器或反向代理終止 TLS |
| 純 HTTP | 首次測試,或你完全信任的網絡 |
你日後可以在 Settings 中變更名稱和證書,無須重新安裝,而且證書會自動續期。請參閱設定名稱及 TLS。
升級、重新安裝或解除安裝
| 命令 | 作用 |
|---|---|
在已安裝的伺服器上執行 sudo ./install.sh | 提供 Upgrade(保留數據,只詢問新增的問題)、Reinstall、Purge and install fresh 或 Cancel |
sudo ./install.sh --uninstall | 先進行最後一次數據庫備份,然後移除服務和映像。保留數據、備份和設定 |
sudo ./install.sh --uninstall --purge | 同時刪除數據、備份和服務帳戶。要求你輸入 purge |
請在變更時段內升級。服務會重新啟動數秒,並會執行數據庫移轉。開始之前,請閱讀該版本的已知問題。
--dry-run 適用於所有命令,只會列印將會發生的操作。升級、回復、備份及還原的步驟載於升級、備份及還原,供已登入的用戶參閱。
從外部監控 Excubius
Excubius 不應是唯一監控自身的系統。請把 https://<your server>/heartbeat 登記到外部監控工具,例如 Azure Monitor 可用性測試、在其他地方運行的 Uptime Kuma,或 healthchecks 類型的服務,並設定當該網址不再回應 ok 時向你發出警報。如果伺服器停止運作,就是這個外部監控工具通知你。
/heartbeat 和 /healthz 在每一種 TLS 模式下都以純 HTTP 回應。/healthz 也會傳回正在運行的版本。