# AWS Session Manager Plugin

AWS CLI 插件，用于与 Systems Manager 托管节点建立经授权的 shell、SSH 传输和端口转发会话；无需单独的桌面应用。

> 这是 OpenNavo 上 AWS Session Manager Plugin 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/session-manager-plugin>

- **最新版本**: `1.2.896.0`
- **开发者**: Amazon Web Services
- **主页**: <https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html>
- **分类**: [开发工具](https://opennavo.com/zh/categories/developer-tools)
- **安装**: `brew install --cask session-manager-plugin`
- **近 30 天安装**: 14,585
- **Homebrew**: 可以安装，由 Homebrew 更新
- **下载地址**: <https://session-manager-downloads.s3.amazonaws.com/plugin/1.2.896.0/mac_arm64/session-manager-plugin.pkg>
- **SHA-256**: `b95139a76cb473654d92185c200ac65205244b20f96aeb240b53837ba4973084`
- **附带命令**: session-manager-plugin
- **安装包**: session-manager-plugin.pkg

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "pkgutil": "session-manager-plugin"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "pkg": [
        "session-manager-plugin.pkg"
      ]
    },
    "phase": "install",
    "sources": [
      "session-manager-plugin.pkg"
    ],
    "type": "pkg"
  },
  {
    "declaration": {
      "binary": [
        "/usr/local/sessionmanagerplugin/bin/session-manager-plugin"
      ],
      "target": "$HOMEBREW_PREFIX/bin/session-manager-plugin"
    },
    "phase": "install",
    "sources": [
      "/usr/local/sessionmanagerplugin/bin/session-manager-plugin"
    ],
    "target": "$HOMEBREW_PREFIX/bin/session-manager-plugin",
    "type": "binary"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": "/Library/LaunchDaemons/SessionManagerPlugin.plist"
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

Session Manager 插件允许 AWS CLI 启动与 AWS Systems Manager 托管节点之间的交互式 shell、SSH 传输和端口转发会话。它是供云管理员、开发人员和运维团队使用的本地命令行组件，不是安装在远程节点上的 SSM Agent，也不是独立的桌面应用。

### 功能
- 通过 AWS CLI 命令和 IAM 授权启动及结束会话。
- 对普通 Session Manager shell 会话，无需开放入站 SSH 端口即可访问托管节点。
- 使用受支持的会话文档，将端口转发到托管节点或可连接的远程主机。
- 在会话类型支持的情况下，使用已配置的会话 shell 配置文件和 AWS 日志选项。
- 在版本 1.2.835.0 中使用类似 SSH shell 的转义序列，包括用 ~. 终止会话，以及用 ~? 获取帮助。

### macOS 安装与首次使用
安装 `brew install --cask session-manager-plugin`。cask 会将官方的、适用于相应架构的签名 PKG 安装到 /usr/local/sessionmanagerplugin，并将其可执行文件链接到 Homebrew 的 bin 目录。可能需要管理员批准。检查 `session-manager-plugin --version` 和 AWS CLI 配置，然后使用 `aws ssm start-session --target i-EXAMPLE` 启动已获授权的会话。请将示例替换为真实的托管节点 ID，并选择正确的区域和配置文件。这些是操作说明，并不表示已在你的账户上测试过会话。

### 依赖项与远程前提条件
AWS 文档将 AWS CLI 1.16.12 或更高版本列为本地最低要求；请使用当前受支持的 CLI 版本。你需要具有适当 IAM 权限的 AWS 凭证。远程节点需要 SSM Agent、适当的实例角色或混合激活配置，以及到所需 Systems Manager 端点的出站连接。基本会话的前提条件是 SSM Agent 2.3.68.0 或更高版本；端口转发和其他功能可能需要更新版本的 Agent。本地插件不会将非托管机器变成托管节点。通过 Session Manager 使用 SSH 还需要常规的 SSH 客户端/服务器及身份验证配置。

Homebrew 使用的签名 PKG 与 AWS 提供的另一种 ZIP 捆绑包不同。AWS 文档对 ZIP 安装脚本要求 Python 3.10 或更高版本；不要将该脚本要求视为额外的 Homebrew 运行时依赖项。源代码 README 中提到的 Go 和构建工具仅用于从源代码构建。Homebrew 未声明额外的 formula 依赖项、明确的 macOS 最低版本或软件包冲突。现有的手动安装或 PATH 链接可能与 cask 的可执行文件位置冲突；重新安装前请检查所选二进制文件。

### 平台支持
AWS 为 macOS Intel 和 Apple Silicon 提供原生软件包，并提供单独的 Windows 和 Linux 安装程序。此 Homebrew cask 仅安装 Mac 软件包。AWS 引用的安装指南未指定通用的 macOS 数值最低版本，因此此处不声称存在未经支持的最低版本。托管节点的操作系统支持属于 Systems Manager 的另一项要求，与插件本地运行主机的支持并不相同。这不是 iOS 或 Android 应用。AWS 目前要求插件版本为 1.2.764.0 或更高版本才能执行受支持的操作；所列的 1.2.835.0 高于这一最低要求。

### 账户、费用与许可
该插件采用 Apache License 2.0 开源，且没有单独的插件订阅费用。实际使用需要 AWS 账户或经授权访问 AWS 账户。EC2 资源、混合/高级管理、日志记录、存储、网络服务及其他可选 AWS 功能可能产生费用；安装免费的插件并不意味着相关云资源也免费。请查询 AWS 当前的定价，以了解计划配置的费用。普通 shell 会话可以配置日志记录，但 SSH 和端口转发内容的日志记录能力有所不同。

### 官方参考资料
- [插件存储库与 Apache 许可证](https://github.com/aws/session-manager-plugin)
- [插件安装](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html)
- [macOS 安装程序](https://docs.aws.amazon.com/systems-manager/latest/userguide/install-plugin-macos-overview.html)
- [会话前提条件](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-prerequisites.html)
- [版本历史](https://docs.aws.amazon.com/systems-manager/latest/userguide/plugin-version-history.html)
- [Systems Manager 定价](https://aws.amazon.com/systems-manager/pricing/)

## 系统要求

- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 1.2.896.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · 核查于 2026-11-22
  - <https://session-manager-downloads.s3.amazonaws.com/plugin/1.2.896.0/mac/session-manager-plugin.pkg>
  - SHA-256: `d9d960f04acb5ba419e0a12f769f9af4f3263e098b9b63e2de659189c138341a`
- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 1.2.896.0 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · 核查于 2026-11-22
  - <https://session-manager-downloads.s3.amazonaws.com/plugin/1.2.896.0/mac_arm64/session-manager-plugin.pkg>
  - SHA-256: `b95139a76cb473654d92185c200ac65205244b20f96aeb240b53837ba4973084`

## AWS Session Manager Plugin 的安全事实

这里只列可以核验的事实，并注明来源和日期，不是安全认证。要检查你下载的文件，可以用 OpenNavo 在本机扫描。

- <https://github.com/aws/session-manager-plugin> · 是否开源: 是 — <https://github.com/aws/session-manager-plugin> · 核查于 2026-11-13

## 卸载

- `brew uninstall --cask session-manager-plugin`

普通卸载会删除应用本身，设置和缓存会保留。

### 卸载时还会处理

- 安装包收据（pkgutil）: `session-manager-plugin` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

### 深度清理（可选）

- `brew uninstall --zap --cask session-manager-plugin`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `/Library/LaunchDaemons/SessionManagerPlugin.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 1.2.896.0 (2026-10-21)

回退名为「检查会话失败原因并避免会话挂起」的改动。

回退名为「检查会话失败原因并避免会话挂起」的改动。

Source: https://github.com/aws/session-manager-plugin/releases/tag/1.2.896.0

## 资料与来源

- <https://opennavo.com/zh/apps/session-manager-plugin>
- <https://opennavo.com/zh/apps/session-manager-plugin/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · 核查于 2026-11-22
- <https://formulae.brew.sh/cask/session-manager-plugin>
- <https://github.com/aws/session-manager-plugin> · 核查于 2026-11-13
