内网测速 LibreSpeed:网页版 Docker 测速服务
📺 本图文教程由视频整理而成,对应的参考视频:内网测速工具LibreSpeed~简单易用的Docker网页版~。如需查看更详细、更具体的操作演示,可观看原视频。
场景:想快速确认局域网里两台设备之间的真实带宽,又不想折腾 iPerf3 的命令行。LibreSpeed 是一个开源测速程序,用 Docker 部署在服务器或 NAS 上,其它设备打开网页点一下「Start」就能测出下载、上传、延时和抖动,前后端一体,适合日常简单测速。
第一步:获取配套资源
配套文档提供了三种获取方式,任选一种即可:
- 好用斋官网首页对应视频下方的「配套资源下载」,内含夸克网盘与 123 云盘。
- 网盘分享页面直接输入编号
551。 - 官网的 Docker 懒人包,本期的内容会更新在「系统工具」分类的对应程序中。
下载到的文档中包含 Docker CLI 命令、Docker Compose 脚本、LibreSpeed 的 GitHub 官网以及官方 Docker 说明。
第二步:查看官方 Docker 说明
LibreSpeed 在 GitHub 上有 14.7K Star,项目本身足够成熟。官方 Docker 文档中同时给出了 docker run 命令和 docker-compose.yml,并且逐个说明了每个环境变量的作用,想改标题之类的功能都在这里查。
第三步:用 Docker CLI 命令部署
在服务器上执行下面这条命令:
docker run -p 8075:8080 -d --name speedtest --restart always ghcr.io/librespeed/speedtest各参数含义:
| 参数 | 说明 |
|---|---|
-p 8075:8080 | 端口映射,冒号后面的 8080 是容器内端口,不能改 |
-d | 容器在后台运行 |
--name speedtest | 容器名称 |
--restart always | 重启策略,飞牛系统用 always;其它系统建议 unless-stopped |
ghcr.io/librespeed/speedtest | 实际拉取的镜像 |
注意
-p 冒号前面的端口可以随意改。8080 被大量程序占用,若宿主机也用 8080 大概率端口冲突,所以这里改用 8075。
这条命令没有 -v 参数,因为 LibreSpeed 不需要在本地保存数据,无需做路径映射。
在终端中先执行 sudo -i 切换到管理员模式,再粘贴上面的命令回车。密码输入时不会显示任何字符,输完直接回车即可,提示符从普通用户变为 root 就表示切换成功。之后粘贴命令,回车执行即可。

第四步:用 Docker Compose 部署(可选)
不想敲命令的话,也可以在 NAS 的图形界面里新建项目,粘贴下面的 Compose 脚本,效果完全相同:
services:
speedtest:
container_name: speedtest
image: ghcr.io/librespeed/speedtest:latest
restart: always
environment:
MODE: standalone
#TITLE: "LibreSpeed"
#TELEMETRY: "false"
#ENABLE_ID_OBFUSCATION: "false"
#REDACT_IP_ADDRESSES: "false"
#PASSWORD:
#GDPR_EMAIL: "privacy@example.com"
#DISABLE_IPINFO: "false"
#IPINFO_APIKEY: "your api key"
#DISTANCE: "km"
#WEBPORT: 8080
ports:
- "8075:8080"与 CLI 命令相比,Compose 脚本只多了环境变量部分,并多了第五步里提到的参数位置。MODE: standalone 是默认值,表示前后端合在一起的独立模式,不写也是这个模式,日常使用无需关心。
脚本中形如 #TITLE: "LibreSpeed" 的行是被注释掉的参数,默认不生效;去掉行首的 # 并把引号里的内容改成自己的值,参数才会生效。需要自定义时,去官方 Docker 文档查参数含义。
第五步:访问并测速
浏览器打开 http://服务器IP:8075,例如 http://192.168.31.215:8075,即可看到 LibreSpeed 首页。
- 点击页面中间的「Start」。
- 上方显示 Ping(延时)与 Jitter(抖动),下方显示 Download(下载)与 Upload(上传),单位为 Mbit/s。
- 测速对象是「当前这台电脑」到「运行 LibreSpeed 的那台服务器」之间的链路,不是宽带出口速度。

图中这台服务器是 2.5G 网口,测试机是万兆网口,两者协商后按 2.5G 运行,实测下行 2488、上行 2482 Mbit/s,延时 1 ms、抖动 0.38 ms,基本跑满链路。
第六步:切换现代模式界面(可选)
页面下方的「Try the modern design」可以切换到现代设计版界面,同样点「Start」测速,只是延时和抖动的显示位置与经典界面略有不同。
注意
现代模式页面内没有返回经典界面的入口,只能使用浏览器的后退按钮回到原页面。
第七步:多测几次取平均值
单次结果有浮动是正常现象,不同时间、不同负载下数值都会变化。若对某次结果存疑,多点几次「Start」取平均值即可。
例如在同一链路下换成万兆网卡的 NAS 测试,下行 9992、上行 9742 Mbit/s,抖动接近 0,就明显体现出万兆与 2.5G 的差距。
建议在自己的服务器或 NAS 上都装一个 LibreSpeed,之后任何设备想测内网速度,打开浏览器点一下就行,比临时敲 iPerf3 命令方便得多。
总结
- 一条
docker run命令即可部署,端口只改冒号前的部分,避免 8080 冲突。 - 测的是设备到服务器的链路速度,不是外网带宽。
- 结果有浮动属正常,多次测量取平均值更可靠。