3f1a5e0fbf
- Create 指定版本部署.md to explain fixed version deployment - Create 最新版.md detailing the use of the latest tag - Create 版本選擇指南.md to guide users on version selection - Add Nginx and Traefik configuration examples for reverse proxy - Introduce minimal and production configuration examples - Develop Docker deployment guide with detailed steps - Implement quick start guide for first-time Docker users - Include version update instructions and rollback procedures - Add troubleshooting section for common issues - Enhance overall documentation structure and links for better navigation
2.3 KiB
2.3 KiB
版本更新指南
本文件說明如何更新 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 自動更新容器：
💡
--interval 86400— 每 24 小時檢查一次更新
services:
convertx:
image: convertx/convertx-cn:latest
# ... 其他設定
watchtower:
image: containrrr/watchtower
volumes:
- /var/run/docker.sock:/var/run/docker.sock
command: --interval 86400
⚠️ 自動更新適合測試環境。生產環境建議手動更新，確認新版本穩定後再升級。