View a markdown version of this page

在 Ubuntu Server 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 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上安装 SSM Agent

开始前的准备工作

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

SSM Agent 安装程序文件位置

在 Ubuntu Server 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 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。另外请确保实例上只安装并运行了代理的一个实例。

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 18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04（带有 Snap 包）上安装 SSM Agent

  1. 默认情况下，SSM Agent 安装在 Ubuntu Server 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