🚀 你的专属 NAS 导航页：Homepage 部署与深度定制教程

前言：告别杂乱主页，一页掌控所有服务！

哈喽大家好！

你是不是也和我一样，在 NAS 上部署了一大堆应用和服务，每次要用的时候都要一个个输入 IP 地址和端口号，既麻烦又容易忘记？今天，我将为大家介绍一个神器——Homepage！这是一个开源、美观且功能强大的 NAS 导航页面。

本篇教程，我将手把手教你如何零基础在飞牛 NAS 上部署 Homepage。更重要的是，我将为你提供一份我精心配置好的模板文件，你只需要简单替换 IP 地址和密码，就能立刻拥有一个高颜值、功能齐全的专属导航页，实现一键管理你的所有服务！

无论你是 HomeLab 爱好者还是 NAS 新手，跟着这篇教程，都能轻松搞定，让你的 NAS 管理变得井井有条，高效又美观。

相关文件下载

下载地址

1. Homepage官网：https://gethomepage.dev/
2. MD5 在线加密网站：https://www.md5hashgenerator.com/
3. 经纬度查询网站：https://open-meteo.com/en/docs

视频教程

🎬 核心操作：Homepage Docker Compose 部署与配置

第一步：Homepage 的 Docker Compose 部署

Homepage 的部署非常简单，我们将使用 Docker Compose 来完成。

1. 创建文件夹

首先，登录你的飞牛 NAS，进入文件管理界面。在合适的位置新建一个文件夹，我习惯在 docker 文件夹内统一管理，所以在这里新建一个名为 homepage 的文件夹。

为了存放 Homepage 的配置文件，实现数据持久化，请在 homepage 文件夹内，再新建一个名为 config 的子文件夹。

2. 部署 Docker Compose

文件夹创建完成后，打开 Docker，进入 “Compose” 界面。点击 “创建 Compose”，并进行以下设置：

• 项目名称： 填写 homepage。
• 项目路径： 选择我们刚才创建的 /homepage 文件夹。

将以下 Docker Compose 代码粘贴到编辑框中。请注意，你需要根据自己的实际情况进行修改。

version: '3.3'
services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    ports:
      - 3000:3000
    volumes:
      - /vol1/1000/homepage/config:/app/config # 挂载你的配置文件目录
      - /var/run/docker.sock:/var/run/docker.sock:ro # 允许Homepage监控Docker服务
    environment:
      # 请根据你NAS上拥有该目录权限的用户的UID和GID进行替换
      PUID: 1000
      PGID: 1000
      TZ: Asia/Shanghai # 设置你的时区
      # 允许来自NAS本身IP和访问你Homepage的IP的请求
      HOMEPAGE_ALLOWED_HOSTS: 10.0.0.134:3000
    restart: unless-stopped

代码修改说明：

1. 路径挂载 (- volumes)： 将 /path/to/your/homepage/config 替换为你刚刚创建的 config 文件夹的绝对路径。最简单的方法是，回到飞牛文件管理，右键点击 config 文件夹，选择 “复制原始路径”，然后粘贴到这里。
2. 端口映射 (- ports)： 如果你的 3000 端口已被占用，请将 3000 修改为其他可用端口，但后面的 :3000 保持不变。

修改完成后，点击 “确定”。飞牛 NAS 会自动下载镜像并部署 Homepage。等待部署完成，Homepage 服务就启动了！

第二步：核心配置文件详解与修改

Homepage 部署成功后，默认页面非常基础。我们需要修改配置文件，让它变得强大起来。

1. 访问配置文件目录

由于在飞牛的文件管理中不能直接编辑 .yaml 文件，我们使用 Windows 的网络共享功能来连接和编辑。

• 打开 Windows 电脑，在文件资源管理器的地址栏输入 \\你的NAS_IP地址。
• 输入飞牛的用户名和密码，连接成功后，进入我们刚才创建的 /homepage/config 文件夹。

你会看到里面有四个核心的 .yaml 文件，它们是 Homepage 的大脑：

• settings.yaml： 负责全局设置，如主题、布局、语言、壁纸等。
• services.yaml： 核心文件，负责监控和展示你添加的 Docker 项目和服务。
• widgets.yaml： 用于添加小组件，如天气、日历、系统信息等。
• bookmarks.yaml： 负责管理页面上显示的书签链接。

2. 批量替换配置文件（推荐）

为了节省大家的时间，我已经为大家准备好了一份精心配置好的模板文件。你可以通过视频简介中的链接下载，然后用这四个文件替换掉 config 文件夹中的默认文件。

第三步：解决配置错误，实现深度定制

替换完成后，你可能会发现很多服务都显示 “API 错误”。这是因为默认配置中的 IP 地址、端口和密码都不是你的。下面我们就来逐一修改，解决这些错误。

1. 修改 services.yaml

这是最关键的一步，负责解决大部分错误。

• 打开文件： 用记事本或 VS Code 等编辑器打开 services.yaml。
• 修改 IP 和端口： 找到你部署的各个服务（如 Jellyfin、Sonarr 等），将配置中的 IP 地址 和 端口号 修改为你自己 NAS 上的实际地址。
• 密码设置（重点）：
  • 如果某个应用需要密码，请将配置中的密码修改成你的。
  • 特别注意： 如果你的应用密码是纯数字，一定要在前后加上英文引号 ""，否则 Homepage 会将其识别为数字，导致始终提示密码错误。
• API Key： 对于 Jackett 这类需要 API Key 的应用，你需要进入应用本身的设置页面，复制 API Key，然后粘贴到 services.yaml 的相应位置。
• MD5 Token（可选）： 对于某些音乐服务器等应用，可能需要一个 MD5 加密的 token。我会在视频简介中提供一个 MD5 加密网站。你只需要填入密码和自定义的盐值，生成 token 后粘贴到配置文件中即可。

修改完成后，保存 services.yaml 文件，回到 Homepage 页面刷新，你会发现大部分报错都消失了！

2. 添加更多小部件（以 Jellyfin 为例）

Homepage 还支持显示 Jellyfin 里的资源数量、最近播放等信息。

• 打开 Homepage 的官方文档，找到 Jellyfin 的小部件代码。
• 将这段代码复制到 services.yaml 文件中 Jellyfin 配置项的下方。
• 注意对齐！ YAML 文件的格式对空格对齐要求很高，请确保你的新代码与上方配置块对齐。

保存后刷新页面，你就能看到 Jellyfin 的资源统计信息了。

3. 添加新服务（以 AdGuard Home 为例）

如果你想添加我的模板中没有的服务，例如 AdGuard Home，也很简单。

• 复制 services.yaml 中一个已有的服务配置块。
• 将其名称、IP、端口、密码等信息修改为 AdGuard Home 的。
• 保存后刷新，如果出现 “缺少小部件” 错误，请检查 label 或其他配置项是否填写正确。

4. 修改 widgets.yaml 和 bookmarks.yaml

• widgets.yaml： 用于配置天气、日期、CPU 监控等小组件。你可以通过查询你所在地的经纬度，并填入配置文件中，就能显示你本地的天气了。经纬度查询网站我也会放在视频简介中。
• bookmarks.yaml： 这是书签的配置文件。你可以直接在我提供的模板基础上，自由增删和修改你常用的书签链接。

总结：你的专属仪表盘，大功告成！

经过这些配置，一个高颜值、功能强大的 Homepage 就完美呈现在你眼前了。是不是感觉整个 NAS 生态都变得井井有条了？

💡 温馨提示与常见问题

• 密码引号： 再次强调，纯数字密码一定要加引号，否则配置会失败。
• YAML 格式： YAML 文件对空格对齐非常敏感，任何对齐错误都会导致配置失败。建议使用专业的编辑器，或仔细检查对齐。
• IP 地址： 所有 IP 地址都应该是你的 NAS 在本地局域网的 IP。
• 外网访问： Homepage 默认只能在你的局域网内访问。如果需要外网访问，你可以参考我之前关于 Tailscale 等内网穿透工具的教程。

希望这篇教程能帮助你打造出理想的个人导航中心。如果你在部署或配置过程中遇到任何问题，欢迎在评论区留言或加入我的电报群组，我们一起交流探讨。