Hello大家好！我是助你打破信息差的
开发者导航。今天给大家分享的开源项目是【ConvertX】，一个【支持千种格式、本地安全处理的开源自托管文件转换工具】，希望这篇文章能够对你有所帮助。

在日常工作与学习中，人们经常需要转换文件格式——比如将PDF转Word、图片转SVG、电子书换格式，但依赖在线转换工具存在文件隐私泄露风险，而本地软件又需频繁安装不同工具。ConvertX恰好解决了这些痛点，它是一款可自托管的开源文件转换工具，所有处理都在本地完成，支持超千种格式，{ConvertX}可在GitHub获取，让用户既能高效转换文件，又能保障数据安全。

ConvertX是什么？

ConvertX是一款基于TypeScript、Bun与Elysia构建的开源自托管文件转换工具，核心定位是为用户提供本地可控的多格式文件转换服务。它无需依赖第三方在线平台，通过Docker部署即可在本地环境运行，支持图片、文档、视频、3D资产等超千种格式的转换，同时具备批量处理、密码保护、多账户管理等功能，所有文件处理过程均在本地完成，有效保护用户隐私与数据安全。

核心功能

ConvertX主要服务于有本地文件转换需求的个人用户、小型团队及企业，包括设计师、程序员、办公族、电子书爱好者等，能帮助他们摆脱对在线工具的依赖，高效完成格式转换。其核心功能如下：

• 超千种格式转换——集成15类专业转换器（如ImageMagick、FFmpeg、Calibre），支持图片、文档、视频、3D资产、电子书等类型，覆盖从常见格式（如JPG转PNG、PDF转DOCX）到专业格式（如LaTeX转PDF、3D模型格式互转）的转换需求。
• 批量文件处理——支持同时上传多个文件并批量转换，无需逐一操作，大幅提升处理效率，尤其适合需要批量转换图片、文档的场景。
• 本地自托管部署——通过Docker快速部署，所有文件转换均在本地服务器或设备上完成，不将文件上传至第三方服务器，避免隐私泄露与数据安全风险。
• 多账户与权限管理——支持创建多个用户账户，可对不同账户设置使用权限，同时提供文件密码保护功能，防止未授权访问转换后的文件。
• 灵活的环境配置——支持通过环境变量自定义设置（如JWT密钥、文件自动删除时间、HTTP访问权限），适配不同使用场景（如本地个人使用、团队内部共享）。
• 转换历史记录——自动记录用户的文件转换历史，方便用户追溯过往操作，可随时重新下载转换后的文件或再次发起同类转换。

使用场景

不同需求的用户在多种场景下，都能通过ConvertX解决文件格式转换问题，常见使用场景如下：

操作指南

ConvertX基于Docker部署，操作流程简洁，新手用户可在15分钟内完成部署并启动首次文件转换，具体步骤如下：

1. 准备部署环境：确保本地设备已安装Docker与Docker Compose（若使用Compose部署），Windows、macOS、Linux系统均支持，推荐Linux系统以获得更优性能。
2. 访问ConvertX的GitHub页面，获取部署配置文件参考：可选择使用Docker Compose或直接通过Docker命令部署。
3. 若使用Docker Compose：创建docker-compose.yml文件，复制官方示例配置（包含镜像地址、端口映射、环境变量、数据卷挂载），建议自定义JWT_SECRET为随机长字符串（增强安全性），保存文件后执行docker-compose up -d启动服务。
4. 若使用Docker命令：直接在终端执行docker run -p 3000:3000 -v ./data:/app/data ghcr.io/c4illin/convertx，其中./data为本地存储转换文件与数据的目录，可自行修改路径。
5. 服务启动后，打开浏览器访问http://localhost:3000，首次访问需创建管理员账户（注意：未配置时任何人可注册首个账户，建议部署后立即创建并关闭开放注册）。
6. 登录账户后，进入转换页面：点击「Choose a file」或拖拽文件至上传区域，选择需要转换的目标格式（可通过顶部搜索框快速查找格式），点击「Convert」开始转换。
7. 转换完成后，页面会显示下载链接，点击即可获取转换后的文件；转换历史可在「History」页面查看，支持重新下载或删除历史记录。
8. （可选）若需调整配置（如开启文件自动删除、隐藏历史页面），可修改docker-compose.yml中的环境变量（如AUTO_DELETE_EVERY_N_HOURS=12），重启服务后生效（执行docker-compose restart）。

支持平台

ConvertX采用Docker容器化部署，具备跨平台特性，支持主流操作系统：

• Linux系统：包括Ubuntu、CentOS、Debian等，推荐作为服务器或本地部署的首选，兼容性最佳，可直接通过系统终端执行Docker命令部署。
• macOS系统：支持Intel与Apple Silicon芯片，需先安装Docker Desktop for Mac，再按照部署步骤操作，性能表现稳定。
• Windows系统：需安装Docker Desktop for Windows（建议开启WSL2以提升容器性能），部署流程与其他系统一致，但需注意文件路径格式（如将./data改为C:/convertx-data）。
  此外，ConvertX以Web界面提供服务，用户可通过任意设备的浏览器（如Chrome、Safari、Edge）访问使用，无需安装客户端。

产品定价

ConvertX是一款完全免费的开源工具，遵循MIT许可证，用户可从GitHub免费获取源代码、Docker镜像及部署文档，无需支付任何费用即可使用全部核心功能（如格式转换、批量处理、自托管部署）。项目无任何付费功能、会员体系或广告，用户还可根据自身需求修改源码进行二次开发，或通过Docker Hub、GitHub Container Registry免费拉取官方镜像。

常见问题

Q：ConvertX支持的格式数量众多，如何快速找到自己需要的转换格式？
A：在上传文件后的转换页面顶部，有「Search for conversions」搜索框，输入格式名称（如“PDF”“PNG”）即可快速筛选支持的转换方向；同时，页面会根据上传文件的格式，自动推荐常用的目标格式，减少查找时间。
Q：部署ConvertX后，访问时提示“无法登录”或“连接不安全”，该如何解决？
A：若通过非localhost或非HTTPS方式访问，需在部署配置中添加HTTP_ALLOWED=true环境变量（仅建议本地或信任网络中使用）；若提示“无法打开数据库文件”，需对本地数据目录执行权限设置命令（如chown -R $USER:$USER ./data），确保Docker容器有读写权限。
Q：转换大文件（如GB级视频、多页PDF）时，会出现卡顿或失败吗？如何优化？
A：转换大文件的性能取决于本地设备的CPU、内存与存储速度，建议为设备分配足够资源（如至少4GB RAM、双核CPU）；若转换视频，可通过FFMPEG_ARGS环境变量添加优化参数（如-preset veryfast）提升速度；若频繁失败，可检查Docker容器日志（docker logs convertx）排查具体错误（如格式不支持、资源不足）。

开发者小结

ConvertX的核心优势在于“本地安全”与“格式全面”，它解决了用户对文件隐私保护的核心顾虑，同时通过集成多类专业转换器覆盖超千种格式，满足从日常办公到专业场景的转换需求，且部署灵活、操作简单，适合个人与团队长期使用。不过，其局限性在于依赖Docker环境（对新手有一定入门门槛），且转换大文件或专业格式时，性能受本地设备配置影响较大，需用户自行优化硬件或参数。整体而言，它是一款性价比极高的自托管文件转换工具，尤其适合注重数据隐私、有多样化格式转换需求的用户。