lsiodev/librespeed

linuxserver/librespeed

https://github.com/librespeed/speedtest 是一个轻量级速度测试工具，通过Javascript实现，使用XMLHttpRequest和Web Workers，无需Flash、Java或Websocket。

!https://raw.githubusercontent.com/librespeed/speedtest/master/.logo/logo3.png

镜像概述

LinuxServer.io团队提供的此容器具有以下特点：

• 定期及时的应用更新
• 简单的用户映射（PGID、PUID）
• 基于s6 overlay的自定义基础镜像
• 每周基础操作系统更新，跨LinuxServer.io生态系统共享通用层，以最小化空间使用、停机时间和带宽
• 定期安全更新

支持的架构

该镜像利用docker manifest实现多平台支持。直接拉取 lscr.io/linuxserver/librespeed:latest 即可获取适合您架构的正确镜像，也可通过标签拉取特定架构镜像。

支持的架构：

应用设置

• 通过 http://SERVERIP 访问速度测试Web界面
• 结果数据库可通过 http://SERVERIP/results/stats.php 使用设置的密码访问
• 默认模板基于 example-singleServer-full.html，所有模板均位于 /config/www/，可自定义 /config/www/index.html，删除该文件并重启容器可恢复默认模板
• 可选择在 /config/www 下放置自定义的 speedtest.js 和 speedtest_worker.js 文件，容器启动后将覆盖默认文件；删除这些文件并重建容器可恢复默认文件
• 若设置mysql或postgresql数据库，需先按照 https://github.com/librespeed/speedtest/blob/master/doc.md#creating-the-database 导入表结构
• 要启用自定义结果页面，设置环境变量 CUSTOM_RESULTS=true 并启动（或重启）容器，容器将创建 /config/www/results/index.php，可自行修改

使用方法

可通过docker-compose或docker cli创建容器。

docker-compose（推荐）

yaml
---
version: "2.1"
services:
  librespeed:
    image: lscr.io/linuxserver/librespeed:latest
    container_name: librespeed
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - PASSWORD=PASSWORD
      - CUSTOM_RESULTS=false #可选
      - DB_TYPE=sqlite #可选
      - DB_NAME=DB_NAME #可选
      - DB_HOSTNAME=DB_HOSTNAME #可选
      - DB_USERNAME=DB_USERNAME #可选
      - DB_PASSWORD=DB_PASSWORD #可选
      - DB_PORT=DB_PORT #可选
      - IPINFO_APIKEY=ACCESS_TOKEN #可选
    volumes:
      - /path/to/appdata/config:/config
    ports:
      - 80:80
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=librespeed \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e PASSWORD=PASSWORD \
  -e CUSTOM_RESULTS=false `#可选` \
  -e DB_TYPE=sqlite `#可选` \
  -e DB_NAME=DB_NAME `#可选` \
  -e DB_HOSTNAME=DB_HOSTNAME `#可选` \
  -e DB_USERNAME=DB_USERNAME `#可选` \
  -e DB_PASSWORD=DB_PASSWORD `#可选` \
  -e DB_PORT=DB_PORT `#可选` \
  -e IPINFO_APIKEY=ACCESS_TOKEN `#可选` \
  -p 80:80 \
  -v /path/to/appdata/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/librespeed:latest

参数说明

容器通过运行时传递的参数进行配置，格式为 <外部>:<内部>。

从文件设置环境变量（Docker secrets）

可通过特殊前缀 FILE__ 从文件设置环境变量，例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

这将根据 /run/secrets/mysecretvariable 文件内容设置环境变量 MYVAR。

应用运行的Umask设置

所有镜像支持通过可选参数 -e UMASK=022 覆盖容器内服务的默认umask设置。注意umask是从权限中减去，而非添加，详情参考 umask说明。

用户/组ID

使用卷（-v标志）时，主机OS和容器之间可能出现权限问题。通过指定用户PUID和组PGID可避免此问题。确保主机上的卷目录由指定用户拥有，权限问题将解决。

使用 id your_user 命令获取PUID和PGID：

bash
id your_user

示例输出：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=librespeed&query=%24.mods%5B%27librespeed%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看此容器可用的mods") https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看通用mods")

我们发布了各种 https://github.com/linuxserver/docker-mods 以启用容器内的额外功能。上述动态徽章可访问此镜像可用的mods及适用于任何LinuxServer.io镜像的通用mods。

支持信息

• 容器运行时的Shell访问：

  bash
  docker exec -it librespeed /bin/bash
  

• 实时监控容器日志：

  bash
  docker logs -f librespeed
  

• 容器版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' librespeed
  

• 镜像版本号：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/librespeed:latest
  

更新信息

大多数镜像为静态、版本化，需更新镜像并重建容器以更新内部应用。除部分例外（如nextcloud、plex），不建议或支持在容器内更新应用。

通过Docker Compose更新

• 更新镜像：

  • 所有镜像：

    bash
    docker-compose pull
    

  • 单个镜像：

    bash
    docker-compose pull librespeed
    

• 更新容器：

  • 所有容器：

    bash
    docker-compose up -d
    

  • 单个容器：

    bash
    docker-compose up -d librespeed
    

• 移除旧镜像：

  bash
  docker image prune
  

通过Docker Run更新

• 更新镜像：

  bash
  docker pull lscr.io/linuxserver/librespeed:latest
  

• 停止运行中的容器：

  bash
  docker stop librespeed
  

• 删除容器：

  bash
  docker rm librespeed
  

• 使用相同参数重建容器（若正确映射到主机文件夹，/config 文件夹和设置将保留）

• 移除旧镜像：

  bash
  docker image prune
  

通过Watchtower自动更新（仅在忘记原始参数时使用）

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once librespeed

警告：不建议将Watchtower用作现有Docker容器的自动更新解决方案，通常不鼓励自动更新。但对于忘记原始参数的容器，这是一次性手动更新的有用工具。长期建议使用 Docker Compose。

镜像更新通知 - Diun（Docker Image Update Notifier）

提示：推荐使用 Diun 获取更新通知。不推荐或支持其他自动更新容器的工具。

本地构建

如需本地修改镜像进行开发或自定义：

bash
git clone https://github.com/linuxserver/docker-librespeed.git
cd docker-librespeed
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/librespeed:latest .

可使用 multiarch/qemu-user-static 在x86_64硬件上构建ARM变体：

bash
docker run --rm --privileged multiarch/qemu-user-static:register --reset

注册后，使用 -f Dockerfile.aarch64 指定Dockerfile。

版本历史

• 06.12.23: - 用php pdo_pgsql替换php mysqli。
• 25.05.23: - 基于Alpine 3.18重建，弃用armhf。
• 14.05.23: - 添加ipinfo.io支持。
• 20.01.23: - 基于Alpine 3.17和php8.1重建。
• 20.08.22: - 基于Alpine 3.15和php8重建，重构nginx配置（查看变更公告）。
• 01.03.21: - 修复数据库设置，确保 index.html 被重新创建。
• 28.02.21: - 添加php7-ctype。
• 23.01.21: - 基于Alpine 3.13重建。
• 01.06.20: - 基于Alpine 3.12重建。
• 29.04.20: - 添加LibreSpeed***链接到Github赞助按钮和容器日志。
• 09.01.20: - 初始发布。