No description
bunconversionconvertconverterdocument-conversionelysiafile-conversionfile-converterhacktoberfestpdf-converterself-hostedtailwindcsstypescript
558d638df8
## Changes ### i18n Module Fixes - Fix import paths in service.ts, languageSelector.tsx, header.tsx, base.tsx, results.tsx - Change from '../i18n' to '../i18n/index' or './index' for proper module resolution ### Registration (Breaking Change) - Change ACCOUNT_REGISTRATION default from false to true (out-of-box ready) - Login and Register pages now both visible by default ### Version Bump - Update package.json to v0.1.4 - Update CHANGELOG.md with v0.1.4 release notes - Update README.md and docs with new version numbers ### Build Verification - bun run build: PASSED - Docker build: PASSED - TypeScript compilation: PASSED (no errors) |
||
|---|---|---|
| .devcontainer | ||
| .github | ||
| .vscode | ||
| docs | ||
| fonts | ||
| images | ||
| public | ||
| src | ||
| tests/converters | ||
| .bun-version | ||
| .dockerignore | ||
| .gitignore | ||
| biome.json | ||
| bun.lock | ||
| CHANGELOG.md | ||
| compose.yaml | ||
| Dockerfile | ||
| eslint.config.ts | ||
| knip.json | ||
| LICENSE | ||
| mise.toml | ||
| package.json | ||
| postcss.config.js | ||
| prettier.config.js | ||
| README.md | ||
| renovate.json | ||
| SECURITY.md | ||
| tsconfig.eslint.json | ||
| tsconfig.json | ||
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
docker run -d \
--name convertx-cn \
-p 3000:3000 \
-v ./data:/app/data \
-e ACCOUNT_REGISTRATION=true \
convertx/convertx-cn:latest
開啟瀏覽器訪問 http://localhost:3000，建立帳號即可開始使用！
推薦方式：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
- ACCOUNT_REGISTRATION=true
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 設定指南 |
| ⚙️ 環境變數 | 所有環境變數說明 |
| 💾 儲存與 URL | 檔案儲存機制說明 |
| 🔧 進階用法 | 硬體加速、反向代理等 |
| 🌍 多語言 | i18n 語言設定與新增 |
| 📦 轉換器列表 | 支援的轉換格式完整列表 |
🐳 Docker Image
| Tag | 說明 |
|---|---|
convertx/convertx-cn:latest |
最新穩定版 |
convertx/convertx-cn:v0.1.4 |
指定版本 |
⚠️ 由於內建完整依賴，Image 約 4-6 GB，首次下載需較長時間。
📸 預覽
🛠️ 開發
# 安裝依賴
bun install
# 開發模式
bun run dev
# 建構
bun run build
歡迎 Pull Request！請使用 Conventional Commits 格式。
🙏 致謝
本專案基於 C4illin/ConvertX 開發。
📜 License
Powered by ConvertX-CN
https://github.com/pi-docket/ConvertX-CN