
ConvertX 用 Docker 自架轉檔夠方便,但「逾千格式」同私隱都要識睇
Office、PDF、圖片同影片共用一個介面,保安設定要自己負責
XDA Developers 作者 Ayush Pande 最近分享佢自架 ConvertX 嘅用法,賣點好直接:Office 文件、PDF、圖片、影片、電子書甚至 3D 檔案,都可以喺同一個網頁介面處理,唔使再將銀行文件、發票或者未公開資料交去來歷唔明嘅轉檔網站。不過原文標題講到「任何檔案轉任何格式」,呢句要打個折扣,官方資料其實冇咁講。
「逾千格式」係引擎總數,唔代表任意互轉
ConvertX 本身主要係一層管理介面,背後叫 LibreOffice、Pandoc、FFmpeg、ImageMagick、Inkscape、Calibre 等工具做實際轉換。官方支援表列出 LibreOffice 有 41 種輸入、22 種輸出,Pandoc 就係 43 入、65 出,FFmpeg 約有 472 入、199 出。呢啲數字加埋的確過千,但每個引擎都有自己嘅支援路徑,唔代表揀兩個副檔名就一定轉到,版面、字型、公式同媒體編碼亦可能限制結果。

圖片:ConvertX
安裝唔複雜,第一個帳戶要即刻開好
官方 Docker Compose 範例用 ghcr.io/c4illin/convertx image,將 3000 port 映射出嚟,再用 ./data:/app/data 保存資料。啟動後去 localhost:3000 開第一個帳戶,亦建議自行設定夠長嘅 JWT_SECRET。官方特別提醒,唔好將未完成設定嘅服務擺上網,因為任何人都可以搶先註冊第一個帳戶;HTTP_ALLOWED 同免登入模式亦只建議喺可信嘅本地環境使用。
常用格式齊,但轉換質素仲欠一輪對照測試
XDA 作者展示過試算表同 GIF 轉檔、PDF 轉 EPUB,以及 MP4 轉 MOV;ConvertX v0.18.0 亦加入用 LibreOffice 處理 PDF 轉 DOCX。不過原文冇逐項比較文字走位、字型替換、圖片壓縮或者影片畫質,所以而家只可以確認流程同格式選項,未足以話輸出效果贏過專用工具。ConvertX 背後仍然係嗰批開源引擎,遇上複雜 PowerPoint、掃描 PDF 或特殊 codec,結果主要睇對應引擎做得幾好。
檔案留喺自己部機,但唔係用完即時消失
按官方標準設定,輸入、輸出同記錄會放喺掛載到 /app/data 嘅本機資料夾,轉換工作亦由自己部 server 入面嘅程式處理。預設清理設定係每 24 小時檢查舊檔,所以自架減少咗文件交畀第三方服務嘅風險,但檔案仍會暫存落碟。處理身份證副本、合約或者公司文件時,最好縮短清理時間、限制資料夾權限,再配合磁碟加密。Docker container 預設仍可連出互聯網;要證明完全冇對外流量,就要另外設防火牆規則同監察連線。
資源佔用未有可信數字,「幾 TB 幾分鐘」唔好照單全收
XDA 作者話大型影片可以喺數分鐘內互轉,但冇交代影片長度、codec、係重新編碼定只換 container,亦冇列出 CPU、GPU、RAM 同儲存速度,呢句唔可以當 benchmark。ConvertX 官方同樣冇提供最低硬件或者閒置耗用數字。文件同圖片工作通常由 LibreOffice、Pandoc 或 ImageMagick 接手,影片就會拉起 FFmpeg;官方嘅 MAX_CONVERT_PROCESS 預設為 0,即係唔限制同時轉換數量。如果用 NAS 或低功耗迷你電腦,同一時間最多跑一至兩個轉換工作會穩陣啲。
自架私隱有價值,保安更新亦要自己跟
Self-hosted 唔等於裝完就安全。ConvertX 低過 v0.16.0 嘅版本曾有漏洞,已登入用戶可寫入任意檔案,仲可以執行程式;低過 v0.17.0 亦有路徑穿越漏洞,可刪除服務權限範圍內嘅其他檔案。最新 v0.18.0 再修正 conversion API 嘅另一個路徑穿越問題。呢段更新紀錄已經好清楚:服務應該留喺內網、關閉免登入、定期拉新版 image,亦唔好直接開 port 畀全世界撞入嚟。
偶爾轉一張冇敏感資料嘅圖片,網上服務始終快手;但屋企本身已有 NAS,又經常處理身份證副本、合約、財務文件或者大批影片,ConvertX 的確方便過逐個安裝工具。裝之前先核對常用格式嘅實際轉換路徑,裝完再測版面、畫質、CPU、RAM 同清理設定,先知佢啱唔啱自己部機長用。
參考來源
- XDA Developers — This Docker container converts any file to any format, so I stopped trusting sketchy websites with my private documents — original report
- ConvertX 官方 GitHub — 官方支援矩陣、Docker 安裝、帳戶、刪檔同並行設定
- ConvertX Releases — 核實 v0.18.0 功能同近期路徑穿越修正
- NVD:CVE-2025-66449 — 核實低過 v0.16.0 嘅任意檔案寫入同執行程式漏洞
- NVD:CVE-2026-24741 — 核實低過 v0.17.0 嘅任意檔案刪除漏洞
- ConvertX 官方 container package — 核實官方 image、支援架構同發佈來源
本文根據原文及公開資料整理;資料有出入時,以原文及官方資料為準。







