Homepage
一个现代化、完全静态、快速、安全、高度可定制的应用仪表盘，支持 Docker 自动发现和 100 多种服务集成。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
自建服务导航页，自动发现 Docker 容器并显示状态。
核心功能
- 完全静态生成，页面秒开
- 所有 API 请求代理转发，不暴露密钥
- 支持 100+ 服务集成（Radarr/Plex/Jellyfin 等）和信息小部件（天气、时间）
- 自动通过 Docker 标签发现服务，无需手动配置
- 40+ 语言界面，高度可定制主题和布局
避坑指南
- •Homepage 本身不提供用户认证，若要从外部网络访问，必须放在反向代理（如 Nginx、Traefik）后面，并配置身份验证和 HTTPS。不要将端口直接暴露到公网。
适用场景
- 家庭实验室（Homelab）服务总览导航页
- 企业内网多个自建应用入口聚合
- 个人 NAS 上 Docker 服务状态监控
详细介绍
Homepage 是一个现代化应用仪表盘，完全静态生成，加载极快。所有 API 请求均通过代理转发，隐藏密钥，保障安全。它集成了超过 100 种服务（如 Radarr、Sonarr、Plex、Jellyfin 等）和信息小部件（天气、时间、搜索）。配置通过 YAML 文件或 Docker 标签自动发现完成。支持 40 多种语言的全界面国际化，高度可定制（主题、自定义 CSS/JS、布局）。提供 AMD64 和 ARM64 镜像，支持 Docker 部署或从源码运行。
常见问题与排障 (2)
故障排除为什么在将 Homepage 升级到 v1.0.0 后，fiveColumns 对根级服务只显示 4 列？
这是 Homepage v1.0.0 中的一个回归问题：fiveColumns: true 在根级布局分组中被忽略，而嵌套分组仍能正常显示。作为临时解决方案，请将镜像标签从 latest 切换为包含该修复的 dev 标签，然后拉取并重新创建容器。请在 settings.yaml 中保留 fiveColumns: true。或者，待包含该修复的稳定版本发布后，再升级到该版本。
故障排除如何修复当多个设备打开仪表盘时 Homepage 中 Omada 小组件出现的 "API Error: Unexpected error" / "Unexpected token <" 错误？
这是由于并发的 Omada 登录覆盖了 Homepage 的共享 cookie jar 所导致的。每个查看者每 5 秒登录一次；进行中的请求可能会将一个会话的 token 与另一个会话的 session cookie 一起发送，导致 Omada 返回 HTML 登录页面而不是 JSON。
临时解决方法：
1. 重启 Homepage 容器，而不是 Omada 容器：
docker restart homepage或者使用 Docker Compose：
docker compose restart homepage2. 在该小组件修复之前，避免在多台设备上同时打开 Homepage。同一设备上的多个标签页不太容易触发此问题。
3. 重启 Omada 无法清除 Homepage 中的错误状态。
永久修复需要修改 Omada 小组件，使其复用/缓存会话，而不是在每 5 秒一次的轮询时都重新登录；或者按请求隔离 cookie/token，而不是使用进程全局的 cookie jar。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
使用 Docker Compose 部署：创建 docker-compose.yml，内容见官方文档
配置 config 文件夹，参考 src/skeleton 示例
运行 docker-compose up -d，访问 http://localhost:3000
- 使用 Docker Compose 部署：创建 docker-compose.yml，内容见官方文档
- 配置 config 文件夹，参考 src/skeleton 示例
- 运行 docker-compose up -d，访问 http://localhost:3000
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止并删除容器：docker-compose down，删除配置目录和镜像即可。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs