NAS应用太多总记不住端口？Homepage部署与家庭控制台教程

原创于 2026-09-11 14:27:13 发布 · 6.3k 阅读

45 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

前言

极空间中部署的应用越来越多以后，博客、笔记、下载工具、网盘和容器后台往往都有各自的IP地址与端口。使用次数一多，仅靠浏览器收藏夹很难快速区分这些入口。

Homepage是一套面向NAS和家庭服务器用户的自托管仪表盘。它可以把不同服务整理成分组卡片，并通过图标、描述、书签和主题设置，建立一个统一的浏览器首页。

Homepage采用YAML文件管理配置。服务入口、书签和界面选项都可以保存在极空间目录中，修改文件并刷新页面后即可看到效果，后续也便于备份和迁移。

本文将通过Docker Compose在极空间中部署Homepage，并分别配置services.yaml、settings.yaml和bookmarks.yaml。最后再使用 cpolar 为3344端口建立公网入口，让人在其他网络环境中也能打开这套家庭服务导航页。

1.什么是Homepage？

核心特点

为 Docker 和自建服务而生

原生支持通过 Docker Compose 部署；
可自动发现局域网中的服务（如通过 docker.sock 获取容器信息）；
轻松集成 Plex、Jellyfin、Home Assistant、Portainer、Immich、Radarr、Sonarr、qBittorrent 等主流自建应用。

极简但强大：配置即代码（YAML 驱动）

所有布局、分组、图标、链接均通过 services.yaml、widgets.yaml 等配置文件定义；
支持 Git 管理配置，便于版本控制与多设备同步；
无需数据库，启动快，资源占用低。

高颜值 + 电影感 UI

默认采用深色主题，搭配清晰图标与卡片式布局；
支持响应式设计，适配桌面、平板甚至手机浏览器；
可嵌入实时小部件（Widgets），如系统状态、天气、时间、Docker 容器状态等，营造“科幻控制台”氛围。

完全本地运行，隐私优先

不依赖任何外部 API 或云服务；
所有数据存储在本地，无追踪、无广告、无遥测；
适合对隐私和数据主权有高要求的用户。

灵活扩展，自由定制

支持自定义 CSS 主题；
可添加书签、快捷链接、分类标签；
小部件（Widgets）支持 CPU/内存监控、网络状态、日历、待办事项等（部分需配合其他服务如 Glances、Uptime Kuma）。

典型使用场景

家庭服务器首页：打开浏览器就看到所有服务入口
NAS 控制面板：聚合媒体、下载、备份、监控等功能
开发者工作台：快速跳转到本地开发环境、文档、数据库
极客数字桌面：打造如《钢铁侠》中 J.A.R.V.I.S. 风格的交互界面

官方资源

GitHub：https://github.com/gethomepage/homepage
官网/Demo：https://gethomepage.dev
配置文档：https://gethomepage.dev/latest/config/

如果你厌倦了在浏览器里翻找十几个书签，或者想让自己的Home Lab更像一部科幻电影，那么Homepage，就是你一直在找的那个“终极桌面”。

2.前提条件

2.1ssh远程连接到极空间

开启【SSH 服务】
使用终端（Windows PowerShell / Mac Terminal）登录：

ssh root@IP

2.2验证docker是否开启

使用命令：

docker -v 
systemctl status -v

3.部署Homepage

通过Docker部署Homepage：

在开始部署之前，确保你的系统已经安装了Docker。可以通过以下命令检查 Docker 是否已安装：

docker --version

mkdir -p /docker/homep
chmod -R 777 /homep

创建并编辑 docker-compose.yml文件：

vi docker-compose.yml

version: "3.3"

services:
  homepage:
    image: ghcr.io/benphelps/homepage:latest
    container_name: homepage
    ports:
      - 3344:3000
    volumes:
      - ./config:/app/config
      - ./icons:/app/public/icons
      - /var/run/docker.sock:/var/run/docker.sock

启动容器：

docker-compose up -d

部署完成后，在浏览器中输入 http://极空间IP:3344 就能看到Homepage的界面：

4.使用Homepage

编辑/docker/homep/config目录下的services.yaml文件，添加自己常用的网站：

vi services.yaml

- 搜索引擎:
    - Google:
        icon: google.png
        href: https://google.com
        description: 一个好用的搜索引擎
    - 百度:
        icon: baidu.svg
        href: https://baidu.com
        description: 一个可能好用的搜索引擎

- 网盘:
    - 百度网盘:
        icon: baidudrive.png
        href: https://pan.baidu.com

    - 阿里云盘:
        icon: alidrive.png
        href: https://www.alipan.com

    - 123云盘:
        icon: 123pan.png
        href: https://www.123pan.com/
- Nas必备:
    - typecho:
        href: http://localhost:90
        description: 打造个人网页

    - onenav:
        href: http://localhost:3080
        description: 便签

    - logseq:
        href: http://localhost:9090
        description: 日记😎

刷新网页即文件生效：

编辑/docker/homep/config目录下的settings.yaml文件，添加自己常用设置，让它看起来更加简洁：

vi settings.yaml

  language: zh-CN # 中文
  theme: light # 白色主题
  color: gray # 设置颜色并禁用调色盘
  hideVersion: true # 隐藏版本号

编辑/docker/homep/config目录下的bookmarks.yaml文件，用于配置书签:

vi bookmarks.yaml

- 书签:
    - Github:
        - abbr: GH
          href: https://github.com/

    - Reddit:
        - abbr: RE
          href: https://reddit.com/

    - YouTube:
        - abbr: YT
          href: https://youtube.com/

刷新网页即文件生效：

更多功能留给你们来挖掘：

部署好Homepage后，你的家庭控制台在本地网络中已然熠熠生辉——但问题来了：一旦离开家，这些精心组织的服务入口就“失联”了。难道只能守着路由器才能享受这份极客秩序？

别担心，cpolar正是打通这最后一公里的关键。作为一款简单高效的内网穿透工具，cpolar能将你本地运行的Homepage服务安全地映射到公网，无需公网IP、无需复杂端口转发，只需一条命令，就能生成一个HTTPS加密链接。从此，无论你在咖啡馆、出差途中，还是用手机临时查看服务状态，你的科幻感家庭控制台始终触手可及——真正实现 “我的仪表盘，全球随行”。