在 Debian Server 实例上手动安装 SSM Agent - Amazon Systems Manager
Debian Server 上的 SSM Agent 的快速安装命令为您所在区域的 Debian Server 创建自定义代理安装命令
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

在 Debian Server 实例上手动安装 SSM Agent

Amazon 提供的适用于 Debian Server 的 Amazon Machine Images（AMIs）不附带默认情况下预安装的 Amazon Systems Manager 代理（SSM Agent）。有关可能在其上预安装代理的 Amazon 托管式 AMIs 的列表，请参阅 查找预装了 SSM Agent 的 AMIs。

使用本节中的信息可帮助您在 Debian Server 实例上手动安装或重新安装 SSM Agent。

开始前的准备工作

在 Debian Server 实例上安装 SSM Agent 之前，请注意以下事项：

Debian Server 上的 SSM Agent 的快速安装命令

使用以下步骤在单个实例上手动安装 SSM Agent。此过程使用全局可用的安装文件。

在 Debian Server 上安装 SSM Agent

  1. 使用首选方法（例如 SSH）连接到您的 Debian Server 实例。

  2. 输入以下命令以在实例上创建临时目录。

    mkdir /tmp/ssm

  3. 运行以下命令以更改到临时目录。

    cd /tmp/ssm

  4. 复制实例架构的命令并在实例上运行它。

    注意

    即使以下命令中的 URL 包含 ec2-downloads-windows 目录，这些也是 Debian Server 的正确全局安装文件。

    对于 Debian Server 8，仅支持 x86_64 架构。

    x86_64 实例
    wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_amd64/amazon-ssm-agent.deb
    ARM64 实例
    wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_arm64/amazon-ssm-agent.deb

  5. 运行以下命令。

    sudo dpkg -i amazon-ssm-agent.deb

  6. （建议）请使用以下命令验证代理是否正在运行。

    sudo systemctl status amazon-ssm-agent

    在大多数情况下，命令会报告代理正在运行，如下面的示例所示。

    ● amazon-ssm-agent.service - amazon-ssm-agent
   Loaded: loaded (/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor
   Active: active (running) since Tue 2025-04-19 16:25:03 UTC; 4s ago
 Main PID: 628 (amazon-ssm-agen)
   CGroup: /system.slice/amazon-ssm-agent.service
           ├─628 /usr/bin/amazon-ssm-agent
           └─650 /usr/bin/ssm-agent-worker
            --truncated--

    在极少数情况下，命令会报告代理已安装但未运行，如下面的示例所示。

    ● amazon-ssm-agent.service - amazon-ssm-agent
   Loaded: loaded (/lib/systemd/system/amazon-ssm-agent.service; enabled; vendor
   Active: inactive (dead) since Tue 2025-04-19 16:26:30 UTC; 5s ago
 Main PID: 628 (code=exited, status=0/SUCCESS)
            --truncated--

    要在这些情况下激活代理，请运行以下命令。

    sudo systemctl enable amazon-ssm-agent
    sudo systemctl start amazon-ssm-agent

为您所在区域的 Debian Server 创建自定义代理安装命令

在使用脚本或模板在多个实例上安装 SSM Agent 时，建议使用存储在工作所在的 Amazon Web Services 区域中的安装文件。

对于以下命令，我们提供了在美国东部（俄亥俄州）区域（us-east-2）使用可公开访问 S3 存储桶的示例。

提示

您还可以使用您构造的自定义区域 URL 替换本主题前面的 Debian Server 上的 SSM Agent 的快速安装命令 程序中的全局 URL。

在下面的命令中，将 region 替换为您自己的信息。有关支持的 region 值的列表，请参阅《Amazon Web Services 一般参考》中的 Systems Manager service endpoints 的 Region 列。

x86_64
wget https://s3.region.amazonaws.com/amazon-ssm-region/latest/debian_amd64/amazon-ssm-agent.deb
sudo dpkg -i amazon-ssm-agent.deb

请参阅以下示例。

wget https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/debian_amd64/amazon-ssm-agent.deb
sudo dpkg -i amazon-ssm-agent.deb
ARM64
wget https://s3.region.amazonaws.com/amazon-ssm-region/latest/debian_arm64/amazon-ssm-agent.deb
sudo dpkg -i amazon-ssm-agent.deb

请参阅以下 示例。

wget https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/debian_arm64/amazon-ssm-agent.deb
sudo dpkg -i amazon-ssm-agent.deb