[!info] related notes

• 家庭 Homepage 导航服务（svc-homepage-dashboard，Personal Infrastructure）
• 家庭服务器的功能
• 家庭服务器硬件选择
• 家庭服务器看板
• 家庭服务器HomeServer-MOC

Homepage

什么是 Homepage？

Homepage 是一个现代、快速、高度可定制的个人导航页（Dashboard）。

• 技术栈：基于 Next.js 和 React 构建。
• 特点：通过 YAML 配置服务卡片，也可结合 Docker 标签发现服务；通过服务端代理对接 PVE、Docker、UniFi 等 API 显示状态。实际加载速度取决于部署与集成响应，不能把它视为只有静态文件的站点。

核心配置目录 (/app/config)

Homepage 的主要 YAML 配置位于挂载到 /app/config 的目录：

1. settings.yaml：全局设置（标题、背景图、布局、语言等）。
2. services.yaml：定义服务卡片（最核心的文件）。
3. widgets.yaml：定义顶部的信息小组件（如 CPU、内存、天气、日期）。
4. bookmarks.yaml：定义简单的书签链接（不带 API 状态）。
5. docker.yaml：(可选) 如果使用 Docker Socket 自动发现功能需配置此文件。

自定义图片另挂载到 /app/public/images，通过 /images/... 引用；它不是 /app/config 内的核心 YAML 配置。