SpeedTest by OpenSpeedTest™ 技术文档

SpeedTest by OpenSpeedTest™ 技术文档

Speed-Test SpeedTest by OpenSpeedTest™ is a Free and Open-Source HTML5 Network Performance Estimation Tool Written in Vanilla Javascript and only uses built-in Web APIs like XMLHttpRequest (XHR), HTML, CSS, JS, & SVG. No Third-Party frameworks or libraries are Required. Started in 2011 and moved to OpenSpeedTest.com dedicated Project/Domain Name in 2013. 项目地址: https://gitcode.com/gh_mirrors/spe/Speed-Test

---

安装指南

SpeedTest 项目支持多种部署方式，既可以直接在 Web 浏览器上使用其在线服务，也可以下载服务器版本独立运行。

在线使用

无需安装任何软件，只需访问 OpenSpeedTest.com 即可立即开始网络性能测试。

本地部署

1. 对于自建服务器: 确保你的服务器满足以下要求:

   • 支持 HTTP/1.1 或更新版本的 Web 服务器（如 Nginx, Apache, IIS, 或 Express）。
   • 配置服务器以响应 GET, POST, HEAD, 和 OPTIONS 请求。
   • 设置足够的 client_max_body_size （至少35MB）及合适的超时时间。
   • 参考提供的 Nginx 配置示例。

2. 下载并安装 OpenSpeedTest-Server:

   • 对于不同平台，通过对应的链接下载预打包的应用：
     • Windows
     • Mac
     • Linux / Android / iOS / Docker
   • 或者从 GitHub 源代码获取最新版进行编译部署。

项目的使用说明

SpeedTest 允许用户在任何支持 IE10 或以上版本的现代浏览器中执行速度测试。

基本使用步骤:

1. 访问 SpeedTest 的网址。
2. 页面加载后，点击“开始测试”或者通过URL参数自动开始测试(http://example.com?Run)。
3. 测试结果将显示下载速度、上传速度以及ping值。

高级功能使用：

• 压力测试: 添加 Stress 参数到URL（例如 http://localhost?Stress=High），以持续测试指定时间。
• 自定义服务器: 通过编辑 Index.html 中的 openSpeedTestServerList 来添加更多服务器选项。
• 保存测试结果至数据库: 调整 saveData 变量为 true 并配置 saveDataURL。

项目API使用文档

SpeedTest 实现了基于URL参数的简单API，允许用户控制测试行为：

• 自动运行: http://server/?Run
• 延时运行: http://server/?Run=10 (等待10秒后开始测试)
• 压力测试: http://server/?Stress=300 或 http://server/?S=300 (测试300秒)
• 清除补偿因子: http://server/?clean 或调整补偿值: http://server/?clean=3 (设置补偿为3%，最高4%)
• 改变并发连接数: http://server/?XHR=4 或 http://server/?X=4 (默认6个，最多32个)
• 选择特定服务器: http://server/?Host=http://newserver.com

结论

SpeedTest by OpenSpeedTest™ 提供了一个简洁高效且安全的方式来测量网络速度，其开源特性使得自托管成为可能，并且通过灵活的URL参数实现了一系列定制化功能。无论是个人用户还是希望集成网络测试功能到自己应用的开发者，都能从中找到适用的方案。

Speed-Test SpeedTest by OpenSpeedTest™ is a Free and Open-Source HTML5 Network Performance Estimation Tool Written in Vanilla Javascript and only uses built-in Web APIs like XMLHttpRequest (XHR), HTML, CSS, JS, & SVG. No Third-Party frameworks or libraries are Required. Started in 2011 and moved to OpenSpeedTest.com dedicated Project/Domain Name in 2013. 项目地址: https://gitcode.com/gh_mirrors/spe/Speed-Test