measurementlab/dash

Neubot DASH Go客户端与服务器镜像

镜像概述和主要用途

本镜像包含Neubot DASH实验的客户端和服务器实现，均使用Go语言开发。服务器设计用于部署在Measurement Lab（M-Lab），提供网络性能测量功能；客户端用于发起DASH实验测试。镜像以容器化方式发布，确保部署一致性和环境隔离，可通过Docker Hub获取：https://hub.docker.com/r/neubot/dash%E3%80%82

核心功能和特性

服务器特性

• 支持HTTP和HTTPS协议的DASH实验测试
• 提供Prometheus指标接口，便于性能监控
• 容器化部署，支持只读文件系统和最小权限运行（无额外capabilities）
• 可配置数据存储目录、监听地址及TLS证书

客户端特性

• 轻量Go二进制构建，易于执行
• 强制隐私政策确认机制，保护用户数据
• 命令行参数控制，灵活配置测试行为

使用场景和适用范围

• 服务器：部署于M-Lab基础设施，作为网络性能测量节点，为全球用户提供DASH实验服务
• 客户端：供用户或集成系统发起DASH网络性能测试，评估网络带宽、延迟等指标
• 开发测试：本地搭建DASH实验环境，验证服务器配置和功能正确性

使用方法和配置说明

服务器

构建镜像

bash
# 构建基础镜像
docker build -t neubot/dash .

# 为镜像添加版本标签（含Git标签和构建时间）
docker tag neubot/dash neubot/dash:`git describe --tags --dirty`-`date -u +%Y%m%d%H%M%S`

本地测试

在Linux系统中，可通过以下命令启动服务器容器进行本地测试：

bash
# 生成测试TLS证书（若不存在）
rm -f ./certs/cert.pem ./certs/key.pem && \
./mkcerts.bash && \
sudo chown root:root ./certs/*.pem && \

# 启动容器
docker run --network=bridge \
           --publish=80:8888 \          # 映射HTTP测试端口（主机80 -> 容器8888）
           --publish=443:4444 \        # 映射HTTPS测试端口（主机443 -> 容器4444）
           --publish=9990:9999 \       # 映射Prometheus指标端口（主机9990 -> 容器9999）
           --volume `pwd`/certs:/certs:ro \  # 挂载TLS证书目录（只读）
           --volume `pwd`/datadir:/datadir \ # 挂载数据存储目录
           --read-only \               # 启用只读文件系统
           --cap-drop=all \            # 移除所有Linux capabilities
           neubot/dash \               # 镜像名称
           -datadir /datadir \         # 数据存储目录
           -http-listen-address :8888 \ # HTTP监听地址
           -https-listen-address :4444 \ # HTTPS监听地址
           -prometheusx.listen-address :9999 \ # Prometheus指标监听地址
           -tls-cert /certs/cert.pem \ # TLS证书路径
           -tls-key /certs/key.pem     # TLS密钥路径

参数说明：

• --read-only：限制容器对文件系统的写权限，仅允许通过卷挂载的目录写入
• --cap-drop=all：移除所有特权，降低安全风险
• 端口映射：暴露HTTP（80）、HTTPS（443）测试端口和Prometheus指标端口（9990）
• 卷挂载：certs目录提供TLS证书（只读），datadir目录存储实验数据

发布流程

1. 推送镜像到Docker Hub：

   bash
   docker push neubot/dash
   

2. 更新M-Lab部署：

   • 向https://github.com/m-lab/dash%E6%8F%90%E4%BA%A4PR%EF%BC%8C%E9%80%9A%E7%9F%A5%E9%9C%80%E5%90%8C%E6%AD%A5%E4%BB%A3%E7%A0%81
   • 请求M-Lab工作人员拉取已标记的版本
   • 向https://github.com/m-lab/k8s-support/blob/master/k8s/daemonsets/experiments/neubot.jsonnet#L17%E7%9A%84%60neubot.jsonnet%60%E6%8F%90%E4%BA%A4PR%EF%BC%8C%E6%9B%B4%E6%96%B0%E9%83%A8%E7%BD%B2%E9%85%8D%E7%BD%AE

3. 测试Staging环境： 使用Staging环境的locate URL验证部署：

   https://locate-dot-mlab-staging.appspot.com/v2/nearest/neubot/dash
   

客户端

构建客户端

bash
# 构建dash-client二进制文件
go build -v ./cmd/dash-client

运行注意事项

• 运行前必须阅读PRIVACY.md，了解隐私政策
• 客户端会拒绝运行，除非通过-y命令行标志明确确认隐私政策：

  bash
  ./dash-client -y [其他参数]