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
2026-01-23 22:05:09 +08:00 · 2026-01-23 22:05:09 +08:00 · 3f1a5e0fbf
commit 3f1a5e0fbf
parent c2d3d13c89
51 changed files with 544 additions and 579 deletions
--- a/docs/部署指南/Docker組合.md
+++ b/docs/部署指南/Docker組合.md
@ -0,0 +1,163 @@
+# Docker Compose 詳解
+
+本文件說明 docker-compose.yml 的完整設定選項。
+
+---
+
+## 基本結構
+
+```yaml
+services:
+  convertx:
+    image: convertx/convertx-cn:latest
+    container_name: convertx-cn
+    restart: unless-stopped
+    ports:
+      - "3000:3000"
+    volumes:
+      - ./data:/app/data
+    environment:
+      - TZ=Asia/Taipei
+      - JWT_SECRET=your-secret-key
+```
+
+---
+
+## 映像檔選擇
+
+```yaml
+image: convertx/convertx-cn:latest   # 最新穩定版
+image: convertx/convertx-cn:v0.1.9   # 指定版本
+```
+
+- `latest`：自動獲取最新版本，適合測試環境
+- 指定版本：適合生產環境，避免意外升級
+
+詳見 [版本選擇指南](../版本/)。
+
+---
+
+## 連接埠設定
+
+```yaml
+ports:
+  - "3000:3000" # 主機埠:容器埠
+  - "8080:3000" # 使用 8080 埠
+  - "127.0.0.1:3000:3000" # 僅本地存取
+```
+
+| 設定                    | 說明                 |
+| ----------------------- | -------------------- |
+| `"3000:3000"`           | 所有網路介面可存取   |
+| `"127.0.0.1:3000:3000"` | 僅本機可存取         |
+| `"8080:3000"`           | 使用 8080 埠對外開放 |
+
+---
+
+## 資料儲存
+
+### 使用資料夾掛載（推薦）
+
+```yaml
+volumes:
+  - ./data:/app/data
+```
+
+- 資料存在主機上的 `./data` 資料夾
+- 方便備份、遷移、直接存取
+
+### 使用 Docker Volume
+
+```yaml
+volumes:
+  - convertx_data:/app/data
+
+volumes:
+  convertx_data:
+```
+
+- 資料由 Docker 管理
+- 備份需透過 Docker 指令
+
+---
+
+## 環境變數
+
+### 必要設定
+
+```yaml
+environment:
+  - JWT_SECRET=your-secret-key-at-least-32-chars
+```
+
+### 建議設定
+
+```yaml
+environment:
+  - TZ=Asia/Taipei
+  - HTTP_ALLOWED=true # 本地測試
+  - ACCOUNT_REGISTRATION=true
+```
+
+### 生產環境設定
+
+```yaml
+environment:
+  - TZ=Asia/Taipei
+  - JWT_SECRET=your-production-secret
+  - HTTP_ALLOWED=false
+  - TRUST_PROXY=true
+  - ACCOUNT_REGISTRATION=false
+  - AUTO_DELETE_EVERY_N_HOURS=24
+```
+
+完整環境變數說明請參考 [環境變數文件](../配置設定/環境變數.md)。
+
+---
+
+## 重啟策略
+
+```yaml
+restart: unless-stopped  # 推薦
+restart: always          # 總是重啟
+restart: on-failure      # 僅失敗時重啟
+restart: "no"            # 不自動重啟
+```
+
+---
+
+## 資源限制
+
+```yaml
+deploy:
+  resources:
+    limits:
+      memory: 4G
+      cpus: "2"
+    reservations:
+      memory: 1G
+      cpus: "0.5"
+```
+
+---
+
+## 健康檢查
+
+```yaml
+healthcheck:
+  test: ["CMD", "curl", "-f", "http://localhost:3000/healthcheck"]
+  interval: 30s
+  timeout: 10s
+  retries: 3
+  start_period: 60s
+```
+
+---
+
+## 完整範例
+
+請參考 [Docker Compose 範例資料夾](../Docker組合配置/):
+
+- `compose.minimal.yml` - 最精簡設定
+- `compose.production.yml` - 生產環境
+- `compose.reference.yml` - 完整參考