屏幕截图_2-4-2025_105717_homepage.service.fxpblogs.win.jpeg

启动问题

部署 Homepage 之后访问网页提示 Host validation failed. See logs for more details.。docker 日志提示 error: Host validation failed for: 192.168.50.130:4000. Hint: Set the HOMEPAGE_ALLOWED_HOSTS environment variable to allow requests from this host / port.

在 docker compose 的 yaml 文件中添加环境变量 HOMEPAGE_ALLOWED_HOSTS ，值为 192.168.50.130:4000，重建容器即可

官方网页：https://gethomepage.dev/

Homepage 的所有配置都在其运行目录下的 yaml 中，yaml 文件的开头有指向官方的配置文档

qBittorrent部件问题

在使用 qBittorrent 部件时，出现 API 错误，需确认 url 的末尾不能出现斜杠/

icon图标显示的问题

需要显示本地的 icon 图标时，需要在 docker compose 的 yaml 中映射主机存储 icon 图标的文件夹映射到容器的 /app/public/icons 目录中，并且添加 icon 图标后，重启容器才能在页面上正常显示（官方说这是 Nginx 静态特性导致的，icon 地址使用在线图标链接的话就没有这个问题）

Ipv6网页检查与更改容器端口

在服务标签中的 siteMonitor 部件在容器网络为 Bridge 的情况下无法检查 ipv6 的网站，因此需要把 homepage 容器设置为 Host 模式。

但是在飞牛系统中，homgpage 默认的 3000 端口被其他程序占用，如果需要修改为其他端口，则需要添加环境变量 PORT=4000（官方并没有说明这个环境变量，但是有用）

Openwrt插件配置问题

官方文档：https://gethomepage.dev/widgets/services/openwrt/

需要注意的是：

config login option username 'homepage' option password '<这里填的是MD5-CRYPT算法加密出来的密码>' list read homepage

而：

widget:
    type: openwrt
    url: http://192.168.50.1
    username: homepage
    password: “<这里填的是原始密码，如果是纯数字就要加双引号>”
    interfaceName: eth1 # 网卡