# 使用 latest 標籤

本文件說明使用 `latest` 標籤的注意事項。

---

## 什麼是 latest？

```yaml
image: convertx/convertx-cn:latest
```

`latest` 是指向最新穩定版本的標籤。每次發布新版本時，`latest` 會自動更新。

---

## 優點

- 自動獲取新功能與修復
- 不需要手動修改 docker-compose.yml
- 適合快速測試

---

## 風險

### 意外更新

當執行 `docker compose pull` 時，會自動下載最新版本：

```bash
docker compose pull  # 可能拉到新版本
docker compose up -d # 使用新版本啟動
```

如果新版本有重大變更，可能影響正常使用。

### 無法回滾

如果沒有記錄使用的版本，出問題時難以回滾。

### 不一致

多台伺服器在不同時間部署，可能跑不同版本。

---

## 適用情境

| 情境     | 是否適合 latest |
| -------- | --------------- |
| 個人測試 | ✅              |
| 家庭使用 | ✅              |
| 團隊協作 | ⚠️ 視情況       |
| 生產環境 | ❌              |

---

## 使用建議

### 測試環境

```yaml
image: convertx/convertx-cn:latest
```

可以使用 `latest`，享受自動更新的便利。

### 生產環境

建議使用固定版本：

```yaml
image: convertx/convertx-cn:v0.1.9
```

詳見 [指定版本部署](pinned-version.md)。

---

## 如何知道 latest 是哪個版本？

### 方法 1：查看 log

```bash
docker compose logs | head -10
```

### 方法 2：檢查映像檔

```bash
docker inspect convertx/convertx-cn:latest | grep -i version
```

### 方法 3：查看網頁

開啟 `http://localhost:3000`，頁面底部會顯示版本號。

---

## 相關文件

- [指定版本部署](pinned-version.md)
- [版本更新指南](../deployment/update.md)
- [GitHub Releases](https://github.com/pi-docket/ConvertX-CN/releases)
