convertor/docs/deployment/update.md
Your Name d563682753 feat: v0.1.9 - Setup 頁面 i18n + 語言選擇器 UI 修復 + 文件重構
 Features:
- 全頁拖曳上傳:檔案可拖曳到頁面任何位置
- Setup 頁面新增語言選擇器

🐛 Bug Fixes:
- 語言 icon 尺寸修復(h-5→h-6)
- Dropdown 背景完全不透明
- 新增 scrollbar 樣式

🌍 i18n:
- 所有 confirm/alert 訊息國際化
- Setup 頁面 i18n 完整化

📚 Documentation:
- README 精簡為開箱即用版本
- 新增 docs/deployment/, docs/config/, docs/versions/
2026-01-20 15:55:49 +08:00

2.3 KiB
Raw Blame History

版本更新指南

本文件說明如何更新 ConvertX-CN 到新版本。


使用 Docker Compose 更新

更新到最新版

# 1. 進入專案資料夾
cd ~/convertx-cn

# 2. 停止服務
docker compose down

# 3. 拉取最新映像檔
docker compose pull

# 4. 重新啟動
docker compose up -d

更新到指定版本

修改 docker-compose.yml

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

然後執行:

docker compose down
docker compose pull
docker compose up -d

驗證更新

查看 Log

docker compose logs | head -20

檢查網頁版本

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

檢查映像檔版本

docker images convertx/convertx-cn

備份建議

更新前建議備份 data 資料夾:

# Linux / macOS
cp -r ./data ./data.backup.$(date +%Y%m%d)

# Windows PowerShell
Copy-Item -Recurse .\data .\data.backup.$(Get-Date -Format "yyyyMMdd")

回滾版本

如果新版本有問題,可以回滾到舊版本:

services:
  convertx:
    image: convertx/convertx-cn:v0.1.8 # 舊版本
docker compose down
docker compose pull
docker compose up -d

清理舊映像檔

更新後可清理不再使用的舊映像檔,釋放磁碟空間:

docker image prune -a

⚠️ 此指令會刪除所有未使用的映像檔,不只是 ConvertX-CN。

只刪除 ConvertX-CN 舊版本:

# 列出所有版本
docker images convertx/convertx-cn

# 刪除特定版本
docker rmi convertx/convertx-cn:v0.1.7

自動更新(進階)

可使用 Watchtower 自動更新容器:

services:
  convertx:
    image: convertx/convertx-cn:latest
    # ... 其他設定

  watchtower:
    image: containrrr/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    command: --interval 86400 # 每 24 小時檢查一次

⚠️ 自動更新適合測試環境。生產環境建議手動更新,確認新版本穩定後再升級。


相關文件