convertor/README.md
Your Name d563682753 feat: v0.1.9 - Setup 頁面 i18n + 語言選擇器 UI 修復 + 文件重構
 Features:
- 全頁拖曳上傳:檔案可拖曳到頁面任何位置
- Setup 頁面新增語言選擇器

🐛 Bug Fixes:
- 語言 icon 尺寸修復(h-5→h-6)
- Dropdown 背景完全不透明
- 新增 scrollbar 樣式

🌍 i18n:
- 所有 confirm/alert 訊息國際化
- Setup 頁面 i18n 完整化

📚 Documentation:
- README 精簡為開箱即用版本
- 新增 docs/deployment/, docs/config/, docs/versions/
2026-01-20 15:55:49 +08:00

3.2 KiB
Raw Blame History

ConvertX-CN

ConvertX-CN

開箱即用的全功能檔案轉換服務 — 5 分鐘完成部署

Docker Pulls GitHub Release


這是什麼?

自架的檔案轉換服務,支援 1000+ 格式,包含影音、圖片、文件、電子書等。
已內建 LibreOffice、FFmpeg、Pandoc 等 20+ 轉換器與中日韓字型,一個 Docker 命令就能跑


快速部署

1. 建立資料夾

mkdir -p ~/convertx-cn/data && cd ~/convertx-cn

Windows 請用 mkdir C:\convertx-cn\datacd C:\convertx-cn

2. 建立 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=請改成你自己的隨機字串至少32字元
參數 說明 必要
./data 存放檔案的資料夾,必須先建立
JWT_SECRET 登入驗證金鑰,不設會每次重啟被登出
TZ 時區(預設 UTC

3. 啟動

docker compose up -d

首次下載約 4-6 GB需等待幾分鐘。

4. 使用

開啟 http://localhost:3000,註冊帳號即可使用。


常見問題

問題 解法
登入後又被踢回登入頁 設定 HTTP_ALLOWED=true(本地測試)或 TRUST_PROXY=true(反向代理)
重啟後資料消失 確認 ./data:/app/data 且資料夾存在
重啟後被登出 設定固定的 JWT_SECRET

更多問題 → docs/faq.md


更新版本

cd ~/convertx-cn
docker compose down
docker compose pull
docker compose up -d

詳細說明 → docs/deployment/update.md


進階設定

需求 文件
完整環境變數 docs/config/environment.md
反向代理 / HTTPS docs/deployment.md
安全性設定 docs/config/security.md
Docker Compose 範例 docs/docker-compose/
版本選擇指南 docs/versions/

預覽

ConvertX-CN Preview


License

MIT | 基於 C4illin/ConvertX