1. 项目背景与工具选择上周帮朋友公司部署内网测速环境时偶然发现了OpenSpeedTest这个开源工具。相比常见的iperf3它最大的优势在于提供了直观的Web界面测试结果自动生成可视化图表特别适合给非技术人员演示。经过实际部署测试在千兆局域网环境下误差可以控制在±3%以内完全能满足日常运维需求。这个工具基于Node.js开发使用WebSocket进行数据传输测试过程不会产生实际文件读写纯粹测量TCP/UDP的传输性能。服务端仅需2MB内存即可运行对老旧设备特别友好。下面分享我在CentOS和Windows两种环境下的部署经验。2. 服务端部署实战2.1 Linux环境部署以CentOS 7为例先安装必要的依赖环境# 安装Node.js 16.x curl -sL https://rpm.nodesource.com/setup_16.x | sudo bash - yum install -y nodejs下载并解压最新版程序包wget https://github.com/openspeedtest/Speed-Test/archive/refs/tags/v2.0.0.tar.gz tar -zxvf v2.0.0.tar.gz cd Speed-Test-2.0.0启动服务默认监听3000端口npm install npm start重要提示如果服务器有防火墙记得放行TCP 3000端口。生产环境建议用PM2守护进程npm install -g pm2 pm2 start server.js --name OpenSpeedTest2.2 Windows环境部署从Node.js官网下载Windows安装包解压程序包到D:\OpenSpeedTest目录在目录中按住Shift键右键选择在此处打开PowerShell窗口依次执行npm install node server.js为了方便开机自启可以创建批处理文件echo off cd /d D:\OpenSpeedTest start node server.js然后将该bat文件放入启动文件夹WinR输入shell:startup3. 测试配置优化3.1 常用启动参数通过环境变量可以调整测试行为# 修改监听端口 PORT8080 npm start # 限制测试时长秒 TEST_DURATION20 npm start # 启用HTTPS需准备证书 HTTPStrue npm start3.2 多网卡绑定配置当服务器有多个网卡时建议通过绑定IP指定测试接口// 修改server.js const server require(http).createServer(app).listen(3000, 192.168.1.100);3.3 测试数据包大小调整默认使用动态包大小如需固定值可修改// 在public/js/speedtest.js中 settings.multiStream 8; // 并发流数 settings.test_order IU; // I下载 U上传4. 客户端测试技巧4.1 浏览器兼容性经测试各浏览器表现浏览器下载测试上传测试结果稳定性Chrome 103✓✓最佳Firefox 102✓✓次佳Edge 104✓✓良好Safari 15✓部分异常一般实测发现浏览器必须支持WebRTC和WebSocket禁用广告拦截插件4.2 移动端测试要点关闭省电模式连接5GHz WiFi时保持1米内无遮挡iOS设备需要手动信任证书如果启用HTTPS建议横屏测试以获得完整界面5. 常见问题排查5.1 测试结果异常低可能原因及解决方案交换机端口协商为100Mbps → 检查网卡双工模式存在网络环路 → 检查STP状态客户端CPU占用100% → 关闭其他程序无线信号干扰 → 改用有线连接测试基准5.2 服务端启动报错典型错误处理Error: listen EADDRINUSE :::3000→ 端口被占用用netstat -tulnp | grep 3000查找进程npm ERR! missing script: start→ 解压不完整验证SHA256校验码5.3 跨VLAN测试问题当客户端与服务端在不同VLAN时确保三层路由互通检查ACL是否放行3000端口测试MTU是否一致建议1500考虑在每个VLAN部署测试节点6. 进阶应用场景6.1 自动化定期测试结合crontab实现每日自动测试0 2 * * * curl -X POST http://localhost:3000/api/test -d {duration:30} /var/log/speedtest.log6.2 结果数据持久化修改server.js添加结果记录app.post(/api/test, (req, res) { const result req.body; fs.appendFileSync(results.json, JSON.stringify(result)\n); });6.3 分布式测试架构在多分支机构部署时可以使用Ansible批量部署服务端通过Prometheus收集各节点结果Grafana展示全网质量热力图实际部署中发现当测试包大小设置为8MB时最能反映真实文件传输性能。对于视频会议等实时性要求高的场景建议增加UDP测试项通过修改public/js/speedtest.js中的protocol参数即可实现。 
长河君 · 2026/11/3 17:13:32 · 阅读 1.2k OpenSpeedTest部署与优化：内网测速实战指南
1. 项目背景与工具选择上周帮朋友公司部署内网测速环境时偶然发现了OpenSpeedTest这个开源工具。相比常见的iperf3它最大的优势在于提供了直观的Web界面测试结果自动生成可视化图表特别适合给非技术人员演示。经过实际部署测试在千兆局域网环境下误差可以控制在±3%以内完全能满足日常运维需求。这个工具基于Node.js开发使用WebSocket进行数据传输测试过程不会产生实际文件读写纯粹测量TCP/UDP的传输性能。服务端仅需2MB内存即可运行对老旧设备特别友好。下面分享我在CentOS和Windows两种环境下的部署经验。2. 服务端部署实战2.1 Linux环境部署以CentOS 7为例先安装必要的依赖环境# 安装Node.js 16.x curl -sL https://rpm.nodesource.com/setup_16.x | sudo bash - yum install -y nodejs下载并解压最新版程序包wget https://github.com/openspeedtest/Speed-Test/archive/refs/tags/v2.0.0.tar.gz tar -zxvf v2.0.0.tar.gz cd Speed-Test-2.0.0启动服务默认监听3000端口npm install npm start重要提示如果服务器有防火墙记得放行TCP 3000端口。生产环境建议用PM2守护进程npm install -g pm2 pm2 start server.js --name OpenSpeedTest2.2 Windows环境部署从Node.js官网下载Windows安装包解压程序包到D:\OpenSpeedTest目录在目录中按住Shift键右键选择在此处打开PowerShell窗口依次执行npm install node server.js为了方便开机自启可以创建批处理文件echo off cd /d D:\OpenSpeedTest start node server.js然后将该bat文件放入启动文件夹WinR输入shell:startup3. 测试配置优化3.1 常用启动参数通过环境变量可以调整测试行为# 修改监听端口 PORT8080 npm start # 限制测试时长秒 TEST_DURATION20 npm start # 启用HTTPS需准备证书 HTTPStrue npm start3.2 多网卡绑定配置当服务器有多个网卡时建议通过绑定IP指定测试接口// 修改server.js const server require(http).createServer(app).listen(3000, 192.168.1.100);3.3 测试数据包大小调整默认使用动态包大小如需固定值可修改// 在public/js/speedtest.js中 settings.multiStream 8; // 并发流数 settings.test_order IU; // I下载 U上传4. 客户端测试技巧4.1 浏览器兼容性经测试各浏览器表现浏览器下载测试上传测试结果稳定性Chrome 103✓✓最佳Firefox 102✓✓次佳Edge 104✓✓良好Safari 15✓部分异常一般实测发现浏览器必须支持WebRTC和WebSocket禁用广告拦截插件4.2 移动端测试要点关闭省电模式连接5GHz WiFi时保持1米内无遮挡iOS设备需要手动信任证书如果启用HTTPS建议横屏测试以获得完整界面5. 常见问题排查5.1 测试结果异常低可能原因及解决方案交换机端口协商为100Mbps → 检查网卡双工模式存在网络环路 → 检查STP状态客户端CPU占用100% → 关闭其他程序无线信号干扰 → 改用有线连接测试基准5.2 服务端启动报错典型错误处理Error: listen EADDRINUSE :::3000→ 端口被占用用netstat -tulnp | grep 3000查找进程npm ERR! missing script: start→ 解压不完整验证SHA256校验码5.3 跨VLAN测试问题当客户端与服务端在不同VLAN时确保三层路由互通检查ACL是否放行3000端口测试MTU是否一致建议1500考虑在每个VLAN部署测试节点6. 进阶应用场景6.1 自动化定期测试结合crontab实现每日自动测试0 2 * * * curl -X POST http://localhost:3000/api/test -d {duration:30} /var/log/speedtest.log6.2 结果数据持久化修改server.js添加结果记录app.post(/api/test, (req, res) { const result req.body; fs.appendFileSync(results.json, JSON.stringify(result)\n); });6.3 分布式测试架构在多分支机构部署时可以使用Ansible批量部署服务端通过Prometheus收集各节点结果Grafana展示全网质量热力图实际部署中发现当测试包大小设置为8MB时最能反映真实文件传输性能。对于视频会议等实时性要求高的场景建议增加UDP测试项通过修改public/js/speedtest.js中的protocol参数即可实现。