LinuxServer.io docker-speedtest-tracker 容器介绍

LinuxServer.io 团队简介

LinuxServer.io 团队致力于提供高质量容器，其容器具有以下特点：

• 定期且及时的应用更新
• 便捷的用户映射（支持 PGID、PUID 设置）
• 基于 s6 overlay 的自定义基础镜像
• 每周更新基础操作系统，通过共享通用层减少存储空间占用、停机时间和带宽消耗
• 定期安全更新

关于 speedtest-tracker 容器

speedtest-tracker 是一款自托管的网络性能跟踪应用，可通过 Ookla 的 Speedtest 服务定期执行网速测试并记录结果。LinuxServer.io 团队将其打包为容器，方便用户快速部署和使用。

支持的架构

该容器通过 Docker 清单支持多平台，拉取 lscr.io/linuxserver/speedtest-tracker:latest 即可自动匹配对应架构。也可通过标签指定具体架构：

应用设置

1. 访问 Web 界面：部署后通过 <你的IP>:80 访问，默认登录凭据为 [邮箱已删除] / password。
2. 详细文档：更多配置可参考 官方文档。

使用方法

可通过 docker-compose（推荐）或 docker run 命令部署容器。以下为具体配置示例：

docker-compose 配置

创建 docker-compose.yml 文件，内容如下：

---
services:
  speedtest-tracker:
    image: lscr.io/linuxserver/speedtest-tracker:latest
    container_name: speedtest-tracker
    environment:
      - PUID=1000               # 用户ID（详见下方说明）
      - PGID=1000               # 组ID（详见下方说明）
      - TZ=Etc/UTC              # 时区（如 Asia/Shanghai）
      - APP_KEY=                # 数据加密密钥（必填，生成方法见官方文档）
      - APP_URL=                # 应用访问地址（如 [***]      - DB_CONNECTION=sqlite    # 数据库类型（sqlite/pgsql/mysql）
      - SPEEDTEST_SCHEDULE=     # 测试计划（Cron格式，如 0 */6 * * * 每6小时一次）
      - SPEEDTEST_SERVERS=      # 测试服务器ID（逗号分隔，获取方法见下方说明）
      - DB_HOST=                # 数据库主机（仅pgsql/mysql需填，可选）
      - DB_PORT=                # 数据库端口（仅pgsql/mysql需填，可选）
      - DB_DATABASE=            # 数据库名（仅pgsql/mysql需填，可选）
      - DB_USERNAME=            # 数据库用户名（仅pgsql/mysql需填，可选）
      - DB_PASSWORD=            # 数据库密码（仅pgsql/mysql需填，可选）
      - DISPLAY_TIMEZONE=Etc/UTC # 界面显示时区（可选）
      - PRUNE_RESULTS_OLDER_THAN=0 # 结果保留天数（0为不删除，可选）
    volumes:
      - /path/to/speedtest-tracker/data:/config  # 配置和数据库存储路径
    ports:
      - 80:80                   # Web界面端口映射
    restart: unless-stopped     # 重启策略

启动容器：

docker-compose up -d

docker run 命令

直接通过命令行部署：

docker run -d \
  --name=speedtest-tracker \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e APP_KEY= \
  -e APP_URL= \
  -e DB_CONNECTION=sqlite \
  -e SPEEDTEST_SCHEDULE= \
  -e SPEEDTEST_SERVERS= \
  -e DB_HOST= `#可选` \
  -e DB_PORT= `#可选` \
  -e DB_DATABASE= `#可选` \
  -e DB_USERNAME= `#可选` \
  -e DB_PASSWORD= `#可选` \
  -e DISPLAY_TIMEZONE=Etc/UTC `#可选` \
  -e PRUNE_RESULTS_OLDER_THAN=0 `#可选` \
  -p 80:80 \
  -v /path/to/speedtest-tracker/data:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/speedtest-tracker:latest

参数说明

环境变量与文件（Docker Secrets）

可通过文件传递环境变量，格式为 -e FILE__变量名=/路径/文件名，例如：

-e FILE__APP_KEY=/run/secrets/app_key  # 从文件 /run/secrets/app_key 读取 APP_KEY 值

用户/组权限（PUID/PGID）

容器通过 PUID 和 PGID 映射主机用户权限，避免权限问题。通过 id 用户名 命令获取当前用户的 UID 和 GID，例如：

id your_username  # 输出类似 uid=1000(your_username) gid=1000(your_username)

Docker Mods

可通过 Docker Mods 扩展容器功能，支持该容器的 Mods 可通过官方链接查看。

支持与维护

常用操作

• 进入容器命令行：

  docker exec -it speedtest-tracker /bin/bash
  

• 实时查看日志：

  docker logs -f speedtest-tracker
  

• 查看容器版本：

  docker inspect -f '{{ index .Config.Labels "build_version" }}' speedtest-tracker
  

更新容器

通过 Docker Compose

# 更新镜像
docker-compose pull speedtest-tracker
# 重启容器
docker-compose up -d speedtest-tracker
# 清理旧镜像
docker image prune

通过 Docker Run

# 更新镜像
docker pull lscr.io/linuxserver/speedtest-tracker:latest
# 停止并删除旧容器
docker stop speedtest-tracker && docker rm speedtest-tracker
# 重新创建容器（保留 /config 目录则配置不会丢失）
docker run -d [原参数...] lscr.io/linuxserver/speedtest-tracker:latest

本地构建

如需自定义容器，可本地构建：

git clone [***] docker-speedtest-tracker
docker build --no-cache --pull -t lscr.io/linuxserver/speedtest-tracker:latest .

构建 ARM 架构镜像（需先安装 qemu-static）：

docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
docker build -f Dockerfile.aarch64 --no-cache --pull -t lscr.io/linuxserver/speedtest-tracker:latest .

版本历史

• 05.07.25：基于 Alpine 3.22 重构
• 20.12.24：基于 Alpine 3.21 重构
• 07.06.24：缓存 Filament 组件，新增 APP_KEY 为必填参数
• 27.05.24：现有用户需更新 nginx 配置以避免 http2 弃用警告
• 24.05.24：基于 Alpine 3.20 重构
• 16.04.24：基于 Alpine 3.19 重构，升级至 PHP 8.3
• 10.02.24：初始发布

如需更多帮助，可访问 LinuxServer.io 官方社区：Blog、***、论坛。