

• 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 16.04 LTS 64 位（Snap）、18.04、20.04、22.04 LTS、23.10、24.04 LTS、24.0 和 25.04 上安装 SSM Agent
<a name="agent-install-ubuntu-64-snap"></a>

**开始前的准备工作**  
在 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
   ```