ConvertX
一款自托管的在线文件转换器，支持上千种格式，通过 Docker 轻松部署，提供批量转换、密码保护和多账户管理。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
自己架设的格式转换神器，千种格式随便转，隐私安全有保障。
核心功能
- 支持超过1000种文件格式的互转，涵盖文档、图像、视频、电子书、3D模型等
- 一键批量处理多个文件，节省大量时间
- 可设置密码保护和多账户系统，适合团队共享
- 基于 Docker 的极简部署，两行命令即可运行
- 自动清理过期转换文件，避免占用存储空间
避坑指南
- •首次登录必须使用 localhost 或 HTTPS，否则设置 HTTP_ALLOWED=true。
- •注册第一个用户后请立即关闭开放注册（默认 ACCOUNT_REGISTRATION=false），避免被他人滥用。
- •转换大文件时请确保服务器有足够的内存和磁盘空间，视频转换尤其消耗资源。
- •硬件加速（如 VAAPI）需要额外配置，请参考 FFMPEG_ARGS 环境变量。
适用场景
- 需要频繁转换办公文档（如 Word 转 PDF、Markdown 转 LaTeX）的个人或团队
- 将 HEIC 照片批量转换为 JPEG，并同时调整大小
- 转换电子书格式（EPUB 转 MOBI、AZW3 转 PDF）
- 处理视频文件（MP4 转 GIF、MKV 转 AVI）及音频转码
- 3D 模型格式转换（STL 转 OBJ、GLTF 转 FBX）
- 企业内网部署，确保文件不离开本地服务器
详细介绍
ConvertX 是一款自托管的在线文件转换工具，使用 TypeScript、Bun 和 Elysia 构建。它通过 FFmpeg、LibreOffice、ImageMagick、Pandoc、Calibre 等强大后端，支持上千种格式的转换。核心功能包括：批量文件处理、密码保护、多用户账户、自动清理过期文件，以及视频转换的硬件加速可选。通过 Docker 或 Docker Compose 即可轻松部署。适合注重隐私、希望完全掌控文件转换过程而不需将文档上传到第三方服务的用户。
常见问题与排障 (2)
故障排除为什么 CBZ 转 PDF 会失败，并出现 'Could not find any valid pages in comic' 错误？
CBZ档案中包含扩展名为.jpg的WEBP图片，Calibre的漫画输入插件因格式不匹配而拒绝接受。解决方法：使用unzip file.cbz解压CBZ，通过file 001.jpg识别错误标记的文件（输出显示RIFF Web/P数据），将其重命名为.webp，然后重新压缩为.cbz。或者，在打包前将图片批量转换为正确的JPEG格式。
故障排除为什么 ConvertX 在 TrueNAS 上会导致高 CPU 使用率和频繁轮询？
ConvertX在TrueNAS上高CPU使用率和频繁轮询通常是由健康检查配置错误引起的。确保您的TrueNAS应用配置使用专用的/healthcheck路径进行健康检查，以防止每秒产生不必要的请求。这可以减少CPU负载，并允许更深层的C-states以实现节能。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：在服务器上安装 Docker 和 Docker Compose
步骤2：创建 docker-compose.yml 文件，填入示例内容（设置 JWT_SECRET）
步骤3：运行 docker compose up -d 启动服务
- 步骤1：在服务器上安装 Docker 和 Docker Compose
- 步骤2：创建 docker-compose.yml 文件，填入示例内容（设置 JWT_SECRET）
- 步骤3：运行 docker compose up -d 启动服务
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
执行 docker compose down -v 停止并删除容器和数据卷，再删除项目目录即可。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs