Blazer-Docker 镜像文档

镜像概述和主要用途

Blazer-Docker镜像是将开源商业智能工具Blazer进行Docker容器化的部署包。Blazer是一款轻量级BI工具，允许用户通过SQL查询直接与数据库交互，快速生成报表、可视化图表，并支持结果分享与协作。该镜像简化了Blazer的部署流程，无需复杂环境配置，可快速搭建企业级数据分析平台。

核心功能和特性

• SQL查询与分析：内置SQL编辑器，支持语法高亮、自动补全，可直接执行查询并查看结果
• 数据可视化：提供多种图表类型（折线图、柱状图、饼图等）及表格展示，支持自定义报表样式
• 报表管理：支持报表保存、分类、分享及定时刷新，便于团队协作
• 多数据库支持：兼容PostgreSQL、MySQL、Redshift、BigQuery等主流数据库
• 权限控制：支持基础认证、用户角色管理，确保数据访问安全
• 轻量级架构：基于Ruby on Rails构建，资源占用低，部署简单

使用场景和适用范围

• 中小企业数据分析：无需采购商业BI软件，快速搭建内部数据分析平台
• 开发/运维团队：监控数据库性能指标、业务数据趋势
• 业务部门自助分析：非技术人员通过预设SQL模板生成业务报表
• 临时数据分析需求：快速连接数据库进行即席查询与可视化展示

详细使用方法和配置说明

基本部署（Docker Run）

docker run -d \
  -p 3000:3000 \
  -e DATABASE_URL="postgresql://user:password@host:port/dbname" \
  -e SECRET_KEY_BASE="your-secret-key" \
  --name blazer \
  ankane/blazer

Docker Compose 配置示例

version: '3'
services:
  blazer:
    image: ankane/blazer
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://user:password@postgres:5432/blazer_db
      - SECRET_KEY_BASE=your-strong-secret-key
      - AUTH_USERNAME=admin
      - AUTH_PASSWORD=secure-password
    depends_on:
      - postgres
  postgres:
    image: postgres:14
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=blazer_db
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

核心环境变量配置

数据库连接配置

支持的数据库URL格式示例：

• PostgreSQL: postgresql://user:password@host:5432/dbname
• MySQL: mysql2://user:password@host:3306/dbname
• Redshift: redshift://user:password@host:5439/dbname
• BigQuery: bigquery://project_id?keyfile=/path/to/keyfile.json（需挂载密钥文件）

访问与使用

1. 启动容器后，通过 http://localhost:3000 访问Blazer界面
2. 使用配置的AUTH_USERNAME和AUTH_PASSWORD登录（如未配置则无需认证）
3. 在SQL编辑器中编写查询，点击"Run"执行并生成结果
4. 点击"Save"保存查询为报表，或使用"Visualize"生成图表

注意事项

• 生产环境需配置SECRET_KEY_BASE和认证信息，避免未授权访问
• 对于大数据量查询，建议调整BLAZER_QUERY_TIMEOUT和BLAZER_MAX_RESULTS参数
• 持久化数据需挂载容器内的/app/db目录（SQLite默认存储位置）或使用外部数据库

更多详细配置请参考官方文档：Blazer-Docker GitHub