家庭实验室仪表盘Labby

发布时间:2026/7/2 4:06:25

家庭实验室仪表盘Labby 简介什么是 Labby Labby是一个开源的自托管家庭实验室仪表盘轻量如Glance交互如Homarr。它使用单个Bun进程运行配置存储在小型SQLite数据库中支持应用内编辑。主要特点丰富的 Widget 组件支持服务监控、Docker、qBittorrent/Transmission、SABnzbd、AdGuard、Jellyfin、Emby、Plex、Beszel、Radarr、Sonarr、Reelward、天气、日历、速度测试、Reddit、Hacker News等多种集成实时更新服务器轮询集成并通过SSE推送更改无需客户端轮询确保数据实时性交互式控制支持启动/停止Docker容器、暂停/恢复下载任务、切换AdGuard保护等功能配置与凭据管理配置存储在SQLite数据库中支持Zod验证可通过应用内的「管理服务」页面编辑服务URL和密钥主题定制支持命名颜色方案保存到数据库首次加载无闪烁开源免费基于MIT协议开源可免费使用和修改应用场景Homelab 服务监控统一查看所有自托管服务的运行状态包括NAS、媒体服务器、下载工具、网络工具等Docker 容器管理通过Web界面直接启动、停止容器无需登录服务器命令行下载任务管理控制qBittorrent、Transmission等下载客户端暂停、恢复下载任务网络工具集成集成AdGuard、Pi-hole等网络工具一键切换保护状态媒体库管理查看Jellyfin、Emby、Plex等媒体服务器状态管理电影、剧集等媒体资源开发测试环境开发人员可以快速搭建统一的测试环境入口Labby是一个轻量级、功能丰富的家庭实验室仪表盘帮助Homelab爱好者统一管理和监控所有自托管服务。通过丰富的Widget组件和实时更新功能用户可以轻松查看服务状态、控制Docker容器、管理下载任务等。安装在群晖上以 Docker 方式安装。本文写作时latest版本对应为1.5.0镜像托管在ghcr.io群晖Docker套件无法直接搜索需要通过命令行拉取镜像。docker cli 安装如果你熟悉命令行可能用docker cli更快捷# 新建文件夹 labby 和 子目录mkdir-p/volume1/docker/labby/config# 进入 labby 目录cd/volume1/docker/labby# 修改目录权限chmodarw config# 一键启动dockerrun-d\--namelabby\--restartunless-stopped\-p8425:8080\-v/volume1/docker/labby/config:/app/config\ghcr.io/samuelloranger/labby:latestdocker-compose 安装也可以用docker-compose安装将下面的内容保存为docker-compose.yml文件version:3.8services:labby:image:ghcr.io/samuelloranger/labby:latestcontainer_name:labbyrestart:unless-stoppedports:-8425:8080volumes:-./config:/app/config# 配置文件目录然后通过SSH登录到您的群晖执行下面的命令# 新建文件夹 labby 和 子目录mkdir-p/volume1/docker/labby/config# 进入 labby 目录cd/volume1/docker/labby# 修改目录权限chmodarw config# 将 docker-compose.yml 放入当前目录# 一键启动docker-composeup-d配置用户配置存储在SQLite数据库中。无效配置会显示错误状态而不会导致服务器崩溃。服务凭据和实例设置监控站点、天气位置、Docker主机、下载客户端 URL 等存储在integrations表中。仪表盘组件通过integrationId引用集成仅携带显示选项标题、布局样式、最大项目数。轮询频率在集成行中设置refreshSeconds而不是在仪表盘 JSON 中。所有配置都从「管理服务」页面进行无需.env文件或环境变量。内置集成类型配置说明monitorHTTP 站点检查每个站点的标题、URL、图标docker读/写 Docker 主机容器过滤器running/allqbittorrentURL、用户名、密码transmissionURL、用户名、密码sabnzbdURL、API 密钥adguardURL、用户名、密码jellyfinURL、API 密钥embyURL、API 密钥plexURL、令牌beszelURL、用户名、密码、令牌radarrURL、API 密钥sonarrURL、API 密钥reelwardURL、API 密钥weatherOpenWeather API 密钥、城市或经纬度、单位calendarICS 订阅 URL每行一个speedtestSpeedtest Tracker URL、API 令牌reddit合并为一个订阅源的 Subredditshackernews无需配置Algolia 前端您可以添加多个相同类型的集成例如两个Radarr实例 - 每个都有自己的行、轮询间隔和SSE通道int:id。Docker 集成配置要实现对Docker容器的交互式控制启动/停止需要通过Docker Socket Proxy方式连接。注意Labby的Docker集成UI只支持http://、https://和s3://格式的URL不支持unix://格式的socket路径。因此需要使用Docker Socket Proxy将Unix socket 转换为HTTP API。方案一使用 Docker Socket Proxy推荐使用tecnativa/docker-socket-proxy作为中间代理将 Docker socket 转换为 HTTP APIversion:3.8services:labby:image:ghcr.io/samuelloranger/labby:latestcontainer_name:labbyrestart:unless-stoppedports:-8425:8080volumes:-./config:/app/config# 配置文件目录depends_on:-docker-proxydocker-proxy:image:tecnativa/docker-socket-proxy:latestcontainer_name:docker-proxyrestart:unless-stoppedvolumes:-/var/run/docker.sock:/var/run/docker.sock:ro# 挂载 Docker Socket只读environment:-CONTAINERS1# 允许容器操作-POST1# 允许 POST 请求在Labby中添加Docker集成时host填写http://docker-proxy:2375在Labby中添加Docker集成时如果想控制Docker启停需要配置两个字段RO Host只读主机http://docker-proxy:2375用于查看容器列表、日志等只读操作RW Host读写主机http://docker-proxy:2375用于启动、停止、重启容器等操作方案二群晖 DSM 6.2 直接开放 Docker TCP不推荐如果不想使用Docker Socket Proxy可以在群晖上直接开放Docker TCP API第一步修改 Docker 配置文件通过SSH登录群晖编辑Docker配置文件# 备份原始配置sudocp/var/packages/Docker/etc/dockerd.json /var/packages/Docker/etc/dockerd.json.bak# 编辑配置文件sudovi/var/packages/Docker/etc/dockerd.json在配置文件中添加hosts字段保留原有内容{registry-mirrors:[],hosts:[unix:///var/run/docker.sock,tcp://0.0.0.0:2375]}第二步重启 Docker 服务sudosynoservice--restartpkgctl-Docker第三步验证端口是否开放netstat-tuln|grep2375如果显示tcp 0 0 0.0.0.0:2375 0.0.0.0:* LISTEN说明配置成功。第四步在 Labby 中添加 Docker 集成host填写http://群晖IP:2375如http://192.168.0.199:2375安全警告直接暴露Docker TCP API会赋予完全控制宿主机Docker的权限相当于root权限。请确保仅在内网或VPN环境下使用不要暴露到公网配置防火墙规则仅允许特定IP访问2375端口图标icon字段接受带前缀的字符串前缀示例di:di:jellyfin- dashboard-icons构建时内置CDN 回退sh:sh:immich- selfh.stlucide:lucide:film- 内置线条图标URL / 路径https://...或/icons/custom.svg刷新间隔在「管理服务」页面为每个集成设置轮询频率refresh Seconds默认值来自集成类型。浏览器通过SSE接收更新而不是自己的定时器。运行在浏览器中访问http://群晖IP:8425即可进入Web界面。点击页面右上角的数据库图标进入Manager services在「管理服务」页面添加您的服务URL和凭据根据需要添加不同的集成Docker、Jellyfin、qBittorrent等配置完成后仪表盘会自动显示各个服务的状态进入docker查个日志或者启停都是可以的注意事项无认证功能Labby本身没有认证机制请确保在反向代理后面运行或仅在局域网/VPN内访问目录权限config/目录必须对容器运行的用户可写否则会出现SQLITE_READONLY错误。如果遇到权限问题可以在docker-compose.yml中添加user: uid:gid配置数据持久化所有配置和数据都保存在config/labby.db文件中定期备份此文件即可完整备份Labby数据端口冲突确保本地端口8425没有被其他服务占用如有冲突请修改端口映射安全建议不要将Labby暴露到公共互联网除非有网络级别的访问控制参考文档samuelloranger/labby: Self-hosted homelab dashboard — lightweight like Glance, interactive like Homarr地址https://github.com/samuelloranger/labbyLabby - Docker 镜像地址https://ghcr.io/samuelloranger/labby

相关新闻