ConvertX 自托管文件转换完整指南：20 个转换工具、1000+ 格式一网打尽

ConvertX 自托管文件转换完整指南：20 个转换工具、1000+ 格式一网打尽

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

ConvertX 是一个自托管的在线文件转换工具：一个带界面的 Web 应用，把 FFmpeg、Pandoc、ImageMagick 等 20 个转换工具收进同一套账户、批量处理和自动清理体系里。它用 TypeScript 编写，运行在 Bun 上，由 Elysia 框架提供服务，官方声称支持超过 1000 种文件格式。

它解决的问题很具体：

• 批量转换：一次拖进多个文件，统一转成同一格式
• 多账户 + 密码保护：同事各用各的账号，互不串档
• 自动清理：默认 24 小时定期删除上传的原始文件和转换产物，服务器不越堆越满
• 转换结果可直接下载，历史页面还能回看每个任务的状态

图片、文档、视频、3D 模型，各类型能转什么

能力矩阵直接来自仓库里各转换器的格式清单（src/converters/下每个文件对应一个底层工具）：

它是怎么做到的：调度器 + 20 个命令行工具

ConvertX 自己并不做像素或字符级的转换，它做的事是调度：

1. 上传的文件存进该用户的专属目录，程序先归一化扩展名（src/helpers/normalizeFiletype.ts）。
2. 拿着「源格式 → 目标格式」去匹配 20 个转换器的能力表（核心调度逻辑在 src/converters/main.ts），选中第一个匹配的工具执行。
3. 批量文件按MAX_CONVERT_PROCESS限流分批跑，避免占满 CPU；每次转换的成败都会写进 SQLite，历史页据此展示。
4. 视频转换可以额外传 FFmpeg 参数（比如硬件加速-hwaccel vaapi），不用改代码，改环境变量即可。

也就是说：界面负责管理，命令行工具负责干活，你不需要在服务器上单独安装这些程序——Docker 镜像里已经打包好了。

Docker 部署步骤与关键环境变量

一行命令即可启动（端口 3000，数据落在挂载卷里）：

docker run -p 3000:3000 -v ./data:/app/data ghcr.io/c4illin/convertx

🐳 启动后访问http://localhost:3000，先创建你的账户——谁先注册谁就是第一个账号，别把服务裸奔着公开暴露。

常用环境变量（全部可选，见 README）：

• JWT_SECRET：强烈建议设置，用于签发登录凭证
• HTTP_ALLOWED=true：非 HTTPS 环境下必须开启，否则无法登录
• AUTO_DELETE_EVERY_N_HOURS：文件保留时长，默认 24 小时，设 0 关闭
• ACCOUNT_REGISTRATION：是否放行用户自行注册，默认关闭
• MAX_CONVERT_PROCESS：限制并发转换数，默认不限制
• WEBROOT：把站点挂到子路径，例如example.com/convert/

适合谁用

• 处理敏感资料的团队：合同、内部文档不需要经过第三方的在线转换站，转换记录也留在自己的数据库里
• 有固定转换需求的人：摄影师批量改 HEIC、写作者常转 EPUB、设计师来回转矢量图，省得记一堆命令行参数
• 自托管爱好者：Docker 一拉即跑，配合反代加个 HTTPS 就能给团队开内网服务

一句话总结

ConvertX 把 20 个格式转换工具装进同一个带账户、批量、自动清理的 Web 界面里。只要你的转换需求落在上表范围内，一条 Docker 命令就能把「上传 → 选格式 → 下载」的闭环跑起来。

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