嗨,我是小华同学,专注解锁高效工作与前沿AI工具!每日精选开源技术、实战技巧,助你省时50%、领先他人一步。👉免费订阅,与10万+技术人共享升级秘籍!

ConvertX 是一款自托管的在线文件转换工具,支持超过 1000 种格式,通过 FFmpeg、Pandoc、GraphicsMagick 等强大组件实现视频、文档、图像、3D 模型等文件的转换,确保转换过程私密高效
痛点场景
- 隐私问题:许多在线转换平台会收集用户文件,而 ConvertX 完全本地部署,确保数据不外流。
- 格式多样:面对不同场景(视频转码、文档格式转换、图形批量处理等),手动搭配工具复杂、效率低。
- 跨平台不便:在 NAS/私有服务器上,无法方便统一管理各种转换环境。
ConvertX 出手:一键转换,覆盖主流格式,后台可设置定时清理、权限分离,解决安全与效率双痛点。
核心功能
- 支持 1000+ 格式转换:包括视频(FFmpeg)、文档(Pandoc)、图像(GraphicsMagick/Vips/Inkscape)、3D(Assimp)、LaTeX 等 。
- 多账户 & 密码保护:支持注册登录、密码保护功能,适应多人使用环境 。
- 批量处理 & 历史记录:可以一次上传多文件,转换完成后查看详细历史记录。
- 自托管 & Docker/NAS 支持:简单部署,兼容 Docker、Portainer、群晖和 TrueNAS 。
- 界面简洁友好:Tailwind 风格界面,拖拽上传、下拉选择格式、进度/下载按钮,使用即上手。
技术架构

架构优势
特性 | 描述 |
---|---|
全集成多引擎 | 内置 FFmpeg、Pandoc、GraphicsMagick、Vips、Inkscape、Assimp,统一管理转换流程 |
Bun + Elysia 高效 | 搭配 TypeScript,轻量高性能,适合部署在低资源设备 |
容器化部署 | 提供官方 ghcr 镜像,支持 Docker Compose、Portainer、群晖和 TrueNAS 一键部署 |
可配置性强 | 支持多用户、文件自动清除、语言本地化、隐藏历史、HTTPS/WebSocket 等配置 |
界面效果

快速上手指南
以下内容以 PNG 转 WebP
为例:
bash
# Docker 一键部署
docker run -d \
-p 3000:3000 \
-v ./data:/app/data \
-e JWT_SECRET="你的随机秘钥" \
ghcr.io/c4illin/convertx:latest
- 浏览器访问
http://localhost:3000
创建管理员账户; - 上传
.png
图像 → 选择.webp
格式 → 点击 Convert → 下载或在线预览; - 使用历史页面查看所有转换记录,并支持批量下载。
对于群晖 NAS 用户,可通过以下 YML 代码用 Portainer 添加 Stack:
bash
services:
convertx:
image: ghcr.io/c4illin/convertx:latest
ports:
- 3522:3000
volumes:
- /volume1/docker/convertx:/app/data
environment:
JWT_SECRET: "随机字符串"
ACCOUNT_REGISTRATION: true
HTTP_ALLOWED: true
ALLOW_UNAUTHENTICATED: false
restart: on-failure:5
完整安装流程详见:如何在群晖/TrueNAS 上部署 ConvertX 。
应用场景
- 设计师:将 AI、PSD 图批量转换为 WebP/JPG,用于官网或电商发布;
- 内容运营:Markdown/PDF/Word 多格式互转,用于公众号内容制作;
- 开发者:通过 API 实现 DevOps 流程中自动生成预览图、PDF 等;
- 媒体团队:批量压缩高清 MP4、MKV、AVI 等视频格式;
- 电子书爱好者:EPUB ⇆ mobi ⇆ PDF 格式互转,兼容 Kindle、iPad。
同类对比
项目 | 格式支持 | 部署方式 | 用户管理 | 界面体验 | 隐私安全 |
---|---|---|---|---|---|
ConvertX | ❗超 1000+ | Docker/NAS/TrueNAS | ✅ 支持多用户 | ✅ 清爽、拖拽体验 | ✅ 完全自托管 |
Morphos | 数百种 | Docker | API 支持 | ⭐ 简洁 | ✅ 自托管,但格式少 |
TynzX/ConvertX | 主攻音·视频 | Node.js 场景 | 不支持多用户 | ✅ 现代 UI | ✅ 私有部署,但引擎单一 |
优势总结:
- 格式支持更全:覆盖图文、视频、文档、3D、LaTeX 等;
- 引擎整合性高:不同格式统一处理流程;
- 部署方式灵活:兼容多平台;
- 功能贴合场景:批量转换、多账户、历史记录本土化。
总结
ConvertX 是一个极具实际价值的文件转换解决方案:
- 全覆盖格式:一站式转换多种文件类型;
- 自托管权控制:无厂商依赖,隐私安全有保障;
- 易用界面和批量功能:适用于各种使用场景;
- 平台兼容性高:Docker、NAS、TrueNAS 都支持;
- 社区活跃度优:超过 5000 Star,文档与教程丰富。