如何在 Apache Superset 仪表板中引用本地机器上的图片

apache Superset 不支持直接从本地文件系统（如 C 盘）加载图片，但可通过配置静态资源目录，将图片放入 Superset 的 Static 文件夹后，以相对 URL 方式安全引用。

apache superset 不支持直接从本地文件系统（如 c 盘）加载图片，但可通过配置静态资源目录，将图片放入 superset 的 `static` 文件夹后，以相对 url 方式安全引用。

在 Apache Superset 中，出于安全与架构设计考虑，前端无法直接访问用户本地磁盘路径（例如 C:imageslogo.png 或 file:///C:/images/logo.png），浏览器会因跨源策略或协议限制（file:// 协议被现代框架普遍禁用）而拒绝加载。因此，“上传”并非唯一路径——更可靠、生产就绪的方式是将图片作为静态资源托管于 Superset 服务端。

✅ 正确做法：使用 Superset 的 static 目录托管图片

Superset 内置对 /static/ 路径的静态文件服务支持（由 flask 自动提供）。只需按以下步骤操作：

1. 定位 Superset 安装根目录
   通常为 Python 包安装路径（如通过 pip install apache-superset 安装）或你克隆/部署的源码目录。可通过以下命令快速确认：

   python -c "import superset; print(superset.__path__[0])"

   但更实用的是找到你运行 superset run 所在的项目根目录（例如 /opt/superset/ 或 C:superset）。

2. 创建并放置静态资源
   在该根目录下新建 static 文件夹（若不存在），然后将你的图片（如 dashboard-banner.jpg）放入其中：

   C:superset ├── static │   └── dashboard-banner.jpg   ← 你的图片 ├── superset_config.py └── ...

3. 在仪表板中引用图片
   使用 Markdown 或 HTML 文本组件，通过 绝对路径 /static/xxx 引用：

   @@##@@

   或在 Markdown 组件中：

   ![](/static/dashboard-banner.jpg)

⚠️ 注意事项：

• 路径必须以 /static/ 开头（不是 ./static/ 或 static/），这是 Superset 预设的静态路由前缀；
• 图片文件名区分大小写（linux/macos 环境下尤其注意）；
• 修改静态文件后无需重启 Superset，但浏览器可能缓存旧版本，建议硬刷新（Ctrl+F5）或检查 Network 面板确认返回状态码为 200；
• 生产环境部署时（如使用 gunicorn + nginx），需确保 Nginx 已正确配置代理 /static/ 到 Superset 的静态目录，或由 Nginx 直接服务该路径以提升性能。

? 验证是否生效

打开浏览器开发者工具（F12），切换到 Network 标签页，刷新仪表板，搜索 dashboard-banner.jpg —— 若看到 200 OK 响应且预览正常，则配置成功。

通过此方式，你既规避了前端安全限制，又保持了部署一致性与可维护性，是 Superset 官方推荐的静态资源管理实践。