Homepage：现代化自托管应用仪表板全面解析-优快云博客

Homepage：现代化自托管应用仪表板全面解析

【免费下载链接】homepage 一个高度可定制的主页（或起始页/应用程序仪表板），集成了Docker和服务API。项目地址: https://gitcode.com/GitHub_Trending/ho/homepage

你是否还在为管理众多自托管服务而烦恼？是否希望有一个统一的界面来监控和访问所有应用？Homepage作为一款现代化自托管应用仪表板，将为你解决这些问题。本文将全面解析Homepage的功能特性、安装配置、自定义方法以及实际应用场景，帮助你快速上手并充分利用这款强大的工具。读完本文，你将能够：了解Homepage的核心优势、掌握多种安装方式、学会配置和定制个性化仪表板、熟练使用各类小部件以及进行基本的故障排除。

核心功能与优势

Homepage是一个高度可定制的主页（或起始页/应用程序仪表板），集成了Docker和服务API。它具有以下核心功能和优势：

快速高效：网站在构建时静态生成，实现即时加载，让你无需等待即可快速访问所需信息。
安全可靠：所有对后端服务的API请求都经过代理，有效隐藏你的API密钥，并且社区会不断对其进行安全加固，确保使用安全。
广泛兼容：为AMD64、ARM64架构构建镜像，支持多种设备和平台。
多语言支持：支持超过40种语言，满足不同地区用户的需求。
服务与网页书签：可在主页上添加自定义链接，方便快速访问常用服务和网页。
Docker集成：支持Docker容器状态和统计信息的显示，并可通过标签自动发现服务。
丰富的服务集成：支持超过100种服务集成，包括流行的*arr应用和大多数自托管应用。
信息与实用小部件：提供天气、时间、日期、搜索等多种信息和实用小部件。

安装部署指南

Homepage提供了多种安装方式，你可以根据自己的需求和环境选择适合的方式。

Docker安装

使用Docker Compose是推荐的安装方式，简单方便且易于管理。以下是Docker Compose的配置示例：

services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    ports:
      - 3000:3000
    volumes:
      - /path/to/config:/app/config  # 确保本地配置目录存在
      - /var/run/docker.sock:/var/run/docker.sock  # 可选，用于Docker集成
    environment:
      HOMEPAGE_ALLOWED_HOSTS: gethomepage.dev  # 必填，可能需要端口

你也可以使用Docker Run命令进行安装：

docker run -p 3000:3000 -e HOMEPAGE_ALLOWED_HOSTS=gethomepage.dev -v /path/to/config:/app/config -v /var/run/docker.sock:/var/run/docker.sock ghcr.io/gethomepage/homepage:latest

如果你希望以非root用户身份运行容器，可以通过设置PUID和PGID环境变量来实现。详细信息可参考Docker安装文档。

从源代码安装

如果你熟悉开发环境，也可以选择从源代码安装Homepage。首先，克隆仓库：

git clone https://gitcode.com/GitHub_Trending/ho/homepage

然后安装依赖并构建生产包：

pnpm install
pnpm build

首次启动时，将src/skeleton目录复制到config/目录以填充初始示例配置文件。最后，以生产模式运行服务器：

pnpm start

配置与自定义

Homepage提供了丰富的配置选项，让你可以根据自己的喜好和需求定制仪表板。

基本配置

配置文件主要包括services.yaml、widgets.yaml等，你可以在这些文件中定义服务、小部件等内容。例如，在services.yaml中定义服务及其小部件：

- Plex:
    icon: plex.png
    href: https://plex.my.host
    description: 观看电影和电视节目。
    server: localhost
    container: plex
    widgets:
      - type: tautulli
        url: http://172.16.1.1:8181
        key: aabbccddeeffgghhiijjkkllmmnnoo
      - type: uptimekuma
        url: http://172.16.1.2:8080
        slug: aaaaaaabbbbb

小部件配置

Homepage有两种类型的小部件：信息小部件和服务小部件。

信息小部件用于在头部显示有关系统或环境的信息，定义在widgets.yaml文件中。例如：

- openmeteo:
    label: 当前
    latitude: 36.66
    longitude: -117.51
    cache: 5

服务小部件用于显示服务状态，通常是Web服务或API，定义在services.yaml文件中。详细的小部件配置方法可参考小部件文档。

布局调整

信息小部件按照在widgets.yaml文件中定义的顺序显示。你可以通过在文件中移动小部件来更改它们的顺序。不过，有些小部件（如天气、搜索和日期时间）会对齐到屏幕右侧，这可能会影响小部件的布局。

你还可以为信息小部件添加链接，例如：

logo:
  href: https://example.com
  target: _blank  # 可选，可在设置中设置

小部件应用场景

Homepage提供了丰富的小部件，可应用于各种场景，以下是一些常见的应用场景：

服务监控

通过服务小部件，你可以实时监控各种服务的状态，如Plex、Radarr、Sonarr等。例如，使用Plex小部件可以查看当前的媒体播放状态和服务器信息，让你随时了解服务运行情况。

系统信息展示

利用信息小部件，你可以在仪表板上展示系统的关键信息，如天气、时间、日期等。天气小部件可以显示当前和未来几天的天气情况，帮助你合理安排活动；时间和日期小部件则让你随时掌握时间信息。

快速访问入口

通过添加服务和网页书签，Homepage可以成为你访问各种服务和网页的快速入口。你可以将常用的自托管服务、网站链接添加到主页上，一键即可访问，提高工作效率。

故障排除与支持

在使用Homepage的过程中，如果你遇到问题，可以参考以下故障排除和支持资源：

文档：Homepage文档网站提供了详细的配置指南和使用说明，是解决问题的首选资源。
故障排除指南：故障排除指南可以帮助你发现许多基本的配置或网络问题，如果你遇到问题，这是一个很好的起点。
社区支持：如果你有任何问题、建议或一般性问题，可以在Discussions页面上发起讨论，社区成员会尽力帮助你解决问题。

总结与展望

Homepage作为一款现代化自托管应用仪表板，凭借其快速高效、安全可靠、广泛兼容、高度可定制等特点，为用户提供了一个统一管理和监控自托管服务的理想平台。通过本文的介绍，你已经了解了Homepage的核心功能、安装配置方法、自定义方式以及故障排除等内容。

随着自托管服务的不断普及和发展，Homepage也将不断更新和完善，为用户提供更多功能和更好的使用体验。如果你还没有尝试过Homepage，不妨立即安装部署，感受它带来的便捷和高效。

希望本文对你有所帮助，祝你使用Homepage愉快！

【免费下载链接】homepage 一个高度可定制的主页（或起始页/应用程序仪表板），集成了Docker和服务API。项目地址: https://gitcode.com/GitHub_Trending/ho/homepage

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考