在 Ubuntu Server 16.04 LTS 64 位（Snap）、18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上安装 SSM Agent - Amazon Systems Manager
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

在 Ubuntu Server 16.04 LTS 64 位（Snap）、18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上安装 SSM Agent

开始前的准备工作

在 Ubuntu Server 16.04 LTS 64 位（Snap）、18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上安装 SSM Agent 之前，请注意以下事项：

由 Snap 或 deb 安装程序进行的版本 16.04 安装

在 Ubuntu Server 16.04 上，使用 Snap 或 deb 安装软件包安装 SSM Agent，具体取决于 16.04 AMI 的版本。

SSM Agent 安装程序文件位置

在 Ubuntu Server 16.04 LTS 64 位（Snap）、18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上，SSM Agent 安装程序文件（包括代理二进制文件和配置文件）均存储在以下目录中：/snap/amazon-ssm-agent/current/。如果要对此目录中的任何配置文件进行更改，则必须将这些文件从 /snap 目录复制到 /etc/amazon/ssm/ 目录。日志和二进制文件尚未更改（/var/lib/amazon/ssm、/var/log/amazon/ssm）。

使用 Snap candidate 通道

Snap 存储中的候选通道包含最新版本的 SSM Agent（包括所有最新的错误修复）；而不是稳定频道。要了解有关候选通道与稳定通道间差异的更多信息，请参阅风险级别（网址为 https://snapcraft.io/docs/channels）。

如果要跟踪 candidate 通道上的 SSM Agent 版本信息，请在您的 Ubuntu Server 20.04、18.04 和 16.04 LTS 64 位实例上运行以下命令。

sudo snap switch --channel=candidate amazon-ssm-agent
建议在版本 18.04 及更高版本上使用 Snap

在 Ubuntu Server 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上，建议仅使用 Snap。另外请确保实例上只安装并运行了代理的一个实例。如果不想 SSM Agent 与 Snap 一起使用，请卸载 SSM Agent。然后按照有关在 Ubuntu Server 16.04（deb）上安装 SSM Agent 的说明操作，将 SSM Agent 作为 debian 软件包安装。在安装之前，请确保未安装与要作为 Debian 软件包管理的软件包列表重叠的任何 Snap。

Maximum timeout exceeded 错误消息

由于 Snap 的已知问题，使用 snap 命令时您可能会看到 Maximum timeout exceeded 错误。如果您收到此错误，请运行以下命令（一次运行一条命令）来启动代理、停止它并检查其状态：

sudo systemctl start snap.amazon-ssm-agent.amazon-ssm-agent.service
sudo systemctl stop snap.amazon-ssm-agent.amazon-ssm-agent.service
sudo systemctl status snap.amazon-ssm-agent.amazon-ssm-agent.service
在 Ubuntu Server 16.04 LTS 64 位（Snap）、18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04（带有 Snap 包）上安装 SSM Agent

  1. 默认情况下，SSM Agent 安装在 Ubuntu Server 16.04 LTS 64 位（Snap）、18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 AMIs 上，标识符为 20180627 或更高版本。

    如果您需要在本地服务器上安装 SSM Agent或者需要重新安装代理，您可以使用以下脚本。您无需为下载指定 URL，因为 snap 命令会自动从 Snap 应用商店 https://snapcraft.io 下载代理。

    sudo snap install amazon-ssm-agent --classic

  2. 运行以下命令确定 SSM Agent是否在运行。

    sudo snap list amazon-ssm-agent

  3. 如果上一条命令返回 amazon-ssm-agent is stopped、inactive 或 disabled，则运行以下命令将启动服务。

    sudo snap start amazon-ssm-agent

  4. 检查代理的状态。

    sudo snap services amazon-ssm-agent