解决Hassio-addons中Webtrees反向代理端口附加问题

在使用Hassio-addons中的Webtrees应用时，许多用户可能会遇到一个常见问题：当通过Nginx反向代理访问Webtrees时，系统会自动在主机名后附加端口号，导致资源加载失败。本文将详细分析这个问题并提供解决方案。

问题现象

当用户通过Nginx反向代理配置Webtrees时，即使已经正确设置了base_url为类似https://example.org/的格式，Webtrees仍然会在生成的URL中附加内部端口号，例如https://example.org:9999/。这会导致CSS、JavaScript等静态资源无法正常加载，因为反向代理通常不会监听这些内部端口。

问题原因

Webtrees默认会从服务器环境变量中获取端口信息，并自动将其附加到生成的URL中。这种行为在直接访问时是合理的，但在反向代理环境下就会产生问题，因为外部用户是通过标准HTTP/HTTPS端口(80/443)访问的。

解决方案

Hassio-addons中的Webtrees插件提供了一个专门针对此问题的配置选项：base_url_portless。这个选项允许用户指定一个不包含端口号的基础URL，系统将使用这个URL来生成所有内部链接和资源路径。

要解决这个问题，只需在Webtrees的配置中添加或修改以下参数：

base_url_portless: "https://yourdomain.com/"

配置建议

1. 确保base_url和base_url_portless都设置为相同的域名，但后者不包含端口号
2. 如果使用SSL，确保URL以https://开头
3. 在Nginx反向代理配置中，正确设置X-Forwarded-Proto和X-Forwarded-Host头部

注意事项

• 修改配置后需要重启Webtrees服务使更改生效
• 如果仍然遇到问题，可以检查Webtrees的日志文件获取更多调试信息
• 确保Nginx配置中正确处理了WebSocket连接(如果使用)

通过正确配置base_url_portless参数，Webtrees在反向代理环境下的URL生成问题可以得到完美解决，所有资源都能正常加载，用户体验将得到显著提升。