嗨，我是小华同学，专注解锁高效工作与前沿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 为例：
# 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：
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，文档与教程丰富。
