logleio/swarmexec-agent

swarmexec agent

Docker Swarm集群范围的docker exec -it工具——支持日志查看和集群级卷管理，无需SSH到运行任务的节点，即可从单一终端操作。

📦 源码与文档： <[***]>

该镜像为代理：以全局Swarm服务运行（每个节点一个任务），挂载本地Docker socket，并提供mTLS gRPC端点供swarmexec CLI连接。CLI通过Swarm管理器API解析目标所在节点，然后直接与该节点的代理通信。

操作员终端 ──gRPC/mTLS──> 代理(nodeN) ──docker.sock──> 容器
        │
        └── Docker管理器API（TaskList / NodeInspect）解析节点+容器ID

核心价值

Swarm无内置集群级docker exec能力，该代理填补空白：通过持久化代理和可脚本化CLI/TUI，实现集群范围的容器交互、日志流和卷管理，自带认证与审计日志。

使用场景

• Swarm集群管理员需统一管理所有节点容器，避免频繁SSH切换节点
• 批量执行容器命令或查看跨节点日志
• 集群级卷的统一查询与管理
• 交互式TUI可视化操作集群资源

快速开始

需指向Swarm管理器的Docker上下文（含ssh://上下文）：

sh
swarmexec init                       # 部署代理集群+写入客户端配置
swarmexec ps                         # 列出可执行任务
swarmexec exec <service> -- sh       # 交互式shell进入任务
swarmexec logs <service>             # 流式日志
swarmexec volume ls                  # 集群卷视图
swarmexec ui                         # 交互式TUI

显式固定镜像版本：

sh
swarmexec init --image logleio/swarmexec-agent:latest

手动部署（全局服务）

sh
docker service create \
  --name swarmexec_agent \
  --mode global \
  --label swarmexec.role=agent \
  --mount type=bind,src=/var/run/docker.sock,dst=/var/run/docker.sock \
  --publish mode=host,target=9443,published=9443 \
  logleio/swarmexec-agent:latest

代理监听每个节点的9443端口，mTLS/共享密钥配置见项目文档。

代理配置

安全说明

• 支持mTLS（CA验证）或自签名+共享密钥认证
• 所有操作记录审计日志
• 代理需挂载Docker socket，访问权限等同于节点root，需严格控制端口与凭据

许可证

Apache-2.0 — © 2026 Cloud Surfers GmbH，镜像内/licenses/目录含LICENSE和NOTICE文件。

CLI与代理版本需同步，swarmexec doctor可检测版本偏差。 ===FULL_DESC===