a06df23b1d
## 新功能 - OCRmyPDF 轉換引擎：將掃描版 PDF 轉換為可搜尋 PDF - 支援 7 種語言：en, zh-TW, zh, ja, ko, de, fr - 與 PDFMathTranslate 風格一致的 UI 格式 (pdf-<lang>) - 自動偵測頁面方向並旋轉 - 自動校正傾斜 - 跳過已有文字層的頁面 - 詳細的 5 階段處理進度輸出 ## 建置 - Dockerfile：安裝 ocrmypdf 與 Tesseract OCR 語言包 ## 文件 - 更新 OCR 功能文件 - 文件目錄結構改為中文名稱 ## 測試 - 修復 BabelDOC 和 PDFMathTranslate 測試的 OCR mock - 所有 345 個測試通過
3.7 KiB
3.7 KiB
常見問題 FAQ
🔐 登入與帳號
Q: 如何註冊帳號？
首次訪問 ConvertX-CN 時：
- 開啟
http://localhost:3000 - 點擊右上角 Register
- 輸入 Email 和密碼
- 完成！系統會自動登入
✅ 預設開放註冊，無需設定任何環境變數
Q: 可以關閉公開註冊嗎？
可以。如果您想限制只有現有用戶可使用：
environment:
- ACCOUNT_REGISTRATION=false
⚠️ 請確保您已經有至少一個帳號，否則將無法登入
Q: 忘記密碼怎麼辦？
目前版本尚未提供密碼重設功能。您可以：
- 刪除
data/convertx.db - 重新啟動容器
- 重新註冊
⚠️ 這會刪除所有用戶資料和轉換歷史
Q: 登入後又被踢回登入頁？
這通常是 Cookie 設定問題。請檢查：
-
沒有 HTTPS 但 HTTP_ALLOWED=false
- HTTP_ALLOWED=true # 允許 HTTP 連線 -
使用反向代理但沒設定 TRUST_PROXY
- TRUST_PROXY=true # 信任反向代理 -
沒有設定 JWT_SECRET
- JWT_SECRET=固定的隨機字串
🐳 Docker 相關
Q: 為什麼 Image 這麼大（4-6 GB）？
ConvertX-CN 是「完整版」，內建：
- LibreOffice（文件轉換）
- TexLive（LaTeX 支援）
- FFmpeg（影音轉換）
- Tesseract + 多語言 OCR
- CJK 字型
如果您只需要基本功能，可使用原作者的輕量版：ghcr.io/c4illin/convertx:latest
Q: Docker 啟動失敗？
常見原因：
- Port 被占用：改用其他 port，如
-p 3001:3000 - 磁碟空間不足：Image 需約 6GB
- 權限問題：確保
./data資料夾有寫入權限
chmod -R 777 ./data
Q: 資料存在哪裡？
所有資料存放在掛載的 /app/data 目錄：
./data/
├── convertx.db # SQLite 資料庫
├── uploads/ # 上傳的原始檔案
└── output/ # 轉換後的檔案
Q: 如何備份資料？
直接備份 ./data 資料夾：
tar -czvf convertx-backup.tar.gz ./data
Q: 如何更新版本？
docker compose pull
docker compose up -d
🌍 語言相關
Q: 如何切換介面語言？
- 點擊右上角語言圖示 🌐
- 從下拉選單選擇語言
- 頁面自動更新
語言偏好會儲存在 Cookie 中。
Q: 支援哪些語言？
目前支援 65 種語言，包含：
- 繁體中文、簡體中文
- 日文、韓文
- 英文、德文、法文
- 更多詳見 多語言支援
📄 轉換相關
Q: 支援哪些格式？
1000+ 種格式，詳見 支援的轉換器
Q: 轉換失敗怎麼辦？
- 檢查檔案是否損壞
- 檢查容器日誌：
docker logs convertx-cn - 嘗試不同的轉換引擎
Q: 檔案大小有限制嗎？
預設無限制，但可透過反向代理設定限制：
client_max_body_size 500M;
Q: 轉換很慢怎麼辦？
- 增加容器記憶體限制
- 考慮使用硬體加速（GPU）
- 限制同時轉換數量：
- MAX_CONVERT_PROCESS=2
🔧 進階問題
Q: 如何使用反向代理？
詳見 反向代理設定
Q: 如何啟用硬體加速？
詳見 進階配置 - 硬體加速
Q: 如何啟用 API Server？
docker compose --profile api up -d
詳見 API 文件
還有問題？
- 📖 查看 完整文件
- 🐛 回報問題：GitHub Issues
- 💬 討論區：GitHub Discussions