插件管理与安装
插件用来扩展 Grafana 的数据源与可视化能力：官方与社区的时钟、饼图、日志面板以及各类数据源连接器都通过插件提供。安装方式有三种：服务器上用 grafana-cli 安装、容器启动时用环境变量声明，或把插件包直接放进插件目录；内网环境适合离线放置。
基本信息
| 安装工具 | grafana-cli plugins install <插件名> |
|---|---|
| 容器方式 | 环境变量 GF_INSTALL_PLUGINS 声明插件列表 |
| 插件目录 | /var/lib/grafana/plugins |
| 生效方式 | 安装或升级插件后需要重启 Grafana |
安装方式
安装方式
# 宿主机或容器内安装
grafana-cli plugins install grafana-clock-panel
# Docker 一次安装多个
-e GF_INSTALL_PLUGINS=grafana-clock-panel,grafana-simple-json-datasource
# 内网离线：下载插件包解压到插件目录后重启
# 插件目录：/var/lib/grafana/plugins安装方式对比
| 方式 | 适用场景 | 注意点 |
|---|---|---|
| grafana-cli | 物理机或容器内手工安装 | 需要能访问插件仓库 |
| GF_INSTALL_PLUGINS | 容器化部署、声明式管理 | 每次启动都按清单安装 |
| 离线包 | 内网无外网出口环境 | 自行校验包来源与版本 |
| provisioning 挂载 | 多实例统一插件版本 | 借助自定义镜像固化版本 |
使用注意
- 升级插件前查看其声明的兼容 Grafana 版本范围
- 自研未签名插件需要显式允许，不要为省事整体关闭签名校验
- 插件目录在数据卷里，重建容器时未挂卷会导致插件全部丢失
- 生产环境统一插件版本，避免同一看板在不同实例上表现不一致
自研未签名插件需显式允许，不要为省事关闭整体签名校验；关闭校验等于运行任意代码，风险远大于省下的签名步骤。
运维要点
- 插件升级与 Grafana 主版本升级分开做，出问题时更容易定位
- 在预发环境先验证插件与现有看板的兼容性
- 记录每个插件的安装来源与版本，审计与重建环境时可追溯
- 插件清单固化在镜像或部署配置里，避免手工安装后新实例缺少插件