使用
Linux x86_64
git clone 儲存庫,並透過 npm 安裝 pnpm
git clone --depth 1 https://github.com/gethomepage/homepage.git && npm install -g pnpmpnpm install
cd homepage && pnpm installpnpm build
cd homepage && pnpm build
README 與實測不符之處
- README 寫: pnpm install / pnpm build
實際可行: 未預先安裝 pnpm;需先執行 npm install -g pnpm
確認能用
curl -sS -f http://localhost:3000/api/healthcheck輸出應包含「up」。
先試試這個
cd homepage && mkdir -p config && cp -rn src/skeleton/* config/ && cat > config/services.yaml <<'EOF'
- Media:
- Self:
href: http://localhost:3000/
description: Homepage itself
widget:
type: customapi
url: http://localhost:3000/api/healthcheck
mappings:
- field: status
label: Status
- Sonarr:
href: http://localhost:8989/
widget:
type: sonarr
url: http://localhost:8989
key: dummy
EOF
cat > config/bookmarks.yaml <<'EOF'
- Developer:
- Github:
- abbr: GH
href: https://github.com/
EOF
cat > config/widgets.yaml <<'EOF'
- datetime:
text_size: xl
format:
timeStyle: short
- search:
provider: duckduckgo
target: _blank
- openmeteo:
label: Berlin
latitude: 52.52
longitude: 13.41
units: metric
EOFcd homepage && HOMEPAGE_ALLOWED_HOSTS=localhost:3000 pnpm startcurl -sS -f http://localhost:3000/api/healthcheck在 homepage 資料夾執行 HOMEPAGE_ALLOWED_HOSTS=localhost:3000 pnpm start,再用瀏覽器開啟 http://localhost:3000。
它能做什麼
- 加入服務與網頁書籤已測試
怎麼使用
- 用
mkdir -p config && cp -rn src/skeleton/* config/建立設定資料夾,再於config/services.yaml列出服務、在config/bookmarks.yaml列出連結。 - 用
HOMEPAGE_ALLOWED_HOSTS=localhost:3000 pnpm start啟動儀表板。 - 用
curl -sS -f http://localhost:3000/api/bookmarks檢查書籤。
- 用
- 加入超過 100 種服務的小工具沒有看到它可用
- 從 label 自動找出 Docker 服務未測試
- 顯示天氣、時間、日期與搜尋小工具沒有看到它可用
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以啟動
- 4 項功能中 1 項可用
- 可離線使用
適合用來
- 在儀表板顯示 Docker 容器的狀態與統計
- 監控 Sonarr、Radarr、Plex 等自架應用程式
- 在瀏覽器起始頁保存書籤
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
Linux x86_64
服務能回應請求
- 從頭重跑
- 可離線使用
- 檢查於 2026年11月15日
測試機器遇到的差異
- README: HOMEPAGE_ALLOWED_HOSTS=gethomepage.dev:1234 pnpm start
測試中: 可正常運作,但 next start 警告不支援 output: standalone,建議改用 node .next/standalone/server.js - README: copy src/skeleton to config/
測試中: pnpm build 已會將缺少的 skeleton 檔案複製到 config/