我给极空间装了个科幻控制台：Homepage部署实录

前言

浏览器首页这件事，估计不少人折腾过。书签栏越加越长，真正想找的时候反而翻不到；各种管理后台散落在不同标签页，切来切去效率很低。尤其是跑了一堆自建服务的NAS用户，服务多了管理成本也跟着上来。

Homepage是专门解决这个问题的。

它是一个面向Docker和Home Lab用户的仪表盘工具，本质上是一个可以自定义布局的服务入口页面。跑起来之后，你所有的自建服务------媒体库、下载站、笔记系统、监控面板------都在一个界面里按分组排列，点击直达。深色主题加卡片式布局，视觉上确实有点"科幻指挥中心"的味道。配合实时小部件，CPU状态、网络情况、Docker容器状态都能直接看。

部署在极空间上，Docker一条命令跑起来，配好cpolar穿透之后公网也能访问。配置通过YAML文件管理，Git版本控制，迁移和同步都比较方便。

整个搭建过程不复杂，下面是完整记录。

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）登录：

shell 复制代码

ssh root@IP

2.2验证docker是否开启

使用命令：

shell 复制代码

docker -v 
systemctl status -v

3.部署Homepage

通过Docker部署Homepage：

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

shell 复制代码

docker --version

shell 复制代码

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

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

shell 复制代码

vi docker-compose.yml

shell 复制代码

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

启动容器：

shell 复制代码

docker-compose up -d

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

4.使用Homepage

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

shell 复制代码

vi services.yaml

shell 复制代码

- 搜索引擎:
    - 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文件，添加自己常用设置，让它看起来更加简洁：

shell 复制代码

vi settings.yaml

shell 复制代码

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

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

shell 复制代码

vi bookmarks.yaml

shell 复制代码

- 书签:
    - 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加密链接。从此，无论你在咖啡馆、出差途中，还是用手机临时查看服务状态，你的科幻感家庭控制台始终触手可及------真正实现 "我的仪表盘，全球随行"。