Homarr
SHA-256一款现代、美观的自托管仪表板，集成 50+ 应用，拖拽式布局，无需 YAML。
自部署服务控制台，把各种应用和小工具放一个页面，拖拽即用。
核心功能
- 拖拽网格布局，随意摆放小部件
- 集成 50+ 主流自托管应用（Jellyfin、Home Assistant 等）
- 添加应用无需写 YAML，一键搞定
- 多用户管理，支持 OIDC/LDAP 单点登录
- 敏感数据 AES-256 加密存储
避坑指南
- •首次启动需设置管理员密码；部分集成需提供 API 密钥或 URL；如果使用 Kubernetes，需要 Helm 基础；默认端口 3000 可能冲突，可修改。
适用场景
- 家庭实验室爱好者统一管理各种自托管服务
- 技术团队搭建内部服务导航面板
- NAS 用户（如 TrueNAS、Unraid）快速访问文件、下载、媒体服务
详细介绍
Homarr 是一款开源的自托管仪表板，将所有服务和工具整合到一个统一界面中。它采用高度可定制的拖拽网格系统，你可以随意放置天气、日历、搜索、状态监控等小部件。添加应用只需点击几下，无需编辑 YAML 文件。Homarr 与 Jellyfin、Home Assistant、AdGuard Home 等 50 多款热门自托管软件深度集成，通过 WebSocket 和 tRPC 实时展示数据。支持多用户管理、细粒度权限控制，以及 OIDC/LDAP 单点登录。敏感数据采用 BCrypt 和 AES-256-CBC 加密存储。兼容 x86、ARM、树莓派等主流硬件，可通过 Docker 或 Kubernetes Helm 图表轻松部署。
常见问题与排障 (1)
故障排除为什么 Homarr 的分类在页面重新加载后无法保持展开状态？
分类展开/折叠状态仅在你登录时按用户保存在数据库中。若未登录，每次页面加载时状态会重置。解决方法：在你希望状态保持的所有设备上登录你的 Homarr 账户。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：确保已安装 Docker 和 Docker Compose
步骤2：创建 docker-compose.yml 文件，参考官方文档配置
步骤3：运行 docker compose up -d 启动服务
- 步骤1：确保已安装 Docker 和 Docker Compose
- 步骤2：创建 docker-compose.yml 文件，参考官方文档配置
- 步骤3：运行 docker compose up -d 启动服务
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
24181c413e346fa50aa95f4c8876df400c92a92f16eaa24bd65491b28c545a44该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止并删除容器：docker compose down；删除数据卷可移除持久化数据。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ