家庭服务器看板

一句话定义

家庭服务器看板（Homelab Dashboard）是一个自托管的 Web 页面，将所有分散的自建服务集中展示在一个界面中，提供快速入口和实时状态监控。

核心机制 / 工作原理

看板工具本质上是一个静态或轻动态的 Web 应用：

1. 用户在配置文件（YAML/JSON/数据库）中定义服务列表（名称、URL、图标）。
2. 看板前端渲染卡片/图标网格，每个卡片链接到对应服务。
3. 看板后端定期 ping 各服务或调用 API，获取状态和统计数据。
4. 部分看板支持 widget 集成（天气、系统资源、Docker 容器状态等）。

主流工具对比

工具	配置方式	Widget 支持	Docker 集成	特点
Homepage	YAML 文件	丰富（100+ widget）	自动发现	最活跃、配置即代码
Homarr	Web UI 拖拽	中等	支持	无代码配置、界面美观
Heimdall	Web UI	基础	无	最轻量、支持应用索引
Glance	YAML 文件	中等	无	极轻量、Go 编写、速度快
Organizr	Web UI	中等	无	支持多 tab 分组、用户管理

关键功能

• 服务状态监控：绿灯/红灯显示服务是否在线，部分支持响应时间图表。
• 快速链接：一键跳转到各个服务的 Web 界面。
• Widget 集成：显示服务器 CPU/内存、Docker 容器状态、天气、书签、RSS 等。
• 搜索集成：统一搜索栏，可直接发起 Google/百度搜索或内部服务搜索。
• 分组与布局：按类别（媒体、工具、开发）分组展示。

部署方式

最常见的方式是 Docker Compose：

# Homepage 示例
services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    ports:
      - 3000:3000
    volumes:
      - ./config:/app/config   # YAML 配置目录
      - /var/run/docker.sock:/var/run/docker.sock  # Docker 集成

配置文件 services.yaml：

- 媒体:
    - Jellyfin:
        href: http://192.168.1.100:8096
        icon: jellyfin
        description: 家庭影院
- 工具:
    - Vaultwarden:
        href: http://192.168.1.100:8222
        icon: vaultwarden
        description: 密码管理

最小例子

用 Homepage 5 分钟搭建看板：

1. docker compose up -d 启动容器
2. 编辑 services.yaml 添加 3-5 个常用服务
3. 访问 http://localhost:3000 查看效果
4. 可选：添加 docker.yaml 启用 Docker 容器自动发现

边界与常见误解

• 看板不是监控系统（那是 Grafana/Prometheus 的事），看板侧重快速访问。
• 看板不需要认证即可使用，但暴露在公网时应加反向代理 + 认证。
• Homepage 和 Homarr 不是同一个项目，名字相似但架构完全不同。
• 看板本身几乎不消耗资源，适合跑在任何低功耗设备上。

Related notes

• [[homelab|家庭实验室]]
• Docker
• [[reverse-proxy|反向代理]]
• [[self-hosting|自托管]]