

• 2026 年 4 月 30 日之後將不再提供 AWS Systems Manager CloudWatch Dashboard。客戶可以繼續使用 Amazon CloudWatch 主控台來檢視、建立和管理其 Amazon CloudWatch 儀表板，就像現在一樣。如需詳細資訊，請參閱 [Amazon CloudWatch Dashboard 文件](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 AMI 的版本而定，在版本 16.04 AMI 上，使用 Snaps 或 deb 安裝套件安裝 SSM Agent。

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 安裝程式檔案 (包括 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)。  
如果您想追蹤候選頻道上的 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 上，建議您僅使用 Snaps。另外驗證代理程式只有一個執行個體在您的執行個體上安裝和執行。如果您想要在沒有 Snaps 的情況下使用 SSM Agent，請解除安裝 SSM Agent。然後，使用在 Ubuntu Server 16.04 (deb) 上安裝 SSM Agent 的說明，[安裝 SSM Agent 作為 debian 套件](agent-install-ubuntu-64-deb.md)。在安裝之前，請確定您安裝的任何 Snaps 不會與您想要作為 debian 套件進行管理的套件清單重疊。

`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
   ```