Homepage翻译站点

一、网站简介

Homepage 是一款高度可定制的自托管仪表盘（Dashboard）应用，专为管理大量自托管服务的 Homelab 和 NAS 用户打造。它能将你部署的所有 Docker 容器、Web 服务和书签集中展示在一个美观的页面上，并实时显示各服务的在线状态和资源占用情况。通过简单的 YAML 配置文件，用户可以打造一个完全个性化的个人导航主页。

二、公司背景

Homepage 由开源社区开发者 Ben Phelps 创建，托管于 GitHub 并采用 GPL-3.0 开源协议。项目在 GitHub 上拥有超过 20,000 颗 Star，是同类产品中最受欢迎的自托管仪表盘工具。其活跃的社区贡献了大量的服务 Widget 和图标资源，形成了丰富的生态。

三、核心功能

• 服务仪表盘：将 Docker 容器、自托管服务按分组排列展示，每个服务卡片可显示名称、图标、描述和实时状态。支持 20 余种预设主题配色，满足不同审美需求。
• 实时状态监控：通过集成 Docker Socket，可实时显示每个容器的 CPU 使用率、内存占用量和运行状态（运行中/已停止/异常），点击卡片即可快速跳转到对应服务。
• 丰富的小组件（Widgets）：内置大量实用小组件，包括天气、RSS 阅读器、书签、搜索栏、系统信息（磁盘、CPU）、日历、股票行情、GitHub 通知等，让首页不仅是导航，更是信息中心。
• API 集成：支持与 Sonarr、Radarr、Plex、Jellyfin、qBittorrent 等主流自托管应用深度集成，直接在首页展示下载进度、最近添加的媒体内容等动态信息。
• 多页面布局：支持创建多个标签页，可将不同类型的服务（如影音、开发、监控）分别放在独立页面上，避免单一页面过于拥挤。

四、网站特点

• 极致自定义：从布局、配色、图标到信息展示内容，一切皆可通过 YAML 配置文件自由定义。
• 轻量高性能：前端采用静态页面技术，加载速度极快，内存占用仅约 150-250 MB，适合资源受限的 NAS 设备。
• 生态完善：社区贡献了大量服务图标和小组件配置模板，新手也能快速上手。
• 自动服务发现：挂载 Docker Socket 后，可自动发现运行中的容器并显示其状态信息。

五、适用人群

• Homelab 重度用户：在家庭服务器上运行数十个自托管服务，需要一个统一的入口页面进行管理。
• NAS 玩家：希望将群晖或威联通上部署的各种 Docker 应用整合到一个美观的仪表盘中。
• 浏览器起始页定制者：希望将浏览器主页替换为一个集导航、信息展示于一体的个性化页面的用户。

六、应用场景

• 场景一——家庭服务器总控台：一位 Homelab 玩家在 N100 小主机上部署了 Jellyfin、Immich、Home Assistant、qBittorrent 等十几个服务，通过 Homepage 搭建了一个包含所有服务入口、实时资源占用和天气信息的统一仪表盘，设为浏览器首页后一目了然。
• 场景二——影音中心导航：用户将所有影音相关服务（Plex、Sonarr、Radarr、Overseerr）放在一个分组中，配合小组件实时显示正在下载的影视内容和最近添加的剧集，打造家庭影音控制中心。
• 场景三——多设备统一入口：通过内网穿透或反向代理将 Homepage 暴露到公网，用户在外出时也能通过手机浏览器快速访问家中的各项服务。

七、常见问题（FAQ）

Q：国内能否直接访问？
A：Homepage 本身是自托管应用，部署在国内服务器或 NAS 上可正常使用。但从 GitHub 拉取镜像时可能遇到网络延迟，建议使用国内镜像加速服务。

Q：Homepage 与其他仪表盘（如 Dashy、Homarr）有何区别？
A：Homepage 的最大特点是纯 YAML 配置驱动，无内置编辑器，需要手动编辑配置文件。对于喜欢精细控制的极客用户，这种方式的灵活性极高；对于偏好图形化编辑的用户，可能 Homarr 或 Dashy 更合适。

Q：是否必须挂载 Docker Socket？
A：不挂载 Docker Socket 也能正常使用基本功能（如链接导航、书签、天气小组件），只是无法自动获取容器的运行状态和资源信息。

Q：如何添加自定义图标？
A：Homepage 内置了大量服务图标，也支持使用自定义 PNG 图标或直接引用 Simple Icons、Dashboard Icons 等在线图标库的图标。

八、类似网站

• Dashy：功能丰富的自托管仪表盘，提供可视化编辑器，配置更直观。
• Homarr：轻量简洁的仪表盘方案，支持拖拽式布局编辑。
• Glance：极简风格的信息聚合起始页，侧重于 RSS、天气等信息的展示。