3 条命令自托管 1000+ 格式的文件转换服务：ConvertX 部署实践

3 条命令自托管 1000+ 格式的文件转换服务：ConvertX 部署实践

【免费下载链接】ConvertX💾 Self-hosted online file converter. Supports 1000+ formats ⚙️项目地址: https://gitcode.com/GitHub_Trending/co/ConvertX

不想把文件传到云端转换网站？也不想往电脑里装十几款互不兼容的转换软件？ConvertX 是一个自托管的在线文件转换服务：部署在你自己的服务器或 NAS 上，之后在浏览器里就能完成文档、图片、音视频、电子书的格式转换，覆盖 1000+ 种格式，而文件全程不离开你的内网。

3 条命令启动文件转换服务

官方 Docker 镜像已预装 20 个转换工具（FFmpeg、LibreOffice、ImageMagick 等），无需自己编译环境：

mkdir convertx && cd convertx docker pull ghcr.io/c4illin/convertx docker run -d --name convertx -p 3000:3000 -v $PWD/data:/app/data ghcr.io/c4illin/convertx

启动后打开http://localhost:3000，注册第一个账号即可使用。注意：第一个账号谁都能注册，所以先别把服务暴露到公网上，注册完再考虑对外开放。

常用配置都是环境变量，在上面的docker run命令后追加即可，不需要改任何文件：

• HTTP_ALLOWED=true：不在本机、走内网 HTTP 访问时必须开启，否则登录会被拒
• AUTO_DELETE_EVERY_N_HOURS=12：上传文件和转换结果滞留 12 小时后自动清理（默认 24 小时，设0关闭），省得数据目录越攒越大
• JWT_SECRET=一串长随机字符：登录 token 的签名密钥，不设的话每次重建容器都会重新随机生成

浏览器里批量转文档、视频和图片

界面逻辑很直接：顶部选目标格式，中间拖入文件，底部列出所有支持该格式的转换器，点一下就开工。

批量把 Word 文档转成 PDF

一次拖入十几个.docx，统一选 PDF，服务会逐个处理完打包给你下。文档场景主要靠 LibreOffice（41 种输入格式）和 Pandoc（43 种输入、65 种输出，Markdown、LaTeX、Word 互转都归它），做课程资料、论文排版时省掉了反复打开 Word 导出这一步。

把 4K 视频转成手机能播的格式

FFmpeg 一个工具就覆盖约 472 种输入、199 种输出格式，4K 素材转成手机直接播放的 MP4，或者批量压缩视频体积，都是浏览器点两下的事。

转 iPhone 的 HEIC 照片和线稿

同事发来的 HEIC 照片，电脑打不开？传到服务里选 JPG 就行（由 libheif/vips 处理）。画师的线稿照片还能经 Potrace、VTracer 转成 SVG 矢量图，放大不糊。

所有转换器的输入输出格式矩阵在 src/converters/ 目录下，每个工具一个独立模块，界面上看到的格式标签就是从这里来的。

部署 ConvertX 后的 4 条实用提醒

• ⚠️登录不进去：服务默认只允许 localhost 或 https 访问，内网 HTTP 访问必须加HTTP_ALLOWED=true，这是最常见的"打不开"原因
• 提示unable to open database file：本地数据目录属主和容器内用户不一致，对data目录执行chown -R $USER:$USER data再重启容器
• 树莓派这类小内存设备：设MAX_CONVERT_PROCESS=2限制并发转换进程数（默认 0 为不限制），避免同时转两个大视频把内存吃光
• 视频转得太慢：加FFMPEG_OUTPUT_ARGS=-preset veryfast用少量压缩率换明显提速；有核显的机器还可以加FFmpeg 硬件加速参数，比如FFMPEG_ARGS=-hwaccel vaapi

ConvertX 适合家里有 NAS 或一台常开旧机、又不想把文件交给云端的人，一个人用或搭个小团队共享都没压力。完整的环境变量清单在 README.md 的部署章节里，缺什么格式转换器可以直接去项目社区提 issue。

【免费下载链接】ConvertX💾 Self-hosted online file converter. Supports 1000+ formats ⚙️项目地址: https://gitcode.com/GitHub_Trending/co/ConvertX