← 返回项目库
家庭实验室自托管服务IT 运维

Homarr 自托管家庭实验室仪表盘

面向家庭实验室与自托管服务的可视化仪表盘,集中管理应用入口、看板、小组件和服务集成。

Homarr 提供可拖拽的网格看板、应用快捷入口、状态与进度小组件、全文搜索、集成管理以及用户权限设置;本次交付以 Docker 生产镜像实际运行验证为准,默认使用本地 SQLite 和内置 Redis。

真实界面

项目截图

共 6 张

Homarr
Homarr Board
Boards
Apps
Integrations
Settings

Capabilities

核心功能

可拖拽网格看板与多看板管理
自托管应用快捷入口与图标配置
服务状态、进度和系统信息小组件
集成配置与外部服务连接管理
内置搜索与数据查找入口
用户、权限、用户组及认证设置
WebSocket、tRPC 与 Redis 支持实时更新

适用场景

家庭实验室服务导航与统一入口
媒体、下载、网络和存储服务的内部运维面板
自托管服务门户的界面定制与集成开发

适合谁

使用家庭实验室、媒体服务器或多种自托管服务的个人用户、小型团队和内部 IT 运维人员。

商业化思路

适合作为自托管仪表盘、内部服务门户和二次开发基础;可围绕部署适配、界面定制、集成接入与运维支持提供服务。

你会拿到什么

  • Homarr 完整源码、Dockerfile、pnpm 工作区配置与 Apache-2.0 许可证
  • 已验证的 Docker 运行说明、构建信息和真实产品界面证据

部署流程

  1. 1推荐使用 Docker 构建并启动镜像,将持久化目录挂载到容器 /appdata,并对外暴露 7575 端口
  2. 2如需源码构建,使用 Node.js 24.18+、pnpm 11.15.1+ 安装锁定依赖后执行生产构建,再按 Dockerfile 启动

真实验证结果

已通过 6 个真实运行中文界面、HTTP、可见正文、控制台、坏图和横向溢出质量门。

部署前须知

这是多包 Node.js 自托管项目;外部服务集成需要部署者自行配置地址和凭据,生产环境还应配置安全密钥与备份策略。上游界面仍以英文为主,本次未将其描述为完成中文化。

部署难度

中等

最低配置

推荐 Docker 环境与至少 2GB 可用内存;源码构建需要 Node.js 24.18+ 和 pnpm 11.15.1+,运行时使用 SQLite 与内置 Redis,持久化数据目录为 /appdata。

开源许可证

Apache-2.0

最后验证

2026-08-29

技术栈

Next.jsTypeScriptpnpm monorepoSQLiteRedisWebSocketDocker

授权说明

交付包保留上游 LICENSE、版权声明和修改披露;Homarr 源码按 Apache-2.0 履约,第三方集成、图标和外部服务仍须遵守各自条款。本次未修改上游源码。

Release notes

版本记录

1 个已发布版本

vcn-eba639b59c50 当前推荐

基于上游提交 eba639b59c504d436fc2a22768b999d9416d60d0 完成依赖安装、目标生产构建、Docker 镜像构建、SQLite/Redis 运行初始化和 6 个真实产品页面验证;未修改上游源码。

部署要求:推荐 Docker;源码构建需要 Node.js 24.18+、pnpm 11.15.1+ 和可用的构建资源,运行时需要可持久化的 /appdata。

已知问题:多包工作区构建时间和资源占用高于单体前端;未配置外部服务时对应集成不会产生真实业务数据,生产部署需自行完成密钥、备份和网络访问配置。

登录后领取