[!info] related notes

• Homepage
• 家庭服务器的功能
• 家庭服务器硬件选择
• 家庭服务器看板
• 家庭服务器HomeServer-MOC

Homepage

什么是 Homepage？

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

• 技术栈：基于 Next.js 和 React 构建。
• 特点：静态生成，加载速度极快；支持通过 Docker 标签或 YAML 文件自动发现服务；集成多种第三方 API（如 PVE, Docker, UniFi 等）显示实时状态。

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

Homepage 的所有配置都位于挂载的 config 目录下，主要包含以下核心 YAML 文件：

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