Speedtest-Tracker 项目应用密钥配置指南

背景介绍

Speedtest-Tracker 是一个基于 Docker 的开源网络测速工具，用于持续监控网络连接质量。在最新版本 v0.20.0 中，项目引入了一个重要的安全变更：强制要求配置应用密钥(APP_KEY)。

变更内容解析

最新版本中，Speedtest-Tracker 移除了自动生成应用密钥的功能，改为要求用户必须显式配置。这一变更是出于安全考虑，确保每个部署实例都有唯一的加密密钥。

配置方法

对于使用 Docker Compose 部署的用户，需要在环境变量部分添加 APP_KEY 配置项。密钥可以通过以下两种方式生成：

1. 使用项目提供的在线工具生成
2. 在容器内执行命令生成：docker exec speedtest-tracker php /app/www/artisan key:generate --show

典型配置示例

environment:
  PUID: 1000
  PGID: 1000
  TZ: America/Los_Angeles
  DB_CONNECTION: pgsql
  DB_HOST: speedtestracker-db
  DB_PORT: 5432
  DB_DATABASE: speedtest
  DB_USERNAME: username
  DB_PASSWORD: password
  APP_KEY: base64:your_generated_key_here

注意事项

1. 密钥一旦生成，不应随意更改，否则可能导致加密数据无法解密
2. 建议将密钥妥善保管，不要直接提交到版本控制系统
3. 对于已有实例升级，需要确保新密钥与原有加密数据兼容

故障排查

如果遇到"An application key is missing"错误，请检查：

• 环境变量中是否包含有效的APP_KEY
• 密钥格式是否正确（应以base64:开头）
• 配置文件语法是否正确（特别是缩进和引号）

这一安全变更虽然增加了初始配置的步骤，但显著提高了应用的安全性，建议所有用户及时更新配置。