bull-board Docker镜像

概述和主要用途

该Docker镜像为bull-board提供容器化部署，允许您无需编写任何代码即可监控Bull队列。支持Bull和BullMQ两种队列类型，通过简单配置即可可视化监控队列状态。

核心功能和特性

• 无需编码即可实现Bull队列监控
• 同时支持Bull和BullMQ队列
• 通过环境变量灵活配置Redis连接参数
• 支持访问权限控制（用户名/密码认证）
• 可自定义面板标题和代理路径

使用场景和适用范围

适用于需要监控Bull或BullMQ队列的开发和运维场景，尤其适合希望快速部署队列监控工具、无需手动集成bull-board到现有应用的用户。

使用方法和配置说明

使用Docker快速启动

通过以下命令快速启动bull-board：

docker run -p 3000:3000 addono/bull-board

此命令将在localhost:3000启动bull-board界面，并默认连接localhost:6379的Redis实例（无密码）。如需自定义Redis连接，请参考"环境变量"部分。

使用docker-compose快速启动

基础docker-compose配置示例：

version: '3.5'

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

此配置将在localhost:3000启动bull-board界面，默认连接localhost:6379的Redis实例（无密码）。完整带环境变量的示例请参考"带环境变量的docker-compose示例"部分。

环境变量配置

以下环境变量可用于自定义bull-board的行为：

通过用户名/密码限制访问

如需限制bull-board的访问权限，需同时设置USER_LOGIN和USER_PASSWORD环境变量。仅当这两个变量都被指定时，访问才会需要用户名/密码认证。

带环境变量的docker-compose示例

以下示例包含Redis服务和完整的bull-board配置：

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: addono/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