Dashy · 你的 homelab 主页（自托管起始页仪表盘）· 中文部署与使用全指南

项目仓库： https://github.com/Lissy93/dashy

开源协议：MIT（以仓库 LICENSE 为准） · 技术栈：Vue / Node · 镜像：lissy93/dashy（DockerHub / GHCR） · 多架构：amd64 / arm64 · 容器内端口：8080（常映射 4000:8080） · 配置：./user-data/conf.yml（YAML，UI 可编辑）

1 项目简介

Dashy（仓库名 Lissy93/dashy）自称 "the homepage for your homelab"——你的 homelab 主页。它是一个高度可定制的自托管起始页 / 仪表盘，用 YAML 配置（也可在 UI 里直接编辑保存），支持多页、多主题、多语言、小部件、状态指示、SSO 鉴权。

1.1 核心信息一览

1.2 适用场景

• 把自家服务、书签、常用链接聚合到一个起始页。
• 想要内置多主题、自定义 CSS、多语言。
• 需要可选的多用户鉴权与 SSO（Keycloak / OIDC）。

1.3 能力边界（官方口径）

• 挂载的 /app/user-data 目录必须至少含一个 conf.yml。
• 基础鉴权：在 appConfig 下加 auth 数组，用户密码用 SHA-256 哈希；支持只读访客与细粒度控制。

2 功能特性

• 多页支持：多页面起始页。
• 多主题：内置多套配色主题 + UI 颜色编辑器 + 自定义 CSS。
• 多语言：30+ 人工翻译语言。
• 鉴权：可选多用户访问、SSO（Keycloak / OIDC）、基础 auth（SHA-256）。
• 状态指示：检测各应用 / 主机是否在线，悬停看响应时间。
• 小部件：信息与工具小部件。
• 图标：多种图标包。
• 云端一键部署：Netlify / Vercel / Render 等。

3 官方界面预览

官方 README 提供在线演示与 GIF 演示图（dashy.to/docs），无静态封面图，按规程不配图。

4 官方跳转链接汇总

5 前置要求

• Docker。
• 准备好挂载目录，内含至少一个 conf.yml。

6 方式一：Docker 部署（官方）

# 最简
docker run -p 4000:8080 lissy93/dashy

# 带配置挂载
docker run -d \
  -p 4000:8080 \
  -v /path/to/your/user-data:/app/user-data \
  --name my-dashboard \
  --restart=always \
  lissy93/dashy:latest

访问 http://<主机>:4000。compose 见仓库 docker-compose.yml。

7 方式二：源码运行

git clone https://github.com/Lissy93/dashy.git
cd dashy
# 在 ./user-data/conf.yml 填配置
yarn
yarn build
yarn start

需要较新的 Node LTS 与 yarn。

8 配置项说明

• 配置文件 ./user-data/conf.yml，也可在 UI 里编辑保存。
• 挂载的 /app/user-data 必须至少含 conf.yml；还可放子配置、图标、字体、自定义 CSS。
• 镜像可固定版本（如 :4.0.0），不用 :latest。
• 鉴权：appConfig.auth 数组，用户密码 SHA-256；或接 Keycloak / OIDC。

9 常用运维命令

docker logs -f my-dashboard
docker restart my-dashboard
docker pull lissy93/dashy:latest && docker rm -f my-dashboard && docker run ...

10 常见故障排查

• 启动即退出：确认挂载目录里至少有 conf.yml。
• 端口不通：确认映射 4000:8080（容器内是 8080）。
• 配置不生效：检查 YAML 缩进；UI 里编辑保存会写回 conf.yml。
• 需要登录：在 appConfig.auth 配基础 auth，或接 OIDC。

11 风险与合规说明

• 开源许可；Dashy 是起始页，若暴露公网务必加鉴权（基础 auth 或 OIDC）+ 反向代理。
• 本文命令、端口、配置路径来自官方 README 与文档，随版本可能调整，以 dashy.to/docs 为准。