smcline06/llama-client

LLAMA服务发现客户端镜像概述

本镜像为基于Python/Docker的LLAMA（Loss and LAtency MAtrix）服务发现客户端组件，用于向LLAMA服务器注册探针信息，实现分布式网络节点间的动态监控与测试。LLAMA是Dropbox开发的网络丢包与延迟测量工具，本客户端增强其动态部署能力，无需手动配置即可完成探针自动注册与分组测试。

核心功能

1. 自动注册更新：每60秒向LLAMA服务器发送探针状态更新，确保服务器实时获取节点信息。
2. 分组管理：支持将探针分配到不同分组（如BareMetal、WAN），同组节点间自动执行全mesh网络测试。
3. 自定义标签：可添加位置、主机名等额外标签，便于探针识别与分类。
4. 灵活配置：通过环境变量或配置文件设置服务器地址、保活时间、源IP等参数。

使用场景

• 分布式网络环境下的丢包与延迟实时监控。
• 跨区域节点的网络性能对比测试。
• 动态扩展的网络基础设施监控。

配置说明

关键环境变量

• LLAMA_SERVER：LLAMA服务器端点URL（必填，如http://llama.example.com:8105）。
• LLAMA_GROUP：探针所属分组（可选，用于分组测试）。
• LLAMA_SOURCE_IP：探针源IP（可选，多容器同主机时需指定）。
• LLAMA_KEEPALIVE：保活时间（秒，超时未更新的探针将被服务器移除）。
• LLAMA_TAGS：额外标签（格式如[location: 北京, src_name: 办公区节点]）。
• APP_VERBOSE：启用调试日志（可选）。

部署示例

Linux系统部署

bash
docker run --restart unless-stopped -d \
-e LLAMA_SERVER=http://llama.packetpals.com:8105 \
-e LLAMA_KEEPALIVE=300 \
-e "LLAMA_TAGS=[source: github, hostname: my-linux-server]" \
--name llama-client \
smcline06/llama-client:latest

树莓派（ARM架构）部署

bash
docker run --restart unless-stopped -d \
-e LLAMA_SERVER=[***] \
-e LLAMA_KEEPALIVE=300 \
-e "LLAMA_TAGS=[probe_shortname: pi1, probe_name: 树莓派节点]" \
--name llama-client \
smcline06/llama-client:arm7-latest