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 KiB
2 KiB
指定版本部署
本文件說明如何使用固定版本標籤部署 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 |
最新開發版（不穩定） | - |
升級到新版本
- 查看 Changelog 確認變更
- 修改 docker-compose.yml 的版本號
- 執行更新
docker compose down
docker compose pull
docker compose up -d
詳見 版本更新指南。
回滾到舊版本
如果新版本有問題：
- 修改版本號為舊版本
image: convertx/convertx-cn:v0.1.8
- 重新部署
docker compose down
docker compose pull
docker compose up -d
生產環境建議
部署流程
- 在測試環境使用
latest或新版本 - 確認功能正常
- 記錄版本號
- 生產環境使用該固定版本
版本記錄
建議在 docker-compose.yml 加上註解：
services:
convertx:
# 2026-01-20 升級：修復 PDF 轉換問題
image: convertx/convertx-cn:v0.1.9