如何用Homepage搭建自托管统一导航页？配置拆解与经验分享

自托管主页仪表盘（Homepage）是一个轻量方案，能把你所有的服务和书签收进一个统一导航页。一个自托管刚满四个月的新手分享了他的配置思路：三个YAML文件搞定一切，既作首页也作服务状态监控。以下是基于实际经验整理出的实操细节。

从零到一：四个月自托管能玩出什么

这位自托管玩家从四月开始动手，之前对网络和Linux几乎一窍不通。他换掉运营商自带modem，自己跑了大量Cat6网线，搭了rack，买了PC和域名，最终把Homepage做成全家的服务入口。他说最有成就感的就是这个简单但好看的主页，上面放着每天都会访问的站点和服务。评论区也很买账，有人表示刚起步正在享受过程，有人感叹“我每次想弄一个这么详细的主页，最后都因为要手动配置而放弃”。

三个YAML文件：Homepage配置的核心

Homepage的配置分散在三个YAML文件里：书签（bookmarks）、服务（services）、设置（settings）。把这三块分开，结构就会清晰很多。评论里有人分享了具体写法：

- Bookmarks:
  - 社区站点:
    - icon: 社区站点.png
      href: https://service.example.cn/
  - 邮箱服务:
    - icon: 邮箱服务.png
      href: https://service.example.cn/
  - 视频平台:
    - icon: 视频平台.png
      href: https://service.example.cn/
  - Etsy:
    - icon: sh-etsy
      href: https://service.example.cn/
  - Unifi:
    - icon: sh-ubiquiti-unifi.webp
      href: https://service.example.cn/

图标可以直接用文件名，也可以去Homepage官网的图标库搜索，比如搜索“icons”。

布局则在settings.yaml里控制。如果想让书签只显示图标、横排放置，并放在页面顶部，可以这样配置：

layout:
  Bookmarks:
    style: row
    iconsOnly: true
    header: false
  Media Status:
    style: row
    columns: 5
    header: false
    useEqualHeights: true

注意，布局中的标题名必须和services.yaml里定义的组名一致，比如“Media Status”。要让*arr系列（Jellyfin、Radarr等）横排显示，就在settings.yaml里给对应组指定列数。services.yaml里每个服务可以带widget，用来显示实时状态：

- Media Status:
  - Jellyfin:
      href: https://service.example.cn
      icon: jellyfin.png
      description: Media streamer
      siteMonitor: https://service.example.cn
      widget:
        type: jellyfin
        url: https://service.example.cn
        key: yourkey
        version: 2
        enableBlocks: true
        enableNowPlaying: true
        enableUser: true
        enableMediaControl: false
        showEpisodeNumber: true
        expandOneStreamToTwoRows: false
  - Radarr:
      href: https://service.example.cn
      icon: radarr.png
      description: Movie management
      siteMonitor: https://service.example.cn
      widget:
        type: radarr
        url: https://service.example.cn
        key: yourkey

每个widget的完整参数可以在Homepage官网搜索对应服务名找到，直接复制即可。

自托管硬件与服务栈：普通配置也够用

评论区有人分享了自己的自托管硬件：网络用Unifi全家桶（UDM-SE、UNVR、UNAS），自托管服务跑在两个树莓派（pi-hole、unbound、nebula sync）和三个Beelink迷你主机上。这些迷你主机都是N100+16G内存，属于低成本的x86小机器，跑Jellyfin给全家人用毫无压力。这位玩家自己也说“nothing special”，但跑得很稳。

AI在配置中的价值：搜索、生成、纠错

很多人喜欢吐槽AI，但在这种自托管配置场景里，AI确实有用。有评论说：“我最喜欢拿它来搜索和生成配置文件，比如让它去翻各种论坛和知识库，省掉我自己搜索的功夫。”但也有人提到，AI偶尔会给错conf：“让它给我一个.conf，它给了，贴进去两步后又告诉我缺少某个东西。混蛋，你刚才给的conf里就没有那个。”意思是AI仍然需要人工复核，但作为搜索和生成初稿的工具，效率提升明显。

手动配置还是自动化？配置的痛点与期待

高赞评论直言：“看到这些漂亮主页就烦，每次想自己弄一个，结果全是手动配置，最后只能放弃。”这条评论得到了很多共鸣。有人喊话：“谁能写个自动化工具，扫描一下你的网络，自动生成一个差不多的主页？”这种需求的确存在，但目前的Homepage仍然以手动配置为主。好消息是，评论里也提到“我一开始觉得自己配置完了，后来发现又加DNS、Web服务器、Debian镜像、SMB共享、Netbird、Unifi设备……越来越多了”，说明自托管主页往往不是终点，而是服务扩张的开始。

如果你想开始

不用一开始就追求大而全，先把常用的三五个服务加进去，跑通一个书签和一个widget，再慢慢扩展。配置文件出问题时，用AI帮忙搜索错误信息，或者到Homepage官方文档去核对widget参数。硬件也不用贵，树莓派和N100小主机完全够入门。