ConvertX:一站式自托管在线文件转换平台,支持上千种格式

你是否曾经为了转换一个文件格式，在电脑上安装各种臃肿的软件，或者将敏感文件上传到第三方在线转换网站？如果你正在寻找一个既能保护隐私、又能满足多样化转换需求的自托管解决方案，那么 ConvertX 就是为你量身打造的工具。

💥什么是 ConvertX？

ConvertX 是一个功能强大的自托管在线文件转换器。它最大的亮点是 支持超过一千种不同的文件格式转换，涵盖了文档、图像、视频、电子书、3D模型等多种类型。该项目采用 TypeScript、Bun 和 Elysia 等现代技术栈开发，旨在为用户提供一个安全、高效、可完全掌控的本地化文件处理中心。

github地址：https://github.com/C4illin/ConvertX

该项目在github 已有15.3k ⭐star

☀️ 核心特性

• 海量格式支持： 支持上千种格式互转，几乎能满足所有日常及专业需求。
• 批量处理： 可以一次性上传并转换多个文件，显著提升工作效率。
• 隐私安全： 自托管意味着你的文件数据永远不会离开你自己的服务器，非常适合处理敏感或机密文档。
• 多用户账户： 支持为团队成员或家庭成员创建独立的账户，共享服务又保持个人文件历史隔离。
• 开源免费： 完全开源，代码透明，可自由部署和修改。

🎠强大的转换引擎阵容

ConvertX 的强大能力源于其背后整合的众多业界知名的开源转换工具，它们共同构成了一个超级转换工厂：

这个列表清晰地展示了 ConvertX 的格式覆盖广度。无论是常见的 .pdf、.docx、.mp4、.jpg，还是相对小众的格式，它都有很大可能支持。

🏍️快速部署指南

使用 Docker 部署 ConvertX 是极其简单的过程，只需几分钟即可拥有自己的转换服务。

1. 准备 docker-compose.yml 文件：

services:
  convertx:
  # 此服务的镜像3.59GB，国内下载比较慢，需要的家人们可以使用我转存阿里云镜像仓库的镜像
    image: registry.cn-hangzhou.aliyuncs.com/xjpublic/convertx
    container_name: convertx
    restart: unless-stopped
    ports:
      - "10000:3000"
    environment: 
      - ACCOUNT_REGISTRATION=false # true或false，首账户创建不受影响（例如若只需单账户可保持false）
      - JWT_SECRET=aLongAndSecretStringUsedToSignTheJSONWebToken1234 # 默认使用randomUUID()生成
      - HTTP_ALLOWED=true # 若要使用http访问，则设置为true
      - ALLOW_UNAUTHENTICATED=true  # 允许未登录用户使用服务，仅限本地环境设为true
      - AUTO_DELETE_EVERY_N_HOURS=24 # 每N小时检查并删除超过N小时的旧文件，设为0可禁用
    volumes:
      - ./data:/app/data

🐳Docker 镜像

每次发布时会更新 :latest 标签，每次推送到主分支时会更新 :main 标签。常规使用推荐使用 :latest 标签。

镜像可在 GitHub Container Registry 和 Docker Hub 获取。

此服务的镜像3.59GB，国内下载比较慢，需要的家人们可以使用我转存阿里云镜像仓库的镜像registry.cn-hangzhou.aliyuncs.com/xjpublic/convertx

1. 启动服务：

   在 docker-compose.yml 文件所在目录下运行：

   docker-compose up -d
   

2. 初始化账户：
   在浏览器中访问 http://你的服务器IP:3000。第一个注册的用户将自动成为管理员。

就这么简单！你已经成功搭建了一个功能完备的在线文件转换平台。

🛞环境变量

所有变量均为可选，但建议设置 JWT_SECRET。

🌅总结

ConvertX 完美地解决了一个核心痛点：在保障数据隐私的前提下，提供堪比甚至超越商业云服务的文件格式转换能力。 无论你是个人用户，想要一个干净、无广告、不限次数的本地转换工具；还是团队或组织，需要在内网部署一个安全的文件处理服务，ConvertX 都是一个极具吸引力的选择。

其基于 Docker 的一键式部署、详尽的配置选项和活跃的开源生态，使得从试用、部署到长期维护都变得非常轻松。如果你厌倦了在多个在线转换网站间跳转，或是对云服务的数据安全心存顾虑，不妨现在就尝试部署一个属于你自己的 ConvertX。