ConvertX 是一套自托管的在线文件格式转换工具，当前版本 0.19.0，采用 AGPL-3.0 许可。它通过 Docker 一键部署，内置 Inkscape、ImageMagick、FFmpeg、Calibre、LibreOffice 等众多转换器，支持上千种格式互转。
一、项目简介
ConvertX 由作者 C4illin 维护，使用 TypeScript、Bun 与 Elysia 构建，支持批量处理、密码保护与多账号。仓库地址 https://github.com/C4illin/ConvertX 。
二、项目功能
1. 大量格式支持
内置 20 多个转换引擎，涵盖矢量图、图片、视频、电子书、文档、3D 资产等上千种格式。
2. 批量处理与密码
可同时处理多个文件，支持密码保护与多账号，未登录用户可配置是否允许。
3. 自托管部署
以 Docker 镜像运行，数据落本地磁盘，文件按时间自动清理，可定制品牌与路径。
三、项目亮点
ConvertX 把常用转换能力打包进一个自托管服务，兼顾功能广度与数据隐私。对需要频繁转换又不放心云端服务的用户较合适。
对比在线转换站
对比 ConvertX 和在线转换网站的差异在数据与可控。前者数据留在本机，后者需上传第三方且受单文件限制。
| 对比项 | ConvertX | 在线转换站 |
|---|---|---|
| 数据 | 本地处理 | 上传云端 |
| 格式 | 上千种 | 受限 |
| 批量 | 支持 | 常受限 |
四、项目结构
项目为 Bun + Elysia 工程，前端界面与转换调度、各转换器适配分层，data 目录存放运行数据，镜像内置全部转换引擎。
五、技术栈
- 开发语言 TypeScript，运行时 Bun
- 框架 Elysia
- 内置 20+ 转换引擎
- 许可 AGPL-3.0
项目由作者 C4illin 维护，最后更新 2026 年，版本持续迭代，更新记录见 GitHub Releases。仓库地址 https://github.com/C4illin/ConvertX 。
六、本地快速部署启动
方式一 Docker 运行
docker run -p 3000:3000 -e PUID=1000 -e PGID=1000 -v ./data:/app/data ghcr.io/c4illin/convertx 后访问 http://localhost:3000。
方式二 环境变量配置
设置 JWT_SECRET 用于签名，按需开启 HTTP_ALLOWED，公网部署务必保持 ACCOUNT_REGISTRATION 与 ALLOW_UNAUTHENTICATED 关闭。
方式三 设置自动清理
用 AUTO_DELETE_EVERY_N_HOURS 控制历史文件清理周期，避免磁盘占满。
适用场景与建议
适用场景，适合私有部署做团队文件转换服务，也适合不想把文件上传云端的人群。首次访问注意先注册首个账号并配置权限，避免匿名开放。建议给数据卷设置合理权限并定期备份，JWT_SECRET 务必改成强随机值。对需要高吞吐的团队，可设置 MAX_CONVERT_PROCESS 限制并发进程数，并配合 AUTO_DELETE_EVERY_N_HOURS 自动清理历史文件，避免磁盘被长期占用。若部署在非 HTTPS 环境，记得开启 HTTP_ALLOWED，否则可能无法登录。
国内加速与备份
国内访问较慢时可用 ghfast.top 等镜像加速前缀，更详细的部署说明可扫码获取本站备份。备份包版本 v0.19.0，文件校验 sha256 12f31c8c6436dd05497a13bf891291723c3ca7a5a3ee4aad8d8f6ca34b28ce76 。
七、项目代码地址
项目代码地址 https://github.com/C4illin/ConvertX 。
常见问题
问. ConvertX 是做什么的
它是一套自托管在线文件转换器，支持上千种格式互转。
问. 怎么快速部署
用 Docker 运行镜像并映射数据卷，浏览器打开对应端口即可。
问. 和在线转换站有什么区别
对比在线转换站，ConvertX 数据在本机处理，格式更全且支持批量。
问. 是否开源免费
项目以 AGPL-3.0 协议开源，自托管免费。
