Grafana 如何在离线环境通过 ZIP 文件或 Grafana CLI 安装插件 📅 发布时间:2026/9/12 16:10:58 👁 浏览次数: Grafana 如何在离线环境通过 ZIP 文件或 Grafana CLI 安装插件【免费下载链接】grafanaThe open and composable observability and data visualization platform. Visualize metrics, logs, and traces from multiple sources like Prometheus, Loki, Elasticsearch, InfluxDB, Postgres and many more.项目地址: https://gitcode.com/GitHub_Trending/gr/grafana插件安装通常需要互联网连接默认路径是从 Grafana 的 Plugin Catalog 下载插件。当你的实例处于离线air-gapped环境、或目标插件不在 Plugin Catalog 中时可以改用两条离线安装路径把插件 ZIP 包直接解压到插件目录或者用 Grafana 自带的 server CLI 从一个可访问的 URL 下载 ZIP 安装。本文基于 Grafana 仓库中的 插件安装文档、Grafana server CLI 文档 和 配置参考 给出完整操作路径。开始前先说明一点文档建议优先检查实例在插件安装时会访问哪些端点并把它们加入实例的 allow list只有在无法放行网络时才使用本文的 ZIP 文件或 CLI 方案。在有网络的机器上先取得插件 ZIP离线主机本身无法下载插件所以第一步是在一台能访问互联网的机器上获取插件 ZIP再把它传到离线主机。文档以grafana-lokiexplore-app插件为例给出了获取方式打开https://grafana.com/api/plugins/grafana-lokiexplore-app找到响应中的links部分找到形如https://grafana.com/api/plugins/grafana-lokiexplore-app/versions/1.0.2/download的download地址用这个 URL 下载插件 ZIP 文件随后按本文任一方式安装。其他插件同理把 API 路径中的插件 ID 换成目标插件的 ID 即可。方式一通过 ZIP 文件安装适用于插件不在 Plugin Catalog 中、或环境没有互联网访问的场景。定位插件目录。插件目录由 Grafana 配置文件中的[paths]段plugins选项定义见 配置参考Grafana 会自动扫描该目录查找插件。文档给出的平台参考值LinuxDebian/RPM 包默认/var/lib/grafana/pluginsCLI 文档中列出的默认插件目录macOS/usr/local/var/lib/grafana/plugins。解压安装。把 ZIP 包解压到插件目录下的一个以插件名命名的子目录中。文档示例my-plugin-0.2.0.zip为文档中的示例文件名替换为你实际的插件包YOUR_PLUGIN_DIR替换为上一步确认的插件目录unzip my-plugin-0.2.0.zip -d YOUR_PLUGIN_DIR/my-plugin注意解压目标必须是形如插件目录/插件名的子目录而不是直接解压到插件目录根部。方式二通过 Grafana CLI 安装Grafana server CLI 是随 Grafana server 附带的小型可执行文件可以安装、升级和管理插件。适合插件 ZIP 已放到内网某个可访问地址如公司内网静态服务器的场景。运行 CLI。在 Grafana server 所在机器上任选其一把 Grafana 二进制目录加入PATH在bin目录下执行./grafana cli使用完整路径Linux 上例如/usr/share/grafana/bin/grafanaWindows 上为C:\Program Files\GrafanaLabs\grafana\bin\grafana.exe。命令的一般语法为grafana cli [global options] command [command options] [arguments...]从指定 URL 安装。默认情况下 CLI 从 Grafana 官方源下载离线环境用--pluginUrl全局选项改为从本地 URL 下载 ZIP。文档示例plugin-id、plugin-version需替换为实际值grafana cli --pluginUrl https://company.com/grafana/plugins/plugin-id-plugin-version.zip plugins install plugin-id其他相关全局选项--pluginsDir value覆盖插件保存目录。默认目录是/var/lib/grafana/plugins该选项只对当次命令生效不会永久修改配置。例如grafana cli --pluginsDir /var/lib/grafana/devplugins plugins install plugin-id--repo value从默认 Grafana 仓库以外的仓库下载安装或更新插件例如grafana cli --repo https://example.com/plugins plugins install plugin-id--insecure关闭 TLS 验证在下载来自非默认来源的插件时可能用到。文档明确警告这是显著的安全风险不建议使用如必须使用形如grafana cli --insecure --pluginUrl url plugins install plugin-id。权限要求。文档说明在 Linux 上安装或移除插件等命令需要sudo在 Windows 上需要以管理员身份运行 PowerShell。常规安装命令用于有网络的场景作为对照保留grafana cli plugins install plugin-id安装最新版本grafana cli plugins install plugin-id version安装指定版本。验证安装结果安装完成后用 CLI 列出已安装插件确认grafana cli plugins ls也可以在 UI 中确认进入Administration Plugins and data Plugins需要 Grafana Server administrator 或 Organization administrator 角色目标插件应出现在已安装列表中。关于签名。Grafana 加载插件时会检查其是否签名。如果安装的是未签名插件需要在配置文件的[plugins]段设置allow_loading_unsigned_plugins逗号分隔的插件 ID 列表才能加载且签名被篡改的插件永远不会被加载。文档不推荐启用该选项详见 插件签名说明。离线环境的已知边界内置bundled插件目录Debian 和 RPM 包把内置插件安装在/var/lib/grafana/plugins-bundledgrafana-server的 systemd unit 会传一个匹配的cfg:default.paths.bundled_plugins参数。如果覆盖了该配置项或修改了 systemd unit两处值必须保持一致否则 Grafana 找不到内置插件其提供的数据源会停止工作。Grafana 启动时会从grafana.com下载缺失的内置插件因此有网络的机器上不易察觉问题在离线主机上这个目录直接决定内置数据源是否可用。Grafana Cloud 用户不适用本文的离线方案Cloud 用户通过 UI 安装插件见 插件管理总览。通过 CLI 或 ZIP 安装时Grafana 不会自动检查新版本后续升级仍需手动替换 ZIP 或重新执行 CLI 安装命令。参考文档Install a plugin、Grafana server CLI、Configure Grafana。【免费下载链接】grafanaThe open and composable observability and data visualization platform. Visualize metrics, logs, and traces from multiple sources like Prometheus, Loki, Elasticsearch, InfluxDB, Postgres and many more.项目地址: https://gitcode.com/GitHub_Trending/gr/grafana创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考