xiaojun207/docker-agent

docker-agent 镜像文档

概述

docker-agent是一个Docker代理工具，主要功能是收集Docker主机的各类信息（包括Docker基本信息、容器列表、容器统计数据、容器日志等），并将这些信息发送到指定的docker-manager服务器。同时，它能通过WebSocket接收docker-manager下发的任务，如创建、启动、停止或删除容器等操作，实现对Docker主机的远程管理。

核心功能

• 信息收集与上报：收集Docker主机信息、容器列表、容器CPU/内存/网络等统计数据及容器日志，并发送到docker-manager服务器
• 任务接收与执行：通过WebSocket接收docker-manager下发的任务，支持容器创建、启动、停止、删除及镜像拉取等操作
• 身份认证：通过用户名和密码与docker-manager进行身份验证，确保通信安全

使用场景

• 企业内部Docker主机集群的集中监控与管理
• 多台Docker主机的统一运维，减少人工操作成本
• 需要远程获取Docker主机及容器状态的场景

快速启动

前提条件

• 已安装Docker环境
• 已部署docker-manager服务器（见下文部署说明）
• 确保docker-agent宿主机可访问docker-manager服务器

拉取镜像

shell
docker pull docker.xuanyuan.run/xiaojun207/docker-agent:latest

启动容器

shell
docker run -d \
  --name docker-agent \
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载Docker socket以获取Docker信息
  -e DockerServer="http://192.168.1.200:8068/dockerMgrApi/agent" \  # docker-manager服务器地址
  -e Username="agent" \  # 登录docker-manager的用户名
  -e Password="12345678" \  # 登录docker-manager的密码
  -e HostIp="192.168.1.6" \  # Docker宿主机IP（可选）
  xiaojun207/docker-agent:latest

部署docker-manager服务器

docker-manager是接收docker-agent上报信息并下发任务的管理端，部署命令如下：

shell
docker run -d \
  --name docker-manager \
  -p 8068:8068 \  # 映射端口
  -v /app/docker-manager/data:/app/data \  # 挂载数据目录
  xiaojun207/docker-manager:latest

注意：首次启动docker-manager后，可在控制台日志中获取默认的用户名和密码（角色类型为AGENT）。

参数说明

特别说明

• 每台部署docker-agent的服务器（宿主机）的hostname必须唯一，否则可能导致docker-manager无法正确识别主机
• 需确保容器内的进程有权限访问挂载的/var/run/docker.sock文件，建议使用root用户运行容器或适当配置权限

DockerServer API要求

docker-manager服务器需支持以下API接口（数据格式为application/json）：

1. 主机注册接口

• URL: POST {DockerServer}/reg
• 功能: 接收agent上报的Docker主机基本信息

2. 容器列表接口

• URL: POST {DockerServer}/containers
• 功能: 接收agent上报的容器列表数据

3. WebSocket通信接口

• URL: WS {DockerServer}/ws
• 功能: 建立WebSocket连接，agent通过此接口上报实时数据，同时接收docker-manager下发的任务

任务消息格式示例：

json
{
    "ch": "docker.container.create",  // 任务类型，如：docker.image.pull（拉取镜像）、docker.container.start（启动容器）、docker.container.remove（删除容器）等
    "ts": 1622367529238,  // 毫秒级时间戳
    "d": {}  // 任务具体参数，根据任务类型不同而变化
}

联系信息

如有任何问题或建议，请发送邮件至：***