安装与部署

夜莺的几种跑法——Compose、Docker 镜像、二进制、Helm、n9e-edge——各自适合什么场景。

方式	适用场景
Docker Compose	评估与中小生产环境——依赖组件一并拉起
Docker 镜像	已有 MySQL 和时序库
二进制	Linux amd64 / arm64 的 tar.gz，随 GitHub Release 附校验值
Helm	Kubernetes
n9e-edge	与中心网络链路不稳的边缘机房

各方式的具体命令见下载页。

Docker Compose

一条命令把夜莺连同数据库、时序库一起拉起；编排里有什么、怎么改。

二进制包

下载 GitHub Release 的 Linux amd64 / arm64 包，校验解压，接上已有的 MySQL 和 Redis，用 systemd 托管 n9e。

Helm / Kubernetes

社区维护的 Helm chart 在 Kubernetes 里拉起夜莺连同 MySQL、Redis、Prometheus 和 Categraf；values 可改为指向集群外数据库。

MySQL / PostgreSQL / SQLite 与 Redis

元数据库可选 MySQL、PostgreSQL 或 SQLite（仅测试），表结构由进程首次启动时自动建好；Redis 存放心跳等运行时状态。

内置时序库：开箱与小规模

零额外组件先跑起来：内置时序库的保留期、容量，以及单 Center 的限制。

外置时序库与双写迁移

借助 Pushgw 双写，从内置时序库无缝切换到 Prometheus 或 VictoriaMetrics。

配置文件布局

配置是一个目录：config.toml 供 n9e、alert、pushgw 读取，etc/edge 供 n9e-edge 读取；环境变量只填空缺，不覆盖已有配置。

高可用

在负载均衡后面跑多个 Center 和 Alert 实例，以及哪些部分仍然必须单实例。

离线部署

在没有外网的机器上安装：需要提前准备的包、镜像和集成模板。

边缘机房

给与中心链路不稳的机房用的本地告警引擎，以及那个会让它悄无声息失效的参数。

升级

小版本升级与 v8 → v9 跨版本升级：先备份、读数据库变更说明、再滚动替换二进制。

回滚

升级失败后回到上一版本，包括已经执行过的表结构变更该怎么处理。

卸载与数据保留

干净地卸载夜莺，以及卸载前该保留或导出什么。