返回教程列表
飞牛NAS部署Homepage新一代服务导航页
2026-07-23
之前我们部署过Dashy导航页,但Dashboard更轻量更现代化而且有个杀手级功能——自动发现Docker容器。装完之后你NAS上跑的Docker服务它能自动识别并添加到导航页里,不需要手动一个个配置。
一、Homepage vs Dashy
Dashy需要手动配置每个服务的图标和地址比较费时间。Homepage支持自动检测Docker容器,新装一个服务刷新页面就有了。界面风格更现代支持深色模式。还支持各种Widget小组件比如天气、时钟、CPU状态、网速监控等。配置文件用YAML格式写起来比JSON更简洁。
二、Docker部署
镜像:ghcr.io/gethomepage/homepage:latest
容器名:homepage
端口映射:3000 → 本地3002(如果跟其他服务冲突换个端口)
存储卷映射:
- /docker/homepage/config → 容器内 /app/config(配置文件目录)
- /docker/homepage/icons → 容器内 /app/public/icons(自定义图标目录)
环境变量:
- TZ=Asia/Shanghai
- PUID=1000
- PGID=1000
另外需要挂载Docker socket让Homepage能检测容器:
- /var/run/docker.sock → 容器内 /var/run/docker.sock
启动后访问 http://NAS内网IP:3002。
三、自动发现Docker服务
Homepage启动后会自动扫描正在运行的Docker容器。如果容器设置了标签(label)就会自动出现在导航页上。在docker-compose.yml里给容器添加标签:
labels:
- homepage.group=媒体服务
- homepage.name=Jellyfin
- homepage.icon=jellyfin
- homepage.href=http://NAS内网IP:8096
group是分组名name是显示名称icon是图标href是跳转地址。设置好标签后重启容器Homepage刷新一下就自动添加了。
四、手动配置服务
对于非Docker的服务或者自动检测不准确的服务可以手动配置。编辑/docker/homepage/config/services.yaml:
- 媒体服务:
- Jellyfin:
icon: jellyfin
href: http://192.168.1.100:8096
description: 影音服务器
- Navidrome:
icon: navidrome
href: http://192.168.1.100:4533
description: 音乐流媒体
五、添加Widget小组件
Homepage支持丰富的小组件。编辑/widgets.yaml添加:
- datetime:
text_size: xl
locale: zh-CN
- resources:
cpu: true
memory: true
disk: true
- weather:
latitude: 你的纬度
longitude: 你的经度
units: metric
provider: open-meteo
页面上就会实时显示日期时间、CPU内存磁盘使用率和天气信息。看着就很专业。
六、自定义主题和图标
Homepage支持深色和浅色两种主题可以在设置里切换。图标可以用内置的也可以放自己的图片到/icons目录然后在配置里引用文件名。整体来说Homepage是目前NAS导航页的最佳选择比Dashy更智能更好用。
返回教程列表