常用的安裝方式有：

• 二進位方式部署
• Docker Compose 方式部署
• Helm 方式部署

首推二進位方式，原因：

• 夜鶯只有一個二進位檔案，沒有太多相依，管理起來比較簡單，通常大家對 systemd 都比較熟悉，直接用 systemd 管理夜鶯的程序就行了
• Docker Compose 方式比二進位方式效能上稍差，而且 Docker Compose 方式需要額外的 Docker 相關知識，還有國內網路導致的映像拉取問題，有時也會比較難受
• Helm 方式用於部署在 Kubernetes 中，但是監控系統是個 P0 級的系統，所有系統都掛了，監控也不能掛，所以如果部署在 Kubernetes 中，那當 Kubernetes 掛的時候，監控也會掛，此時，別的團隊可能會來怪你，怨你怎麼不提前規劃好

不管是哪種安裝方式，安裝完成後，夜鶯的預設使用者名稱是 root，密碼是 root.2020。夜鶯預設監聽的連接埠是 17000，邊緣模式下用的 n9e-edge 連接埠是 19000。

如果你用到了邊緣模式，請務必閱讀 夜鶯架構中的邊緣模式說明 章節。

FAQ

監控資料查不到

1. 根據 影片教學 檢查設定
2. 如果是 Prometheus 作為時序庫（TSDB），可能會因為沒有開啟 remote write receiver 而導致查不到資料。此時夜鶯的日誌裡會出現 WARNING 日誌，提示請求 Prometheus 的 /api/v1/write 介面回傳 404，同時日誌裡會列印 Prometheus 的回傳資訊，會提示你應該為 Prometheus 加入什麼命令列啟動參數。通常，新版 Prometheus 需要加入 --web.enable-remote-write-receiver 參數，舊版 Prometheus 需要加入 --enable-feature=remote-write-receiver 參數。加入後重啟 Prometheus 即可。

常見問題

Q1：n9e 對硬體要求？

A：

• 小規模（< 100 台機器）：1 台 4C8G 跑全端即可；
• 中規模（100-1000 台機器）：獨立的資料庫 + 2 台 8C16G n9e Server；
• 大規模（1000+）：分散式部署 — n9e-server + n9e-edge + 獨立時序資料庫。

Q2：必須的相依元件？

A：

• MySQL 5.7+ / PostgreSQL 14+（中繼資料）；
• Redis 5+（快取 + 分散式鎖）；
• 時序資料庫（Prometheus / VictoriaMetrics / TDengine 等任一）。

Q3：可以用 SQLite 嗎？

A：示範 / 單人測試可以。生產環境強烈不建議 — SQLite 不適合多程序存取，告警引擎並行寫入會出問題。

參考資料

• 二進位部署
• Docker Compose 部署
• Helm 部署
• 設定檔說明