Add comprehensive documentation for ConvertX-CN deployment and configuration

- 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
This commit is contained in:
Your Name 2026-01-23 22:05:09 +08:00
parent c2d3d13c89
commit 3f1a5e0fbf
51 changed files with 544 additions and 579 deletions

View file

@ -1,105 +0,0 @@
# 使用 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)