跳到主要内容

兼容性矩阵

各依赖组件的版本情况,以及为什么这里没有一张官方的「支持版本」表。

先说清楚:项目没有发布过官方的「支持版本矩阵」。 下面这些是从发布物和代码里核实出来的事实,不是承诺。

生产选型时,把这页当作「已知能跑的组合」的起点,而不是「只有这些能跑」。

官方 compose 方案实际用的版本​

这是被真实验证过的组合——发布时会跑起来看:

组件版本出现在
MySQL8compose-bridge
PostgreSQL12-alpinecompose-postgres
Redis6.2 / 7.0-alpine两套方案各一
VictoriaMetricsv1.79.12两套方案
Prometheus最新compose-host-network

元数据库​

数据库情况
SQLite内置,只适合单进程测试。表结构靠启动时 AutoMigrate 建
MySQL驱动是 go-sql-driver/mysql v1.9.3,覆盖 5.7 及以上;官方方案用 8
PostgreSQL驱动是 jackc/pgx v5,覆盖主流版本;官方方案用 12

字符集:MySQL 的 DSN 里要带 charset=utf8mb4&parseTime=True&loc=Local, 建表脚本 docker/initsql/a-n9e.sql 用的也是 utf8mb4。

Redis​

形态配置项
miniredis(进程内,测试用)RedisType = "miniredis"
单实例RedisType = "standalone"
集群RedisType = "cluster"
哨兵RedisType = "sentinel"

客户端是 go-redis/v9,兼容 Redis 6 及以上。

数据源​

开源版支持 11 种类型,各自的版本情况:

类型说明
Prometheus Like覆盖 Prometheus、VictoriaMetrics、Thanos、Mimir、M3 —— 只要实现 PromQL HTTP API
ElasticSearch表单里版本可以留空自动探测,也可以写 x.y.z。代码里对 7.17.0 以上有分支处理
OpenSearch需要在配置里写明版本
LokiURL 必须带 /loki 后缀
VictoriaLogs / TDengine / ClickHouse / Doris / IoTDB / MySQL / PostgreSQL见各自的接入页

注意能注册成数据源和能在哪里用是两回事:ClickHouse、Doris、MySQL、PostgreSQL、 OpenSearch 在开源版进不了即时查询、日志检索和仪表盘,只能用于告警规则。 见接入数据。

采集器​

采集器情况
Categraf配套采集器,独立仓库独立版本。Remote Write 协议
Prometheus / vmagent / Grafana Agent通过 Remote Write 写入
Telegraf通过 Remote Write 或 OpenTSDB 协议
Datadog Agent走 /datadog/api/v1/series
Open-Falcon 采集器走 /openfalcon/push

构建环境​

Go 1.25。前端是 Vite + React,构建脚本见 n9e/fe 仓库。

相关​