EC2 Session Manager 连接指南,免 SSH 会话与故障排查
使用 AWS Systems Manager Session Manager 建立 EC2 交互会话,先核对托管节点、实例身份与 SSM Agent,再检查 IAM、HTTPS 端点和本地插件。附浏览器与 CLI 连接、常见报错及会话审计清单。
先确认 EC2 与托管节点满足连接条件
Session Manager 可以从 AWS Systems Manager 控制台、EC2 控制台或 AWS CLI 打开受 IAM 控制的普通交互会话。实例中的 SSM Agent 主动连接服务端,管理链路使用出站 HTTPS。准备连接时,先记录 AWS 账号、Region、实例 ID、操作系统及选择的会话方式,确认目标实例正在运行,并在 Systems Manager 中检查对应托管节点的连接状态。
按官方前提条件核对操作系统支持、SSM Agent 安装和所需功能版本。使用 AWS CLI 时,准备本地 AWS CLI 与 Session Manager plugin,确认当前凭据指向预期账号、角色和地域。浏览器入口按控制台流程启动会话。将普通交互、SSH 隧道和端口转发的用途及权限分别记录,按本次所需模式继续配置和验收。
- 账号、Region、实例ID和会话方式已记录。
- 实例运行及托管节点连接状态已核对。
- 操作系统、Agent和所用CLI插件符合功能要求。
支持条件按Session Manager 官方前提清单核对。
目标实例已停止时,可结合EC2 停机与恢复核对步骤确认资源状态。
检查 SSM Agent、实例身份和本机诊断
节点需要具备与 Systems Manager 通信的权限。采用实例配置文件时,核对 EC2 实际附加的 IAM 角色,参考包含 AmazonSSMManagedInstanceCore 的官方配置确认基本权限。已采用 Default Host Management Configuration 的环境,则按该配置核对节点实际使用的身份。额外启用日志或 KMS 等功能时,继续检查对应资源权限及组织约束。
按操作系统和安装方式确认 SSM Agent 服务已启动、版本符合本次功能要求,并查看代理日志中的凭据、连接或注册错误。在已有授权维护通道的节点上,可使用官方提供的 ssm-cli get-diagnostics --output table 收集诊断结果。将代理状态、实例凭据、区域及端点检查输出与报错时间对应,处理具体失败项后再观察托管节点状态。
- 实例配置文件或既定主机管理身份已核对。
- Agent服务、版本、日志和凭据错误已检查。
- 本机诊断及节点状态与报错时间对应。
实例身份配置参考Session Manager 实例权限文档。
Agent排查依据见AWS SSM Agent 故障排查。
本机诊断用法参考AWS ssm-cli 托管节点诊断。
沿 HTTPS 路径核对 VPC 端点与网络
先确定节点通过受控公网出口还是 VPC 接口端点访问 Systems Manager,核对所在地域的 ssm 与 ssmmessages 服务端点。实例侧需要能够向所需端点发起 TCP 443 连接。使用接口端点时,检查端点所在网络、私有 DNS、解析结果、路由、网络 ACL 与端点策略,端点安全组应允许来自目标节点的适当 443 入站流量。
消息端点需求要结合地域和 Agent 版本核对。官方说明,较新 SSM Agent 在可用时优先使用 ssmmessages,ec2messages 的支持和需求与地域及版本有关。记录实际被访问的端点与错误,再对照当前文档判断。使用 S3、CloudWatch Logs 或 KMS 等会话功能时,还应检查到这些服务的网络访问及权限。会话创建成功但终端空白时,同样复查这些依赖。
- 节点到所需服务端点的443出站路径已验证。
- 接口端点DNS、策略、安全组及网络ACL已核对。
- 地域和Agent版本对应的消息及日志依赖已记录。
私网路径按Systems Manager VPC 端点文档逐项验证。
消息接口的版本与支持范围见AWS 消息 API 参考。
分别核对操作者 IAM 和会话内系统权限
操作者发起会话的身份与节点获得的实例身份需要分别检查。按官方示例策略,核对目标实例、会话文档及所需 Session Manager 操作的授权范围,并结合资源标签条件、权限边界和组织策略复核。记录拒绝的操作、资源 ARN、调用身份和请求时间。查看、恢复或终止会话的权限也应按维护职责明确。
会话内操作使用的系统用户还需单独确认。普通会话可能使用系统生成的 ssm-user,团队应根据维护任务核对其操作系统权限。Linux 等适用环境可以通过 Session Manager preferences 配置 Run As,按官方支持条件指定系统用户。IAM 访问策略与系统内授权都应覆盖本次实际任务,完成后验证操作者能使用约定入口和所需命令。
- 操作者对目标实例和会话文档的权限已核对。
- 标签条件、权限边界及组织约束已检查。
- 会话系统用户与实际任务所需权限已验证。
操作者策略依据见Session Manager 节点访问控制。
系统用户与日志设置参考Session Manager 会话偏好。
建立会话后按报错定位失败环节
通过控制台连接时,在正确账号和地域进入 Systems Manager Session Manager,选择已就绪的节点并启动会话,也可使用 EC2 控制台的相应连接入口。使用 CLI 时,参考命令 aws ssm start-session --target INSTANCE_ID --region REGION,将 INSTANCE_ID 与 REGION 替换为实际实例 ID 和地域。连接成功后核对当前主机与系统用户,执行本次验收所需的普通命令,再按正常流程结束会话。
出现 TargetNotConnected 或 SSM Agent not online 时,先核对目标账号与地域、实例运行状态、节点身份、Agent 和服务端点。出现 AccessDenied 时,保存失败的具体 API 与资源,再检查对应操作者策略。提示 Session Manager plugin not found 时,检查本地插件安装和命令搜索路径。终端空白时,复查代理版本、会话偏好、日志目标与 KMS、网络依赖及官方对应故障项,逐项修改并记录验证结果。
- 浏览器或CLI已连接到预期节点并正常退出。
- 具体报错、失败操作和资源ARN已有记录。
- 每项修改对应一次验证并保存实际结果。
控制台与CLI流程参考AWS 官方启动会话步骤。
按具体错误继续核对Session Manager 故障排查文档。
验收系统用户、会话记录与恢复流程
用普通交互会话验证连接、约定系统用户、所需操作和退出流程,保存会话 ID、节点、调用身份与开始结束时间。需要记录会话内容时,按支持的会话类型配置 S3 或 CloudWatch Logs,核对写入权限、加密、网络与保留周期,并实际查看记录。CloudTrail 用于记录 Session Manager 相关 API 活动,命令输出的内容记录需按会话方式单独验收。
普通交互会话的内容日志与 SSH、端口转发模式的审计应按官方支持范围设计。SSH 和端口转发会话应通过其他适用机制满足内容审计要求。恢复连接后,将根因、修改、验证结果、维护负责人和后续检查时间写入记录,再按团队要求处理排障临时配置。生产变更应有数据备份、维护窗口和可执行的恢复步骤,交接时由维护者验证所需访问。
- 会话ID、调用者、节点及开始结束时间已保存。
- 内容日志、API活动和所选模式的审计已验收。
- 恢复说明、临时配置处理和维护交接已完成。
日志记录与支持范围依据见Session Manager 会话日志说明。
使用端点和日志等配套服务时,可用AWS 预算告警验收指南安排相关支出的通知与复查。