measurementlab/ndt-server Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

ndt-server

本仓库包含一个用Go编写的NDT5和NDT7服务器。该代码可在多种系统（包括macOS和Windows）上编译，但专为Linux 4.19+设计并测试。

客户端

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

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

• ndt7-js（JavaScript）
• ndt7-client-go（Golang）

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

• ndt7-client-cc（C++）
• ndt7-client-ios（Swift）
• ndt7-client-android（Kotlin）
• ndt7-client-android-java（Java）

部署设置

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即可。