deadly0/bull-board

bull-board Docker镜像文档

镜像概述

本镜像为bull-board提供Docker化部署方案，允许无需编码即可监控bull队列。支持bull和bullmq两种队列系统，基于bull-board v3.2.6版本构建。

核心功能与特性

• 零编码监控：无需编写代码即可实现bull队列的可视化监控
• 多版本支持：同时兼容bull和bullmq队列系统
• 灵活配置：通过环境变量自定义Redis连接参数、队列前缀、访问控制等
• 访问控制：支持通过用户名密码限制界面访问
• 代理路径支持：可配置代理路径，适应不同部署环境

使用场景

适用于需要监控bull或bullmq队列状态的开发者和运维人员，可用于本地开发环境和生产环境的队列监控。

使用方法

Docker快速启动

通过以下命令快速启动bull-board，默认连接本地Redis（localhost:6379，无密码）：

bash
docker run -p 3000:3000 deadly0/bull-board

启动后，可通过localhost:3000访问bull-board界面。

docker-compose快速启动

基础docker-compose配置（默认连接本地Redis）：

yaml
version: '3.5'

services:
  bullboard:
    container_name: bullboard
    image: deadly0/bull-board
    restart: always
    ports:
      - 3000:3000

环境变量配置

可通过以下环境变量自定义镜像行为：

访问控制配置

通过同时设置USER_LOGIN和USER_PASSWORD环境变量可启用登录密码限制，仅当两个变量都设置时生效。

带环境变量的docker-compose示例

yaml
version: '3.5'

services:
  redis:
    container_name: redis
    image: redis:5.0-alpine
    restart: always
    ports:
      - 6379:6379
    volumes:
      - redis_db_data:/data

  bullboard:
    container_name: bullboard
    image: deadly0/bull-board
    restart: always
    ports:
      - 3000:3000
    environment:
      REDIS_HOST: redis
      REDIS_PORT: 6379
      REDIS_PASSWORD: example-password
      REDIS_USE_TLS: 'false'
      BULL_PREFIX: bull
    depends_on:
      - redis

volumes:
  redis_db_data:
    external: false

注：https://github.com/felixmosh/bull-board 是一个用于监控bull队列的Web界面工具。