Docker部署Wavefront：从零开始搭建指标采集代理

动手之前先确认三件事

在开始 Docker部署Wavefront 前，请确保你的服务器满足以下条件：

• 已安装 Docker（版本 20.10 以上）—— 终端执行 docker --version 验证，如果未安装请参考 Docker 官方安装文档 完成。
• 拥有 Wavefront 账号与 API Token —— 登录 Wavefront 控制台，在右上角账号设置中复制你的 API Token（类似 ab12-cd34-ef56）。
• 出站网络正常 —— 服务器能访问 longboard.wavefront.com 或你所在的实例地址（例如 your-instance.wavefront.com）。

拉取并启动 Wavefront Proxy 容器

Wavefront 官方提供了 Proxy 镜像，负责接收本地指标并批量上报到云端。
执行以下命令拉取最新版本：

docker pull wavefronthq/proxy:latest

拉取完成后，用一条命令启动容器（将 YOUR_API_TOKEN 替换为你的真实 Token）：

docker run -d \
  --name wavefront-proxy \
  -p 2878:2878 \
  -e WAVEFRONT_URL=https://longboard.wavefront.com \
  -e WAVEFRONT_TOKEN=YOUR_API_TOKEN \
  wavefronthq/proxy:latest

• -d：后台运行。
• --name：指定容器名称，方便后续管理。
• -p 2878:2878：映射 Proxy 监听端口（默认 2878），你的应用可以通过此端口发送指标。
• -e：传入环境变量，WAVEFRONT_URL 是集群地址（国内用户可能需用 https://vmware.wavefront.com），WAVEFRONT_TOKEN 是 API 令牌。

启动后立即执行 docker logs wavefront-proxy 查看日志，
如果看到类似 “Starting Wavefront Proxy...” 和 “Connected to Wavefront” 字样，
说明连接成功。

验证指标能否成功上报

现在用一条简单的 curl 命令向 Proxy 发送测试指标，模拟应用上报：

echo "test.metric 123.4 source=my-server" | nc -w 1 localhost 2878

如果 nc 命令不可用，也可用 curl：

curl -X POST -d "test.metric 123.4 source=my-server" http://localhost:2878/

发送后登录 Wavefront 控制台，
在 Browse > Metrics 中搜索 test.metric，
如果能看到刚刚上报的数据点，
说明 Docker部署Wavefront 已成功运转。

必须避开的三个坑

• Token 错误或失效：启动后日志显示“Authentication failed”，请检查 Token 是否从控制台正确复制，注意前后不要有空格。
• 端口被占用：2878 端口如果已被其他服务使用，修改 -p 映射，例如 -p 2879:2878，同时记得调整防火墙规则。
• 网络不通：如果你的 Wavefront 实例是私有部署（比如 https://your-instance.wavefront.com），务必在 WAVEFRONT_URL 中写完整 URL，并确认服务器能解析该域名。

高频问题解答

Q：容器启动后几分钟仍无数据，该怎么办？
A：先看日志 docker logs wavefront-proxy，如果长时间未见“Connected”字样，可能是网络或 Token 问题。也可以用 docker exec -it wavefront-proxy sh 进入容器，执行 ping longboard.wavefront.com 检查连通性。

Q：我想修改 Proxy 配置（如调整批处理间隔），如何操作？
A：创建配置文件 wavefront.conf，内容参考 官方配置说明，然后挂载到容器：

docker run -d ... -v $(pwd)/wavefront.conf:/etc/wavefront/wavefront.conf wavefronthq/proxy:latest

Q：Docker 重启后容器自动启动了，但 Token 变了怎么办？
A：建议通过 docker update --restart=always wavefront-proxy 设置自动重启，同时检查环境变量是否在容器启动时已正确设置。Token 变更后需删除旧容器并重新创建。

总结

本文完整演示了 Docker部署Wavefront 的核心流程：拉取官方镜像、配置环境变量启动容器、验证数据上报以及常见问题处理。
整个过程仅需几分钟，零基础用户也能轻松上手。
如果你正在为服务器搭建监控体系，Wavefront + Docker 的组合是一个非常轻量的选择。
遇到异常时优先回看避坑部分和高频问题，基本都能解决。