Grafana自v7.0起彻底移除原生HTML面板,因安全策略禁用XSS风险;Text面板仅支持白名单HTML标签且不执行JS;真需JS交互须用iframe嵌入外部页面或开发签名插件。
HTML面板在Grafana里根本不能直接用
grafana 官方从 v7.0 开始彻底移除了原生 html 面板类型,现在所有版本默认都不支持直接写 <script> 这类内容。这不是配置问题,是安全策略强制关闭的——防止 xss 和任意 js 执行。<p>常见错误现象:<code>Panel plugin not found: html 或面板列表里压根看不到 HTML 选项。<ul>
<li>官方不提供、不维护、不推荐启用 HTML 面板
<li>社区插件(如 <code>marcusolsson-html-panel)仅兼容到 v6.x,v8+ 基本不可用或报 <code>plugin is not signed
<li>强行加载未签名插件需修改 <code>allow_loading_unsigned_plugins,但 Grafana 启动会警告,且每次升级都可能失效
<h3>替代方案:用 Text 面板 + Markdown 渲染有限 HTML<p><code>Text 面板是 Grafana 唯一保留的、允许嵌入简单 HTML 标签的内置面板,但它只渲染白名单标签(<code><b>、<code><i>、<code><ul>、<code><table> 等),不执行 JS,不支持 <code><script>、<code><iframe>、<code>onclick 等交互属性。<ul>
<li>适用场景:展示静态说明、带样式的指标摘要、简单表格对比
<li>写法示例:<pre class="brush:php;toolbar:false;"><table>
<tr><th>Env<th>Status
<tr><td>prod<td><b>OK
<li>注意:<code><style> 标签会被过滤,CSS 只能靠内联 <code>style="...",且部分样式(如 <code>position、<code>display: flex)可能被 sanitizer 移除
<h3>真要跑自定义 HTML/JS?只能走插件开发或 iframe<p>如果必须运行 JS、调用 API、做动态 DOM 操作,只有两个现实路径:<ul>
<li>用 <code>iframe 嵌入外部页面:把 HTML + JS 部署成独立服务(如 <code>http://localhost:8080/my-widget.html),然后在 <code>Text 面板里写 <pre class="brush:php;toolbar:false;"><iframe src="http://localhost:8080/my-widget.html" width="100%" height="300px">;注意跨域问题,目标页需设置 <code>Access-Control-Allow-Origin 或同域部署
<li>开发一个签名插件:基于 Grafana Plugin SDK 写一个 Panel 插件,用 React 渲染任意内容,打包后放入 <code>plugins/ 目录;这需要 Node.js 构建环境和对 Grafana 插件生命周期的理解,不是改几行配置就能搞定的事
<li>别碰 <code>unsafe-html 类 hack:某些旧文档提的 <code>innerHTML 注入方式,在 v8+ 已被 Shadow DOM 和 strict CSP 彻底拦截,无效
<h3>Grafana Cloud 用户请直接放弃 HTML 面板念头<p>Grafana Cloud 托管实例禁用了所有未签名插件加载机制,<code>allow_loading_unsigned_plugins 根本不存在于配置中。连 iframe 都受限——若目标地址不在白名单(如非 HTTPS、非 grafana.com 子域),会直接被浏览器拦截。<p>容易被忽略的一点:即使本地能跑通 iframe,上线到 Cloud 后常因混合内容(HTTP 资源)、CSP 策略或 Samesite cookie 导致 JS 请求失败,而控制台错误往往藏得深,只显示 <code>Blocked by CORS policy 或空白 iframe。
</script>
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!