返回教程列表

飞牛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更智能更好用。

返回教程列表