Homepage 是自託管儀表板。它是一款開源、現代化的網頁應用程式,用於將所有常用的服務、鏈接、系統資訊彙整在單一介面,讓使用者免於在眾多分頁間切換。Homepage 以 JavaScript 與 TypeScript 編寫,採用 Next.js 框架,具備響應式設計與高度的自訂彈性,可部署於任何支援 Docker 的環境,尤其適合家庭實驗室、NAS 或小型伺服器使用。其核心價值在於「一眼掌握」:透過視覺化的小工具與服務卡片,即時呈現各項服務的狀態。
Homepage 提供多種可擴充的「小工具」(Widget),其中最受矚目的是「服務卡片」(Service Card)。服務卡片能顯示某個服務的名稱、圖示與連結,並藉由偵測 HTTP 狀態碼或 TCP 連接埠來判斷其是否在線。使用者可在 services.yaml 中定義多個服務,每張卡片皆可設定自訂圖示、描述與分類,並依照需求在儀表板上拖曳排列、分頁管理。另一大亮點是 Docker Widget,它透過 Docker API 直接列出本機或遠端主機上的所有容器,顯示其運行狀態、CPU 與記憶體使用率,甚至提供一鍵啟動或停止容器的控制功能。此外,Homepage 尚內建天氣、時鐘、搜尋列、書籤、RSS 訂閱、網路測速及 Pihole 等整合,亦可連接 Proxmox、Grafana 等外部服務,形成功能完整的個人資訊中樞。
部署 Homepage 非常簡易。官方提供 Docker 映像 ghcr.io/gethomepage/homepage:latest,使用 Docker Compose 時,僅需掛載 /var/run/docker.sock 以讀取容器狀態,並將設定目錄掛載至容器內的 config。一個基本範例如下:
version: "3"
services:
homepage:
image: ghcr.io/gethomepage/homepage:latest
container_name: homepage
ports:
- 3000:3000
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ./config:/app/config
restart: unless-stopped啟動後,config 目錄中的 services.yaml 與 settings.yaml 會被動態載入,修改存檔便立即生效,無需重啟容器,方便使用者即時調整版面與內容。
services.yaml 是 Homepage 的核心設定檔,負責定義服務分組、服務卡片與 Widget 整合。語法直覺,例如想建立一個「NAS」群組,並納入 Synology DSM 與 Docker 容器狀態列,可寫成:
- NAS:
- Synology DSM:
href: https://ds.example.com
description: 私有雲儲存
icon: synology
- Docker Containers:
widget:
type: docker
docker: mydocker其中 href 為服務連結,icon 可指定內建圖示集或自訂 SVG,widget 則啟用額外資訊面板。官方文件提供詳盡的參數與範例,讓使用者按需求彈性編排,打造個人化的工作環境。
Homepage 不僅是簡單的書籤頁,更是整合監控、操作與資訊聚合的輕量入口。其活躍的社群與持續更新的特性,使其成為眾多自託管家中的首選儀表板之一。
參見
外部連結
來源
自動生成(2026-08-19 容器覆蓋率補完)