讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

Docker Swarm 中怎么排查节点与管理节点通信加密失败问题

梦杰酱_9019

梦杰酱_9019

发布时间:2026-11-23 06:07:45

|

294人浏览过

|

来源于php中文网

原创

排查 docker swarm 节点与管理节点通信加密失败,核心是检查 tls 证书链是否完整、ca 签名是否有效以及网络端口(2377)是否可达。通常通过 `docker swarm init` 或 `docker swarm join` 的报错信息定位是证书过期、cn/san 不匹配还是防火墙拦截。确保管理节点生成的 join token 未过期,且所有节点的系统时间同步,避免因时间偏差导致证书验证失败。

Docker Swarm 中怎么排查节点与管理节点通信加密失败问题

如何验证 TLS 证书链与 CA 信任关系

当节点无法加入集群时,首要步骤是确认管理节点的 CA 证书是否被工作节点正确信任。Docker Swarm 使用 PKI 体系,如果工作节点持有的 CA 证书与管理节点不一致,或者中间证书缺失,握手就会失败。可以通过在管理节点导出 CA 证书,并在工作节点上手动验证其有效性来排查。重点检查证书的 Subject Alternative Name (SAN) 是否包含当前节点的主机名或 IP,因为 Docker 默认严格校验主机名。

Docker Swarm 中怎么排查节点与管理节点通信加密失败问题

# 在管理节点生成 CA 证书
openssl x509 -in /var/lib/docker/swarm/certs/ca.pem -text -noout

# 在工作节点验证证书
openssl verify -CAfile /var/lib/docker/swarm/certs/ca.pem /var/lib/docker/swarm/certs/ca.pem

上述命令会输出证书的详细字段。若验证失败,提示 "certificate has expired" 或 "self-signed certificate",则说明证书状态异常。确保所有节点的时间戳一致,NTP 服务正常运行。如果 SAN 中缺少当前节点 IP,需重新初始化集群或使用 docker swarm ca --rotate 轮换证书以更新 SAN 记录。

如何检查网络连通性与端口防火墙设置

TLS 握手成功的前提是 TCP 连接能建立。Docker Swarm 管理节点监听 2377 端口,若防火墙规则阻止了该端口的入站连接,节点将无法发送 Join 请求。即使证书正确,网络隔离也会导致超时错误。需要在工作节点上使用 telnet 或 nc 测试管理节点 2377 端口的连通性。同时,Swarm 内部还使用 UDP 4789 端口进行 VXLAN 覆盖网络通信,虽然这不影响加入过程,但影响后续服务调度,排查时应一并确认。

LYGO Docker Deploy
LYGO Docker Deploy

通过 Docker 或 docker compose 部署独立的 LYGO 协议栈社区节点。构建 lygo-node镜像,启动健康检查 API 于端口 8787,可选 Phase 4...

下载

Docker Swarm 中怎么排查节点与管理节点通信加密失败问题

# 在工作节点测试管理节点 2377 端口
nc -zv <MANAGER_IP> 2377

# 检查本地防火墙规则
sudo iptables -L -n | grep 2377

# 如果使用 firewalld
sudo firewall-cmd --list-ports

如果 nc 命令返回 Connection refused 或 Timeout,说明网络层不通。检查云服务商的安全组或本地 iptables/firewalld 配置,确保允许来自工作节点网段的 2377/TCP 流量。对于多网卡环境,确认 dockerd 绑定的 IP 地址是工作节点可访问的地址,而非仅 localhost。

基于 Join Token 过期或失效的具体问题

Docker Swarm 的 Join Token 具有有效期,默认为 3 小时(Manager Token)或 3 天(Worker Token)。如果节点在 Token 过期后尝试加入,或者 Token 已被撤销,通信加密将因身份验证失败而终止。此时报错通常指向 "token expired" 或 "unauthorized"。解决此问题的方法是重新生成新的 Join Token,并在节点上执行加入命令。不要重复使用旧 Token,因为 Swarm 会在首次成功后将其标记为已使用或过期。

# 在管理节点查看当前 Token
docker swarm join-token worker

# 重新生成 Worker Token
docker swarm join-token worker -r

# 在新终端使用新 Token 加入
docker swarm join --token <NEW_TOKEN> <MANAGER_IP>:2377

执行 join-token -r 会强制刷新 Token 列表。注意,轮换 Token 不会影响已存在的节点,但会影响尚未加入的新节点。如果节点反复加入失败,检查 /var/log/syslog 或 journalctl -u docker 中的详细日志,确认是否为 Token 认证环节报错。确保在生成 Token 后,立即在目标节点执行加入操作,避免长时间延迟导致意外过期。

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

845

2023.07.24

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

7259

2024.04.08

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

8497

2024.04.08

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3413

2024.04.08

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

399

2026.02.11

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

531

2026.03.31

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

480

2026.05.11

Go Docker与容器化部署教程合集
Go Docker与容器化部署教程合集

聚焦 Go 应用的容器化部署优势与实践,讲解 Go 静态编译特性(CGO_ENABLED=0)与 scratch / distroless 极小基础镜像构建、多阶段 Dockerfile 编写规范、交叉编译生成目标平台二进制、镜像安全扫描(Trivy)与漏洞修复、Docker Compose 本地编排开发环境、Kubernetes Deployment / Service / ConfigMap 部署 Go 服务、健康检查(Livene

365

2026.05.15

CVE-2026-114938高危漏洞修复
CVE-2026-114938高危漏洞修复

Java4Shell是OpenJDK Base64解码路径中的远程代码执行漏洞,编号CVE-2026-114938,2026年11月17日披露,官方已发布17.0.21.1、21.0.13.1等修复版本,建议优先升级 。本专题围绕Java4Shell(CVE-2026-114938)持续更新,从漏洞原理、受影响版本、受影响产品到修复与自查一站式汇总,适合Java开发、运维与安全人员快速定位风险。ARM64环境不受影响,x86-64环境请

0

2026.11.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Docker Desktop故障排查手册
Docker Desktop故障排查手册

共0课时 | 0人学习

Docker镜像构建手册
Docker镜像构建手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn