为什么需要个人仪表盘

作为 Self-hosted 自建服务的爱好者，我在家里的 Mac Mini 上搭建了很多自部署的服务，这些服务都有自己的地址和端口号，日常使用的时候如果频繁自己输入会非常麻烦，也容易忘记，所以需要一个地方来集中记录和管理。除此之外，个人仪表盘通常也能够提供服务的健康度检测，方便第一时间发现和排查断线的服务。 

很长时间以来我都是 Homarr 的用户，但在更新1.0版本以后，它的内存占用急剧增加，最高可能达到1GB，这对于一个简单的仪表盘应用来说是不可接受的。开发者接到反馈以后也很长时间都没有修复这个问题，可能是因为资源和时间不足。

所以我转移到了更为轻量化的 Homepage，Homepage 具有好看的 UI，基础功能配置也比较简单， 同时也提供了丰富的插件生态，对各种需要监控的服务数据都有很好的支持。 最重要的是，它的内存占用量只有100到200 MB。

用 Docker 搭建 Homepage

Homepage 的搭建也非常简单，我个人使用 Docker Compose 来安排我的 HomeLab 中的所有应用，以下是官方提供的 Docker Compose 配置：

services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    environment:
      HOMEPAGE_ALLOWED_HOSTS: gethomepage.dev # 必须配置，访问仪表盘的域名
      PUID: 1000 # 可选
      PGID: 1000 # 可选
    ports:
      - 3000:3000
    volumes:
      - /path/to/config:/app/config # 挂载的配置文件位置
      - /var/run/docker.sock:/var/run/docker.sock:ro # 可选，如果需要和其他服务通讯的话记得配置一下
    restart: unless-stopped

或者是等效的 Docker Run 命令：

docker run --name homepage \
  -e HOMEPAGE_ALLOWED_HOSTS=gethomepage.dev \
  -e PUID=1000 \
  -e PGID=1000 \
  -p 3000:3000 \
  -v /path/to/config:/app/config \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  --restart unless-stopped \
  ghcr.io/gethomepage/homepage:latest

刚创建好的 Homepage 默认只有少部分书签，UI 样式也很原始，接下来就是很重要的配置阶段。

配置 Homepage

相较于其他使用图形界面配置的个人仪表盘， Homepage 在配置的时候更多地依赖文本编辑器和 YAML 格式的配置文件。 这可能让 Homepage 的配置看起来有一点复杂，不太适合新手，但得益于现在AI技术的发展，我们可以直接将配置文档扔给AI，也可以在 Cursor 等编辑器中，让AI帮我们撰写配置文件，只需要清晰地描述自己的需求即可。  

接下来，我将会用我自己的配置文件来逐一讲解。 

基础结构

Homepage 的配置文件分散在 Config 文件夹中，根据功能分成了多个不同的 YAML 文件。与Config文件夹相邻的Background文件夹，则主要用于放置我们用作背景图片的图片资源。

系统配置: settings.yaml

settings.yaml 主要用于系统的外观以及 UI 的布局，还有接口供应商等。

在上面的配置文件中，我调整了背景的图片，调整了背景和卡片的模糊、毛玻璃效果，以及设置了语言类型，还有基于行的四列式布局。  

书签配置：bookmark.yaml

bookmark.yaml主要用于配置书签。  我们可以将自己平时常用的网站添加进去，作为一个链接入口。 

服务配置: services.yaml

服务配置文件 services.yaml是整套系统中最核心的配置文件。  我们将会在这里定义我们需要的各类系统服务。 服务类型主要分为两类:

• 普通服务配置，主要都包含一个图标，一个链接地址，以及一个健康检测地址。
• 带集成插件的复合式服务配置，例如上述的 qbittorrent，他的下方附带了一个 widget 区块，用于添加插件集成，可以在仪表盘中展示额外的信息。

他们具有一些通用的属性需要配置：

• icon：服务的图标，如果不配置的话会以服务的首字母作为图标
• href：服务的地址，通常会填写内网地址，例如我的 qbittorrent 的地址是 http://192.168.1.5010
• siteMonitor: 健康度检测用的地址，Homepage 会通过 ping 这个地址来检测服务是否可用，并提供响应的时间。

小结

Homepage 虽然配置较为繁琐，但鉴于 HomeLab 服务一旦部署后并不会经常改动，所以只需要处理配置好即可使用很长时间。Homepage 具有资源占用小、UI 好看等特点，非常推荐大家尝试一下。