Speedtest-Tracker 时区配置问题解决方案

问题背景

在使用 Speedtest-Tracker 进行网络测速时，许多用户遇到了时间显示不正确的问题。具体表现为测速记录的时间与本地实际时间存在偏差，例如在德国用户案例中，实际12点的测速结果显示为10点，存在2小时的时差。

原因分析

这种时间显示问题通常源于以下原因：

1. 容器默认使用UTC时间而非本地时区
2. 应用程序未正确配置时区参数
3. 主机与容器之间的时区同步问题

解决方案

经过技术验证，正确的配置方法需要同时设置以下两个环境变量：

1. APP_TIMEZONE：设置应用程序使用的时区
2. DISPLAY_TIMEZONE：设置前端显示的时区

这两个参数都需要使用时区格式的值，例如：

• 欧洲/柏林（Europe/Berlin）
• 美洲/芝加哥（America/Chicago）

配置示例

在Docker环境中，可以通过以下方式配置：

environment:
  - APP_TIMEZONE=Europe/Berlin
  - DISPLAY_TIMEZONE=Europe/Berlin

对于其他部署方式，确保这两个环境变量被正确设置即可。

注意事项

1. 仅设置TZ环境变量或挂载/etc/localtime可能不足以解决问题
2. 两个时区参数应设置为相同的值，除非有特殊需求
3. 修改配置后需要重启服务使变更生效

验证方法

可以通过以下命令验证容器内时间是否正确：

docker exec -it speedtest-tracker date

如果显示的时间与本地时间一致，说明时区配置已生效。

总结

Speedtest-Tracker 的时间显示问题通常可以通过正确配置APP_TIMEZONE和DISPLAY_TIMEZONE两个环境变量来解决。这种双重配置确保了从后端数据处理到前端展示的整个流程都使用正确的时区设置，从而避免了时间偏差问题。对于全球不同地区的用户，只需将时区值替换为当地对应的时区标识即可。