d235ba7505
- 將 Python 安裝分成多個 RUN 步驟 - 修正 apt-get purge 在 lists 清除後失敗的問題 - 添加動態版本號修改步驟到 docker-build-lite.yml - Lite 版 UI 將顯示 X.Y.Z-lite 版本號
245 lines
7.8 KiB
Markdown
245 lines
7.8 KiB
Markdown
# ConvertX-CN Lite 版
|
||
|
||
ConvertX-CN Lite 是專為一般使用者設計的輕量版本，提供快速部署與較小的 Docker Image 體積。
|
||
|
||
---
|
||
|
||
## 📦 什麼是 Lite 版？
|
||
|
||
| 特性 | Full 版 | Lite 版 |
|
||
| -------------- | ---------------------------- | ------------------------ |
|
||
| **Image 大小** | 約 8-12 GB | 約 1.2-1.5 GB |
|
||
| **部署時間** | 較長（需下載大型模型） | 快速 |
|
||
| **記憶體需求** | 較高（AI 模型） | 較低 |
|
||
| **適用場景** | 進階使用者、需要 AI/OCR/翻譯 | 一般使用者、基本轉檔需求 |
|
||
|
||
---
|
||
|
||
## ✅ Lite 版包含的功能
|
||
|
||
### 核心功能
|
||
|
||
- ✅ **多語言 UI**：完整 i18n 介面（65 種語言）
|
||
- ✅ **檔案上傳/轉檔/下載**：完整流程支援
|
||
- ✅ **轉檔進度與錯誤提示**
|
||
|
||
### 轉換引擎
|
||
|
||
| 引擎 | 功能說明 | 支援格式 |
|
||
| ------------------ | ------------------ | -------------------------------------------- |
|
||
| **LibreOffice** | 文件轉檔 | DOC, DOCX, XLS, XLSX, PPT, PPTX, ODT, PDF... |
|
||
| **GraphicsMagick** | 圖片轉檔 | PNG, JPG, GIF, WEBP, BMP, TIFF... |
|
||
| **FFmpeg** | 影音轉檔（精簡版） | MP4, MP3, WAV, AVI, MKV, MOV... |
|
||
| **Pandoc** | 文件格式轉換 | Markdown, HTML, DOCX, LaTeX, EPUB... |
|
||
|
||
### PDF 功能
|
||
|
||
| 功能 | 說明 |
|
||
| ---------------- | ----------------------------------------------- |
|
||
| **PDF/A 轉換** | 使用 Ghostscript 轉換為 PDF/A-1b、PDF/A-2b |
|
||
| **PDF 防修改** | 使用 qpdf 設定權限保護 |
|
||
| **PDF 數位簽章** | 使用 PFX/PKCS#12 憑證簽章（單一簽章，不含 LTV） |
|
||
|
||
---
|
||
|
||
## ❌ Lite 版未包含的功能
|
||
|
||
以下功能僅在 Full 版中提供：
|
||
|
||
| 功能類別 | 功能說明 |
|
||
| ------------------- | ------------------------------ |
|
||
| **向量圖轉換** | Inkscape（SVG, PDF, PNG, EPS） |
|
||
| **高效能圖片** | VIPS（大型圖片處理） |
|
||
| **OCR** | Tesseract OCR 文字辨識 |
|
||
| **PDF 翻譯** | PDFMathTranslate、BabelDOC |
|
||
| **PDF 轉 Markdown** | MinerU 智能擷取 |
|
||
| **AI 模型** | YOLO、VLM 等深度學習模型 |
|
||
| **電子書** | Calibre（ePub、MOBI 轉換） |
|
||
| **CAD/3D** | assimp、OpenCascade |
|
||
| **PDF/A 驗證** | veraPDF |
|
||
| **長期驗證** | LTV、OCSP、CRL、TSA |
|
||
| **完整 TexLive** | 進階 LaTeX 排版 |
|
||
|
||
---
|
||
|
||
## 🚀 快速開始
|
||
|
||
### Docker Run
|
||
|
||
```bash
|
||
docker run -d \
|
||
--name convertx-cn-lite \
|
||
--restart unless-stopped \
|
||
-p 3000:3000 \
|
||
-v ./data:/app/data \
|
||
-e TZ=Asia/Taipei \
|
||
-e JWT_SECRET=你的隨機字串至少32字元 \
|
||
convertx/convertx-cn:latest-lite
|
||
```
|
||
|
||
### Docker Compose
|
||
|
||
```yaml
|
||
services:
|
||
convertx:
|
||
image: convertx/convertx-cn:latest-lite
|
||
container_name: convertx-cn-lite
|
||
restart: unless-stopped
|
||
ports:
|
||
- "3000:3000"
|
||
volumes:
|
||
- ./data:/app/data
|
||
environment:
|
||
- TZ=Asia/Taipei
|
||
- JWT_SECRET=你的隨機字串至少32字元
|
||
```
|
||
|
||
```bash
|
||
docker compose up -d
|
||
```
|
||
|
||
---
|
||
|
||
## 🏷️ Image Tag 說明
|
||
|
||
| Tag | 說明 |
|
||
| ---------------------------------- | ----------------- |
|
||
| `convertx/convertx-cn:latest` | Full 版最新穩定版 |
|
||
| `convertx/convertx-cn:latest-lite` | Lite 版最新穩定版 |
|
||
| `convertx/convertx-cn:0.1.15` | Full 版指定版本 |
|
||
| `convertx/convertx-cn:0.1.15-lite` | Lite 版指定版本 |
|
||
|
||
---
|
||
|
||
## 🔧 自行擴充 Lite 版功能
|
||
|
||
如果您使用 Lite 版但需要部分進階功能，可以透過 Docker Compose 擴充。
|
||
|
||
### 方法 1：使用 Docker Compose Override
|
||
|
||
建立 `docker-compose.override.yml`：
|
||
|
||
```yaml
|
||
# docker-compose.override.yml
|
||
# 在 Lite 版基礎上擴充功能
|
||
|
||
services:
|
||
convertx:
|
||
# 使用自定義 Dockerfile 擴充
|
||
build:
|
||
context: .
|
||
dockerfile: Dockerfile.lite.custom
|
||
```
|
||
|
||
建立 `Dockerfile.lite.custom`：
|
||
|
||
```dockerfile
|
||
# Dockerfile.lite.custom
|
||
# 基於 Lite 版擴充
|
||
|
||
FROM convertx/convertx-cn:latest-lite
|
||
|
||
# 範例：新增 Tesseract OCR
|
||
RUN apt-get update && apt-get install -y --no-install-recommends \
|
||
tesseract-ocr \
|
||
tesseract-ocr-eng \
|
||
tesseract-ocr-chi-tra \
|
||
&& rm -rf /var/lib/apt/lists/*
|
||
|
||
# 範例：新增 Calibre
|
||
# RUN apt-get update && apt-get install -y --no-install-recommends \
|
||
# calibre \
|
||
# && rm -rf /var/lib/apt/lists/*
|
||
```
|
||
|
||
### 方法 2：直接使用 Full 版
|
||
|
||
如果需要完整功能，建議直接使用 Full 版：
|
||
|
||
```yaml
|
||
services:
|
||
convertx:
|
||
image: convertx/convertx-cn:latest # Full 版
|
||
```
|
||
|
||
### ⚠️ 重要提醒
|
||
|
||
- Lite 版**本身不包含** OCR、AI、翻譯等進階功能
|
||
- 自行擴充會增加 Image 大小與維護成本
|
||
- 如需完整功能，建議直接使用 Full 版
|
||
|
||
---
|
||
|
||
## 📊 Lite vs Full 功能對照表
|
||
|
||
| 功能類別 | 功能 | Lite | Full |
|
||
| --------- | ---------------------------- | :--: | :--: |
|
||
| **UI** | 多語言介面（65 語言） | ✅ | ✅ |
|
||
| **UI** | 深色/淺色主題 | ✅ | ✅ |
|
||
| **轉檔** | 文件轉檔（LibreOffice） | ✅ | ✅ |
|
||
| **轉檔** | 圖片轉檔（GraphicsMagick） | ✅ | ✅ |
|
||
| **轉檔** | 圖片轉檔（ImageMagick） | ❌ | ✅ |
|
||
| **轉檔** | 影音轉檔（FFmpeg） | ✅ | ✅ |
|
||
| **轉檔** | 文件格式（Pandoc） | ✅ | ✅ |
|
||
| **轉檔** | 向量圖（Inkscape） | ❌ | ✅ |
|
||
| **轉檔** | 高效能圖片（VIPS） | ❌ | ✅ |
|
||
| **轉檔** | 電子書（Calibre） | ❌ | ✅ |
|
||
| **轉檔** | CAD/3D（assimp） | ❌ | ✅ |
|
||
| **PDF** | PDF/A 轉換 | ✅ | ✅ |
|
||
| **PDF** | PDF 防修改 | ✅ | ✅ |
|
||
| **PDF** | PDF 數位簽章 | ✅ | ✅ |
|
||
| **PDF** | PDF/A 驗證（veraPDF） | ❌ | ✅ |
|
||
| **PDF** | 長期驗證（LTV） | ❌ | ✅ |
|
||
| **OCR** | 文字辨識（Tesseract） | ❌ | ✅ |
|
||
| **OCR** | ocrmypdf | ❌ | ✅ |
|
||
| **AI** | PDF 翻譯（PDFMathTranslate） | ❌ | ✅ |
|
||
| **AI** | PDF 翻譯（BabelDOC） | ❌ | ✅ |
|
||
| **AI** | PDF 轉 Markdown（MinerU） | ❌ | ✅ |
|
||
| **字型** | 基本 CJK 字型 | ✅ | ✅ |
|
||
| **字型** | 完整 Noto 字型集 | ❌ | ✅ |
|
||
| **LaTeX** | 基本 LaTeX | ❌ | ✅ |
|
||
| **LaTeX** | 完整 TexLive CJK | ❌ | ✅ |
|
||
|
||
---
|
||
|
||
## 💡 選擇建議
|
||
|
||
### 適合使用 Lite 版的情境
|
||
|
||
- 🔹 僅需要基本的文件/圖片/影音轉檔
|
||
- 🔹 伺服器資源有限（VPS、NAS）
|
||
- 🔹 需要快速部署
|
||
- 🔹 不需要 OCR、AI、翻譯功能
|
||
|
||
### 適合使用 Full 版的情境
|
||
|
||
- 🔹 需要 OCR 文字辨識
|
||
- 🔹 需要 PDF 翻譯功能
|
||
- 🔹 需要 MinerU PDF 轉 Markdown
|
||
- 🔹 需要電子書轉換（ePub、MOBI）
|
||
- 🔹 需要 CAD/3D 檔案處理
|
||
- 🔹 需要進階 PDF/A 驗證
|
||
|
||
---
|
||
|
||
## 📝 版本更新
|
||
|
||
Lite 版與 Full 版使用相同的版本號規則，但 tag 不同：
|
||
|
||
```bash
|
||
# 更新 Lite 版
|
||
docker compose pull
|
||
docker compose up -d
|
||
|
||
# 或指定版本
|
||
docker pull convertx/convertx-cn:0.2.0-lite
|
||
```
|
||
|
||
---
|
||
|
||
## 🔗 相關連結
|
||
|
||
- [Docker Hub](https://hub.docker.com/r/convertx/convertx-cn)
|
||
- [GitHub Repository](https://github.com/pi-docket/ConvertX-CN)
|
||
- [Full 版部署指南](Docker.md)
|
||
- [環境變數說明](../配置設定/環境變數.md)
|