Jenkins云节点场景下docker-agent与docker-inbound-agent的区别及优势问询

核心逻辑差异 #

• docker-agent（出站型代理）：由Jenkins Controller主动向代理节点发起连接，要求Controller网络可直达代理节点的对应服务端口
• docker-inbound-agent（入站型代理）：由代理容器启动后主动通过TCP/WebSocket协议向Jenkins Controller发起连接，仅要求代理节点可访问Controller即可，无需Controller能反向访问代理

docker-inbound-agent使用TCP或WebSockets向Jenkins主节点建立入站连接。

各自使用优势 #

docker-agent 优势 #

• 配置门槛更低，在Configuration Cloud的Docker云配置项中直接填写代理宿主机的Docker API地址即可，Controller完成代理容器调度后会主动建联，无需额外配置代理启动参数
• 动态调度更灵活，Controller可根据构建任务队列情况按需创建、销毁代理容器，无需提前预启动代理进程
• 适合代理与Controller部署在同一内网、无严格单向网络访问限制的常规场景

docker-inbound-agent 优势 #

• 适配复杂网络场景：可完美支持代理部署在NAT网络、隔离内网等Controller无法主动访问的环境，只要代理能访问到Controller就能正常工作
• 安全性更高：代理侧无需开放任何入站端口，也不需要给Controller开通代理侧网络的访问权限，仅需代理可访问Controller的入站代理端口（默认50000）即可
• 适合跨地域部署、代理部署在公有云或K8s集群、有严格网络安全限制的场景

适配你的部署场景建议 #

你当前Jenkins Controller运行在独立主机，另有单独主机运行Docker代理：

• 若两台主机处于同一内网，无单向网络访问限制，优先选docker-agent，配置和维护成本更低
• 若代理主机处于防火墙后、或安全规则禁止外部主动访问，直接选docker-inbound-agent即可

内容的提问来源于stack exchange，提问作者MK83