一个全能又漂亮的服务器导航页 Homarr

视频

功能

一个服务器的导航页，界面组件可任意拖拽添加，支持从 docker 直接添加，部分容器支持数据集成，支持监控项目状态等。

可添加 RSS 订阅显示、网页嵌入、视频嵌入、BT 软件网速显示、BT 软件任务显示、媒体服务器请求及播放显示、DashDot 主机硬件信息显示等等组件。

安装

需要映射一个端口，两个分别保存图标和配置的路径，界面访问密码。其他配置为可选。

PORT 控制内部访问端口，默认 7575；

DEFAULT_COLOR_SCHEME 控制默认显示颜色，默认为黑暗模式；

DISABLE_EDIT_MODE 设置为 true 为禁用编辑模式，进入编辑模式才能随意拖拽增删改界面显示的内容；

EDIT_MODE_PASSWORD 为编辑模式密码，默认为空；

若需要控制容器或快速添加其他容器（快速指容器的 IP 和端口无需手动去查找，直接从 docker 进程获取），需映射 /var/run/docker.sock，权限设为只读。

无需设置的参数可删除。

docker run

1
2
3
4
5
6
7
8
9
10
11
12
13
14

docker run -it \
  --name=Homarr
  -e PORT=7575
  -e DOCKER_HOST=
  -e DOCKER_PORT=
  -e DEFAULT_COLOR_SCHEME=dark
  -e PASSWORD=xiaodi
  -e DISABLE_EDIT_MODE=false
  -e EDIT_MODE_PASSWORD=
  -p 7575:7575/tcp
  -v /mnt/user/appdata/Homarr/icons:/app/public/icons:rw
  -v /mnt/user/appdata/Homarr/configs:/app/data/configs:rw
  -v /var/run/docker.sock:/var/run/docker.sock:ro
  ghcr.io/ajnart/homarr:latest

如果想要使用 docker-compse 安装，使用 https://www.composerize.com 即可快速转换。

unraid

应用市场搜索 Homarr 安装。其他系统安装参考上面 docker run 指令及下面图片。

镜像：dockerhub 的镜像已停止更新，使用 Github 镜像：ghcr.io/ajnart/homarr:latest

设置

常规设置可以指定页面上方的搜索引擎及打开新页面方法、页面语言、缓存清除、配置备份及恢复。

个性化可设置页面的布局、大小、页面标题、Logo、主题色及自定义样式等，还有搜索栏、侧边栏、Docker 集成、Ping 集成等功能的开关。

功能组件

Docker 控制及添加

点击右上角 docker 图标进入此页面即可对容器进行简单的控制以及添加到 Homarr 的操作。

各个组件

可添加的所有功能性组件。

更多组件展示请移步官网：https://homarr.dev/docs/widgets/bookmarks

总结

• 界面简洁，常见的可数据集成的容器都可以集成，可从 Docker 直接添加项目，可添加大量组件，可分类，可监控项目是否可访问，自定义主题等。
• 页面数据多了之后会有明显的卡顿。

参考

• 演示：https://demo.homarr.dev
• 官网：https://homarr.dev
• 项目：https://github.com/ajnart/homarr
• 镜像：ghcr.io/ajnart/homarr:latest

图标