• AWS Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。
# 在 Ubuntu Server 实例上手动安装 SSM Agent
**重要**
在 64 位版 Ubuntu Server 上安装 SSM Agent 之前，请确保您使用的安装工具正确。从使用 20180627 标识的 Amazon Machine Image (AMI) 开始，SSM Agent 已使用 Snap 安装包预安装到版本 16.04 上。在通过以前的 AMI 创建的实例上，必须使用 deb 安装程序包安装 SSM Agent。有关更多信息，请参阅 [确定要安装在 64 位 Ubuntu Server 16.04 实例上的正确 SSM Agent 版本](agent-install-ubuntu-about-v16.md)。
在大多数情况下，AWS 提供的适用于 Ubuntu Server 的 Amazon Machine Images（AMIs）附带默认情况下预安装的 AWS Systems Manager 代理（SSM Agent）。有关更多信息，请参阅 [查找预装了 SSM Agent 的 AMIs](ami-preinstalled-agent.md)。
如果 SSM Agent 未预安装在新的 Ubuntu Server 实例上，或者如果您需要手动重新安装代理，请使用此部分中的信息来帮助您。
**开始前的准备工作**
在 Ubuntu Server 实例上安装 SSM Agent 之前，请注意以下事项：
+ 有关适用于在所有基于 Linux 的操作系统上安装 SSM Agent 的重要信息，请参阅 [在适用于 Linux 的 EC2 实例上手动安装和卸载 SSM Agent](manually-install-ssm-agent-linux.md)。
**Topics**
+ [在 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](agent-install-ubuntu-64-snap.md)
+ [在 Ubuntu Server 16.04 64 位（deb）上安装 SSM Agent](agent-install-ubuntu-64-deb.md)
+ [在 Ubuntu Server 16.04 32 位上安装 SSM Agent](agent-install-ubuntu-32.md)
+ [确定要安装在 64 位 Ubuntu Server 16.04 实例上的正确 SSM Agent 版本](agent-install-ubuntu-about-v16.md)
# 在 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](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 软件包安装](agent-install-ubuntu-64-deb.md)。在安装之前，请确保未安装与要作为 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/amazon-ssm-agent) [https://snapcraft.io](https://snapcraft.io) 下载代理。
```
sudo snap install amazon-ssm-agent --classic
```
1. 运行以下命令确定 SSM Agent是否在运行。
```
sudo snap list amazon-ssm-agent
```
1. 如果上一条命令返回 `amazon-ssm-agent is stopped`、`inactive` 或 `disabled`，则运行以下命令将启动服务。
```
sudo snap start amazon-ssm-agent
```
1. 检查代理的状态。
```
sudo snap services amazon-ssm-agent
```
# 在 Ubuntu Server 16.04 64 位（deb）上安装 SSM Agent
**重要**
在 64 位版 Ubuntu Server 上安装 SSM Agent 之前，请确保您使用的安装工具正确。从使用 20180627 标识的 Amazon Machine Image (AMI) 开始，SSM Agent 已使用 Snap 安装包预安装到版本 16.04 上。在通过以前的 AMI 创建的实例上，必须使用 deb 安装程序包安装 SSM Agent。有关更多信息，请参阅 [确定要安装在 64 位 Ubuntu Server 16.04 实例上的正确 SSM Agent 版本](agent-install-ubuntu-about-v16.md)。如果 SSM Agent 与 Snap 一起安装到实例上，并且使用 deb 安装程序软件包安装或更新 SSM Agent，则安装或 SSM Agent 操作可能失败。
在大多数情况下，AWS 提供的 Amazon Machine Images（AMIs）Ubuntu Server 16.04 附带默认情况下预安装的 AWS Systems Manager 代理（SSM Agent）。有关更多信息，请参阅 [查找预装了 SSM Agent 的 AMIs](ami-preinstalled-agent.md)。
如果 SSM Agent 未在版本 20180627 之前预安装在新的 Ubuntu Server 16.04 实例上，或者如果您需要手动重新安装代理，请使用此页面上的信息来帮助您。
## Ubuntu Server 16.04（deb）上 SSM Agent 的快速安装命令
使用以下步骤在单个实例上手动安装 SSM Agent。此过程使用全局可用的安装文件。
**使用快速复制和粘贴命令在 Ubuntu Server 16.04 64 位（deb）上安装 SSM Agent**
1. 使用首选方法（例如 SSH）连接到您的 Ubuntu Server 实例。
1. 输入以下命令以在实例上创建临时目录。
```
mkdir /tmp/ssm
```
1. 更改为临时目录。
```
cd /tmp/ssm
```
1. 运行以下命令。
**注意**
即使以下命令中的 URL 包含 `ec2-downloads-windows` 目录，这些也是 Ubuntu Server 16.04 64 位的正确全局安装文件。
```
wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_amd64/amazon-ssm-agent.deb
```
```
sudo dpkg -i amazon-ssm-agent.deb
```
1. （建议）运行以下命令以确定 SSM Agent 是否在运行。
Ubuntu Server 16.04
```
sudo systemctl status amazon-ssm-agent
```
在大多数情况下，命令会报告代理正在运行。
在极少数情况下，命令会报告代理已安装但未运行，如下面的示例所示。
1. 如果上一条命令返回 `amazon-ssm-agent is stopped`、`inactive` 或 `disabled`，则运行以下命令将启动服务。
Ubuntu Server 16.04：
```
sudo systemctl enable amazon-ssm-agent
```
## 为您所在区域的 Ubuntu Server 16.04 64 位（deb）上的 SSM Agent 创建自定义安装命令
在使用脚本或模板在多个实例上安装 SSM Agent 时，建议使用存储在工作所在的 AWS 区域中的安装文件。
对于以下命令，我们提供了在美国东部（俄亥俄州）区域（`us-east-2`）使用可公开访问 S3 存储桶的示例。
**提示**
您还可以使用您构造的自定义区域 URL 替换本主题前面的 [Ubuntu Server 16.04（deb）上 SSM Agent 的快速安装命令](#quick-install-ub-16-14-64-bit) 程序中的全局 URL。
在下面的命令中，将 *region* 替换为您自己的信息。有关支持的 *region* 值的列表，请参阅《Amazon Web Services 一般参考》**中的 [Systems Manager service endpoints](https://docs.aws.amazon.com/general/latest/gr/ssm.html#ssm_region) 的 **Region** 列。
```
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
```
# 在 Ubuntu Server 16.04 32 位上安装 SSM Agent
在大多数情况下，AWS 提供的 Amazon Machine Images（AMIs）Ubuntu Server 16.04 附带默认情况下预安装的 AWS Systems Manager 代理（SSM Agent）。有关更多信息，请参阅 [查找预装了 SSM Agent 的 AMIs](ami-preinstalled-agent.md)。
如果 SSM Agent 未预装在新的 Ubuntu Server 16.04 实例上，或者如果您需要手动重新安装代理，请使用此页面上的信息来帮助您。
## Ubuntu Server 16.04 32 位（deb）上 SSM Agent 的快速安装命令
使用以下步骤在单个实例上手动安装 SSM Agent。此过程使用全局可用的安装文件。
**使用快速复制和粘贴命令在 Ubuntu Server 16.04 32 位（deb）上安装 SSM Agent**
1. 使用首选方法（例如 SSH）连接到您的 Ubuntu Server 实例。
1. 输入以下命令以在实例上创建临时目录。
```
mkdir /tmp/ssm
```
1. 更改为临时目录。
```
cd /tmp/ssm
```
1. 运行以下命令。
**注意**
即使以下命令中的 URL 包含 `ec2-downloads-windows` 目录，这也是 Ubuntu Server 16.04 32 位的正确全局安装文件。
```
wget https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/debian_386/amazon-ssm-agent.deb
```
```
sudo dpkg -i amazon-ssm-agent.deb
```
1. （建议）运行以下命令以确定 SSM Agent 是否在运行。
Ubuntu Server 16.04
```
sudo systemctl status amazon-ssm-agent
```
在大多数情况下，命令会报告代理正在运行。
在极少数情况下，命令会报告代理已安装但未运行，如下面的示例所示。
1. 如果上一条命令返回 `amazon-ssm-agent is stopped`、`inactive` 或 `disabled`，则运行以下命令将启动服务。
Ubuntu Server 16.04：
```
sudo systemctl enable amazon-ssm-agent
```
## 为您所在区域的 Ubuntu Server 16.04 32 位（deb）上的 SSM Agent 创建自定义安装命令
在使用脚本或模板在多个实例上安装 SSM Agent 时，建议使用存储在工作所在的 AWS 区域中的安装文件。
对于以下命令，我们提供了在美国东部（俄亥俄州）区域（`us-east-2`）使用可公开访问 S3 存储桶的示例。
**提示**
您还可以使用您构造的自定义区域 URL 替换本主题前面的 [Ubuntu Server 16.04 32 位（deb）上 SSM Agent 的快速安装命令](#quick-install-ub-16-14-32-bit) 程序中的全局 URL。
在下面的命令中，将 *region* 替换为您自己的信息。有关支持的 *region* 值的列表，请参阅《Amazon Web Services 一般参考》**中的 [Systems Manager service endpoints](https://docs.aws.amazon.com/general/latest/gr/ssm.html#ssm_region) 的 **Region** 列。
```
wget https://s3.region.amazonaws.com/amazon-ssm-region/latest/debian_386/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_386/amazon-ssm-agent.deb
```
```
sudo dpkg -i amazon-ssm-agent.deb
```
# 确定要安装在 64 位 Ubuntu Server 16.04 实例上的正确 SSM Agent 版本
**重要**
在 64 位版 Ubuntu Server 上安装 SSM Agent 之前，请确保您使用的安装工具正确。从使用 20180627 标识的 Amazon Machine Image (AMI) 开始，SSM Agent 已使用 Snap 安装包预安装到版本 16.04 上。在通过以前的 AMI 创建的实例上，必须使用 deb 安装程序包安装 SSM Agent。有关更多信息，请参阅 [确定要安装在 64 位 Ubuntu Server 16.04 实例上的正确 SSM Agent 版本](#agent-install-ubuntu-about-v16)
请注意，如果实例上已安装多个 SSM Agent（例如，一个是使用 Snap 安装的，一个是使用 deb 安装程序安装的），则代理将无法正常运行。
您可以使用以下任一方法对验证实例的源 AMI ID 创建日期。这些过程仅适用于 AWS 托管的 AMIs。
**验证源 AMI ID 创建日期（控制台）**
1. 通过以下网址打开 Amazon EC2 控制台：[https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)。
1. 在左侧导航窗格中，选择 **Instances (实例)**。
1. 选择一个实例。
1. 在**详细信息**选项卡上，检查 **AMI 名称**字段下的值中是否存在 `YYYYMMDD` 标识符。例如：`ubuntu/images/hvm-ssd/ubuntu-xenial-16.04-amd64-server-20180627`。
**验证源 AMI ID 创建日期 (AWS CLI）**
+ 运行如下命令。
```
aws ec2 describe-images --image-ids ami-id
```
*ami-id* 表示 AWS 提供的 AMI 的 ID（例如 `ami-07c8bc5c1ce9598c3`）。
如果成功，该命令将返回类似以下内容的信息，您可以在其中检查 `CreationDate` 和 `Name` 字段以获取信息。
```
{
"Images": [
{
"Architecture": "x86_64",
"CreationDate": "2020-07-24T20:40:27.000Z",
"ImageId": "ami-07c8bc5c1ce9598c3",
-- truncated --
"ImageOwnerAlias": "amazon",
"Name": "amzn2-ami-hvm-2.0.20200722.0-x86_64-gp2",
"RootDeviceName": "/dev/xvda",
"RootDeviceType": "ebs",
"SriovNetSupport": "simple",
"VirtualizationType": "hvm"
}
]
}
```