ConvertX-CN

開箱即用的全功能檔案轉換服務 | Self-hosted File Converter - Full Edition

---

✨ 什麼是 ConvertX-CN？

ConvertX-CN 是基於 C4illin/ConvertX 的完整版 Fork，專為中文使用者優化，並預載所有轉換依賴。

🎉 一鍵部署，無需額外配置
使用者 不需要自己寫 Dockerfile，直接 docker run 或 docker compose up 即可使用。

主要特色

特色	說明
🌍 65+ 語言支援	繁體中文、簡體中文、英文、日文、韓文等 65 種語言
📦 完整內建	LibreOffice、FFmpeg、Pandoc、Calibre 等 20+ 轉換器
🎨 CJK 字型	Noto CJK、微軟核心字型、標楷體等中日韓字型
🔤 OCR 支援	Tesseract + 多語言語言包
⚡ LaTeX 完整版	TexLive Full，支援所有 LaTeX 需求
🐳 開箱即用	一個 Docker 命令即可啟動

---

🚀 快速開始

最快方式：Docker Run

# 1. 建立資料夾
mkdir -p data

# 2. 啟動容器
docker run -d \
  --name convertx-cn \
  -p 3000:3000 \
  -v ./data:/app/data \
  -e TZ=Asia/Taipei \
  convertx/convertx-cn:latest

開啟瀏覽器訪問 http://localhost:3000，直接註冊帳號即可使用！

✅ 預設開放註冊：無需設定環境變數，首次使用直接點擊 Register 註冊

推薦方式：Docker Compose

建立 docker-compose.yml：

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-change-me

docker compose up -d

📖 完整部署指南請見 → docs/getting-started.md

---

🌍 語言支援

ConvertX-CN 支援 65 種語言，包括：

區域	語言
東亞	繁體中文（預設）、简体中文、日本語、한국어
歐洲	English, Deutsch, Français, Español, Italiano, Português, Русский, Polski, Nederlands, Українська, Čeština, Svenska, Dansk, Suomi, Norsk, Ελληνικά, Magyar, Română, Български, Hrvatski, Slovenčina, Slovenščina, Lietuvių, Latviešu, Eesti, Српски, Català, Euskara, Galego, Íslenska, Gaeilge, Cymraeg, Malti, Македонски, Shqip
中東/南亞	العربية, עברית, فارسی, Türkçe, हिन्दी, বাংলা, தமிழ், తెలుగు, मराठी, ગુજરાતી, ಕನ್ನಡ, മലയാളം, नेपाली, සිංහල
東南亞	ไทย, Tiếng Việt, Bahasa Indonesia, Bahasa Melayu, Filipino, မြန်မာ, ខ្មែរ, ລາວ
非洲	Afrikaans, Kiswahili, አማርኛ, isiZulu

語言會根據瀏覽器設定自動偵測，也可透過右上角選單手動切換。

---

📦 內建轉換器

轉換器	用途	輸入格式	輸出格式
FFmpeg	影音	~472	~199
ImageMagick	圖片	245	183
GraphicsMagick	圖片	167	130
LibreOffice	文件	41	22
Pandoc	文件	43	65
Calibre	電子書	26	19
Inkscape	向量圖	7	17
Assimp	3D 模型	77	23

完整列表 → docs/converters.md

---

📖 文件導覽

文件	說明
🚀 快速開始	Docker 部署教學
🐳 Docker 配置	完整 Docker 設定指南
⚙️ 環境變數	所有環境變數說明
❓ 常見問題	FAQ 疑難排解
🌍 多語言	i18n 語言設定與新增
📦 轉換器列表	支援的轉換格式完整列表

---

🐳 Docker Image

Tag	說明
convertx/convertx-cn:latest	最新穩定版
convertx/convertx-cn:v0.1.5	指定版本

⚠️ 由於內建完整依賴，Image 約 4-6 GB，首次下載需較長時間。

---

📸 預覽

---

🛠️ 開發

# 安裝依賴
bun install

# 開發模式
bun run dev

# 建構
bun run build

歡迎 Pull Request！請使用 Conventional Commits 格式。

---

🙏 致謝

本專案基於 C4illin/ConvertX 開發。

---

📜 License

MIT License

---

Powered by ConvertX-CN
https://github.com/pi-docket/ConvertX-CN