convertor/docs/versions/pinned-version.md

指定版本部署

本文件說明如何使用固定版本標籤部署 ConvertX-CN。

---

為什麼要指定版本？

使用固定版本可以：

• 確保每次部署結果一致
• 避免意外升級造成問題
• 方便在多台伺服器部署相同版本
• 出問題時容易回滾

---

如何指定版本

修改 docker-compose.yml：

services:
  convertx:
    image: convertx/convertx-cn:v0.1.9 # 指定版本

---

查看可用版本

GitHub Releases

https://github.com/pi-docket/ConvertX-CN/releases

Docker Hub

# 列出所有標籤
docker search convertx/convertx-cn --limit 100

# 或查看 Docker Hub 網頁
# https://hub.docker.com/r/convertx/convertx-cn/tags

---

版本命名規則

格式	說明	範例
vX.Y.Z	正式版本	v0.1.9
latest	最新穩定版	-
main	最新開發版（不穩定）	-

---

升級到新版本

1. 查看 Changelog 確認變更
2. 修改 docker-compose.yml 的版本號
3. 執行更新

docker compose down
docker compose pull
docker compose up -d

詳見 版本更新指南。

---

回滾到舊版本

如果新版本有問題：

1. 修改版本號為舊版本

image: convertx/convertx-cn:v0.1.8

2. 重新部署

docker compose down
docker compose pull
docker compose up -d

---

生產環境建議

部署流程

1. 在測試環境使用 latest 或新版本
2. 確認功能正常
3. 記錄版本號
4. 生產環境使用該固定版本

版本記錄

建議在 docker-compose.yml 加上註解：

services:
  convertx:
    # 2026-01-20 升級：修復 PDF 轉換問題
    image: convertx/convertx-cn:v0.1.9

---

相關文件

• 使用 latest 標籤
• 版本更新指南
• Changelog