measurementlab/ndt-server

ndt-server

本仓库包含一个用Go编写的https://github.com/ndt-project/ndt/wiki/NDTProtocol%E5%92%8CNDT7%E6%9C%8D%E5%8A%A1%E5%99%A8%E3%80%82%E8%AF%A5%E4%BB%A3%E7%A0%81%E5%8F%AF%E5%9C%A8%E5%A4%9A%E7%A7%8D%E7%B3%BB%E7%BB%9F%EF%BC%88%E5%8C%85%E6%8B%ACmacOS%E5%92%8CWindows%EF%BC%89%E4%B8%8A%E7%BC%96%E8%AF%91%EF%BC%8C%E4%BD%86%E4%B8%93%E4%B8%BALinux 4.19+设计并测试。

客户端

根据需求，有多种方式可使用NDT7协议执行客户端测量。

官方支持（由M-Lab团队成员维护）

• https://github.com/m-lab/ndt7-js%EF%BC%88JavaScript%EF%BC%89
• https://github.com/m-lab/ndt7-client-go%EF%BC%88Golang%EF%BC%89

社区支持（由M-Lab社区成员维护）

• https://github.com/m-lab/ndt7-client-cc%EF%BC%88C++%EF%BC%89
• https://github.com/m-lab/ndt7-client-ios%EF%BC%88Swift%EF%BC%89
• https://github.com/m-lab/ndt7-client-android%EF%BC%88Kotlin%EF%BC%89
• https://github.com/m-lab/ndt7-client-android-java%EF%BC%88Java%EF%BC%89

部署设置

Linux系统主要部署与运行步骤

准备运行环境

bash
install -d certs datadir

生成本地测试证书

要在本地运行服务器，使用bash和OpenSSL生成自签名证书（key.pem和cert.pem）：

bash
./gen_local_test_certs.bash

构建Docker容器

bash
docker build . -t ndt-server

启用BBR（NDT7配合BBR性能更佳）

bash
sudo modprobe tcp_bbr

运行Docker容器

bash
docker run --network=bridge                \
           --publish 443:4443              \
           --publish 80:8080               \
           --volume `pwd`/certs:/certs:ro  \
           --volume `pwd`/datadir:/datadir \
           --read-only                     \
           --user `id -u`:`id -g`          \
           --cap-drop=all                  \
           ndt-server                      \
           -cert /certs/cert.pem           \
           -key /certs/key.pem             \
           -datadir /datadir               \
           -ndt7_addr :4443                \
           -ndt7_addr_cleartext :8080

Windows与macOS系统替代部署与运行步骤

这些说明假设已安装Docker for Windows/Mac。

注意：NDT5在Docker for Windows/Mac上无法工作，因为它需要使用主机网络，而该功能仅在Linux上支持。

bash
docker-compose run ndt-server ./gen_local_test_certs.bash
docker-compose up

修改代码后，需运行docker-compose up --build重新构建ndt-server二进制文件。

访问服务

运行后，将启动以下服务：

• NDT5服务器：端口3001（传统二进制方式）、3002（WebSocket方式）、3010（安全WebSocket方式）
• NDT7服务器：端口443（基于TLS和NDT7 WebSocket协议）
• Prometheus指标：端口9990

可通过浏览器访问以下URL测试（HTTPS URL的证书会被浏览器视为无效，因这是测试部署，可忽略警告继续）：

• ndt7：http://localhost/ndt7.html 或 https://localhost/ndt7.html
• ndt5+wss：https://localhost:3010/widget.html
• Prometheus指标：http://localhost:9090/metrics

外部访问时，将localhost替换为服务器IP即可。