跳至主要内容
版本:0.4 · 現行版

安裝 Excubius

概觀審閱日期:2026年10月11日
適用於:Excubius 0.4角色: 安裝人員(Linux 管理員)
方案Free · Core · Pro · Enterprise部署自行託管

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、對容器登錄庫或映像封存檔的存取,以及時鐘同步。

伺服器會收到發行套件、一個設定檔和容器映像。它不會收到原始碼,也不會連線到程式碼存放庫。

安裝​

  1. 將安裝程式套件複製到伺服器並解壓縮:

    tar -xzf excubius-installer-0.4.0.tar.gz
    cd excubius-installer-0.4.0
  2. 你也可以只執行預檢。預檢不會變更任何內容:

    sudo ./install.sh --check-only
  3. 執行安裝程式並回答它的問題。按 Enter 接受方括號內的值:

    sudo ./install.sh

    安裝程式會按版本保留你的答案,因此升級時只會詢問該版本新增的問題。

  4. 安裝完成後,開啟安裝程式列印的公開網址,並以你在安裝期間指定的管理員身分登入。然後設定登入,並邀請將使用 Excubius 的人員。

安裝程式執行的所有操作都會記錄到 /var/log/excubius-install.log,記錄中不包含機密。

安裝程式的問題​

問題預設值說明
安裝目錄/opt/excubius任何絕對路徑
服務帳戶excubius如果不存在就會建立。它以非 root 權限執行容器
公開網址https://monitoring.example.com用戶將開啟的網址。其主機是伺服器的主要名稱
別名無用戶可以開啟的其他名稱,以空格分隔,例如你控制的域名中的別名
TLSletsencryptletsencrypt(透過 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 個字元,並會要求輸入兩次
基本預設enterpriseenterprise、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 也會傳回正在運行的版本。

後續步驟​