# 策展 · X (Twitter) 🔥🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：Pontus Abrahamsson — oss/acc (@pontusab) · 平台：X (Twitter) · 日期：2026-05-26

> 原始來源：https://x.com/pontusab/status/2058913364278124550

## 中文摘要

Workbench 為 BullMQ 提供開源儀表板。js 或 Bun 後端應用。

由 Pontus Abrahamsson 開發的 Workbench 旨在解決 BullMQ 缺乏原生儀表板的問題。這款工具採用 MIT 授權，強調「零基礎設施」需求，透過將儀表板掛載為現有應用程式中的一個路由，讓使用者能直接在自己的後端環境與驗證機制下，管理任務（Jobs）、流程（Flows）、排程器（Schedulers）與監控指標。

**核心特色與優勢**
- **原生整合**：無需額外部署獨立服務，直接掛載於現有應用程式。
- **多框架支援**：提供 Hono、Elysia、Express、Fastify、NestJS 及 Next.js 的專屬轉接器（Adapter）。
- **完整功能**：支援 DAG 視覺化檢視、任務指標監控、排程管理及搜尋功能。
- **安全性與體驗**：預設支援深色模式 UI，並內建基礎驗證（Basic Auth）機制，強烈建議在生產環境啟用。

**快速啟用指南**
使用者可透過 CLI 工具自動化安裝流程，該工具會自動偵測框架、安裝對應套件、注入路由並產生環境變數範例：
```bash
npx @getworkbench/cli init
```

**手動整合步驟**
若需手動設定，請根據所使用的技術堆疊選擇對應套件。以下以 Hono 為例：
1. 安裝必要套件：
   ```bash
   npm i @getworkbench/hono bullmq hono
   ```
2. 在程式碼中掛載儀表板：
   ```ts
   import { Hono } from "hono";
   import { Queue } from "bullmq";
   import { workbench } from "@getworkbench/hono";

   const app = new Hono();
   const emailQueue = new Queue("email", { connection: { url: process.env.REDIS_URL! } });

   app.route("/jobs", workbench({ queues: [emailQueue] }));

   export default app;
   ```
設定完成後，即可透過 `http://localhost:PORT/jobs` 存取儀表板。針對 Next.js 使用者，需注意 Next.js 本身不託管 BullMQ Worker，建議將其運行於同層級的獨立處理程序中。

**配置與擴充**
Workbench 提供多項配置選項，包括：
- `queues`：指定要顯示的 BullMQ `Queue` 實例（必填）。
- `auth`：設定使用者名稱與密碼，用於生產環境保護。
- `readonly`：設定為 `true` 可停用重試、移除或提升任務等寫入操作。
- `tags`：定義 `job.data` 中的欄位，作為儀表板上的可篩選標籤。

更多詳細資訊與各框架的實作範例，請參考官方網站 [getworkbench.dev](https://getworkbench.dev) 或查看專案原始碼（`CONTRIBUTING.md`）。

## 標籤

開源專案, Web, BullMQ, Workbench
