1. 项目定位与用途
LobsterBoard 定位为自托管、零云依赖的通用仪表板构建器。其核心用途是让用户通过可视化拖放方式，快速搭建个性化监控或展示面板，涵盖系统状态、天气、股票、日历等多种信息。它既可作为独立工具运行，也能与 OpenClaw 生态集成以增强监控能力，满足从个人 homelab 到小型团队的多场景信息聚合需求。
项目档案应用项目
LobsterBoard 自托管仪表板构建器：拖放编辑、60+小部件、无云依赖，Node.js 快速部署指南
LobsterBoard 是开源自托管仪表板工具，通过拖放组合系统监控、天气、金融等 60+ 小部件，支持模板分享与远程服务器监控。本文详解其安装、使用及技术特点，适用于 homelab 监控与个人 KPI 展示。
AI 总结
LobsterBoard 是一个自托管的 Node.js 拖放式仪表板构建器，提供 60+ 小部件和模板库，无需云服务或前端框架，适用于 homelab 监控、KPI 展示等场景。
中文项目介绍
LobsterBoard 是一个开源的自托管仪表板构建工具，旨在帮助用户无需编码或依赖云服务即可快速创建个性化监控视图。它通过直观的拖放式编辑器，允许用户组合系统监控、天气、金融、待办事项等 60 多种小部件，并支持模板分享、自定义页面和多主题切换。所有数据完全本地存储，确保隐私与离线可用性。项目基于纯 Node.js 服务端驱动，无前端框架依赖，采用 Rollup 打包，模块化设计清晰。除独立使用外，还可与 OpenClaw 集成获取额外监控能力，并通过 agent 实现多远程服务器统一监控，非常适合 homelab 管理、个人 KPI 展示及智能家居状态汇总等场景。
详细信息与使用说明
2. 解决的问题
项目解决了快速搭建个性化仪表板的两大痛点：一是无需编写代码或配置复杂云服务，通过拖放即可完成布局；二是确保数据隐私与离线可用性，所有数据存储在本地，避免云服务费用与数据泄露风险。同时，它通过模板库降低了重复设计成本，并通过远程 agent 解决了多服务器统一监控的难题。
3. 适用场景
主要适用场景包括：homelab 或服务器集群的集中监控（CPU、内存、磁盘、Docker 容器等）；个人生产力工具集成（待办事项、笔记、日历）；信息展示（天气、股票、RSS 订阅、AI 工具状态）；以及通过自定义页面扩展为看板或文档页。OpenClaw 用户还可额外监控任务调度与活动日志。其无云特性也适合对数据主权要求高的环境。
4. 安装方式
安装方式有两种，均基于 Node.js 环境。方式一：全局安装后使用 CLI，执行 `npm install -g lobsterboard` 然后运行 `lobsterboard` 命令（需系统已配置 npm 全局路径）。方式二：本地克隆或作为依赖安装，若克隆仓库则执行 `git clone https://github.com/Curbob/LobsterBoard.git`、`cd LobsterBoard`、`npm install`；若作为 npm 包安装则执行 `npm install lobsterboard` 后进入 `node_modules/lobsterboard` 目录。启动命令均为 `node server.cjs`，可通过环境变量 `PORT` 和 `HOST` 自定义端口与绑定地址。
5. 使用方式
启动服务器后访问 `http://localhost:8080`。按 `Ctrl+E` 进入编辑模式：从左侧侧边栏拖拽小部件到画布，使用 20px 网格吸附对齐；选中小部件后通过右侧面板调整属性（如数据源、刷新间隔、显示格式）；点击顶部 `💾 Save` 按钮保存布局。其他功能：通过顶部 `🖥️ Servers` 添加远程监控服务器；使用模板库导入/导出布局（含自动截图预览）；在编辑模式下拉菜单切换 5 种主题。所有配置自动保存至 `config.json`。
6. 补充说明与实现特点
项目技术特点包括：纯 Node.js 服务端静态资源服务，无数据库依赖；前端使用 Rollup 打包输出 UMD/ESM 格式，支持模块化引入；小部件系统高度可扩展，社区可通过 `community-widgets/` 模板贡献；远程监控依赖 `lobsterboard-agent` 独立进程，通过 SSE 推送数据；主题通过 CSS 变量实现一键切换。仓库中未明确给出移动端适配细节或官方 Docker 镜像，但因其自包含特性，可自行容器化部署。
思维导图
LobsterBoard
核心模块
服务器入口 (server.cjs)
客户端入口 (app.html)
构建系统 (Rollup)
小部件系统
60+ 内置小部件
分类：系统/天气/金融/时间等
社区扩展模板 (community-widgets/)
编辑器功能
拖放布局与网格吸附
属性面板配置
模板库导入/导出
自定义页面支持
主题与样式
5 种内置主题
CSS 主题文件 (css/themes.css)
主题持久化存储
部署与扩展
本地运行 (node server.cjs)
环境变量配置 (PORT/HOST)
远程监控 (lobsterboard-agent)
OpenClaw 集成
常见问题
如何启动 LobsterBoard 服务？
安装依赖后，在项目根目录执行 `node server.cjs` 即可启动，默认监听 8080 端口。可通过环境变量 `PORT` 和 `HOST` 自定义端口与绑定地址，例如 `PORT=3000 HOST=0.0.0.0 node server.cjs`。
如何添加远程服务器进行监控？
在远程服务器上全局安装 `lobsterboard-agent`，运行 `lobsterboard-agent init` 生成 API 密钥并 `lobsterboard-agent serve` 启动代理。然后在 LobsterBoard 编辑模式点击顶部 `🖥️ Servers`，输入服务器名称、URL（如 `http://ip:9090`）和 API 密钥，测试连接后即可在支持远程数据的小部件中选择该服务器。
LobsterBoard 支持哪些类型的小部件？
内置 60+ 小部件，涵盖系统监控（CPU、内存、磁盘、网络、Docker）、天气、时间日期、日历、RSS 订阅、金融股票、AI/LLM 工具状态、笔记待办、媒体播放等。OpenClaw 用户还可使用认证状态、定时任务、活动日志等专属小部件。
如何更换仪表板主题？
在编辑模式下，点击顶部导航栏的主题下拉菜单即可切换。内置 5 种主题：Default（深色 emoji）、Terminal（CRT 绿色）、Paper（复古羊皮纸）、Feminine（柔和粉紫）、Feminine Dark（深色粉紫）。选择后主题设置会自动保存到配置中。
仪表板配置和数据存储在哪里？
所有布局配置、小部件属性及主题选择均保存在项目根目录的 `config.json` 文件中。该文件为 JSON 格式，可直接编辑或通过界面保存更新。项目无外部数据库，所有数据本地存储，重启服务后配置依然生效。