拒绝隐私泄露！ConvertX 深度解析：打造支持 1000+ 格式的私有转换工厂

你是否曾因为将敏感的 PDF 或个人视频上传到在线转换网站而感到不安？开源项目 ConvertX 正是为了终结这种焦虑而生。它是一款基于 Bun 和 TypeScript 开发的高性能、自托管文件转换平台，通过集成业内最顶尖的开源引擎，让你的私有服务器瞬间变身全能转换器。

---

🌟 ConvertX 核心亮点

ConvertX 不是简单的文件搬运工，它是一个强大的底层引擎协调器：

• 📁 格式霸主：支持超过 1000 种 格式转换，涵盖文档、图片、音视频、电子书甚至 3D 资产。
• 🚀 极速性能：采用 Bun 运行时 和 Elysia 框架，响应速度极快，远超传统 Node.js 应用。
• 👥 多用户管理：支持多账号系统，你可以为团队成员创建独立账户。
• 🔒 安全隐私：支持输出文件密码保护，且支持定时自动清理任务，确保服务器不被垃圾文件占满。
• 📦 批量处理：支持一次性拖入多个文件进行并发转换。

---

🏗️ 幕后功臣：它集成了哪些顶尖引擎？

ConvertX 聪明地“站在巨人的肩膀上”，通过调用以下成熟的开源项目来实现极致的兼容性：

转换类型	核心驱动引擎	适用场景示例
视频/音频	FFmpeg	MP4 转 GIF, MOV 转 MP3, 视频压缩
位图图像	ImageMagick / Vips	WEBP 转 PNG, 大图裁切, 格式互转
文档转换	Pandoc / LibreOffice	DOCX 转 PDF, HTML 转 Markdown
电子书	Calibre	EPUB 转 MOBI / PDF
矢量图	Inkscape / resvg	SVG 转 PNG / PDF
3D 模型	Assimp	常见的 3D 格式互转

---

🛠️ 准备工作：前置环境需求

• 硬件：建议 2 核 CPU / 4GB 内存以上（视频转换较消耗资源）。
• 环境：
  • 方案 A（推荐）：Docker & Docker Compose。
  • 方案 B：Bun 运行环境（如果你打算直接在裸机运行）。
• 系统：Linux (Ubuntu/CentOS), Windows (通过 Docker Desktop) 或 macOS。

---

🚀 部署方案：手把手教你搭建

1️⃣ 方案一：Docker Compose 一键部署（推荐 🐳）

这是最稳定且易于维护的方式。

1. 创建目录并编写配置：mkdir convertx && cd convertx nano docker-compose.yml
2. 复制以下内容到文件：services: convertx: image: ghcr.io/c4illin/convertx container_name: convertx restart: unless-stopped ports: - "3000:3000" environment: - JWT_SECRET=YourSuperSecretKey123 # 必填：用于安全校验 - ACCOUNT_REGISTRATION=true # 建议首次运行设为 true，注册后关掉 - AUTO_DELETE_EVERY_N_HOURS=24 # 每24小时自动清理过期文件 volumes: - ./data:/app/data
3. 启动服务：docker-compose up -d 访问 http://服务器IP:3000 即可看到清新简单的登录界面。

---

2️⃣ 方案二：手动部署 (基于 Bun 🐍)

如果你想在本地进行开发或轻量运行：

# 1. 安装 Bun
curl -fsSL https://bun.sh/install | bash

# 2. 克隆项目并安装
git clone https://github.com/C4illin/ConvertX.git
cd ConvertX
bun install

# 3. 运行项目
bun run dev

---

⚠️ 关键配置避坑指南

• 首次登录：ConvertX 默认不带初始账户。你需要在部署后立即通过网页注册第一个账号，第一个注册的用户将自动成为管理员。
• HTTPS 访问：由于涉及文件传输，强烈建议配合 Nginx Proxy Manager 等工具启用 SSL。如果只能用 HTTP 访问，需在环境变量中设置 HTTP_ALLOWED=true。
• 硬件加速：如果你有核心显卡，可以在环境变量中添加 FFMPEG_ARGS=-hwaccel vaapi 来加速视频转码。

---

📝 总结与建议

✅ 优点：

• 彻底私有：数据完全掌控在自己手中，不经过任何第三方服务器。
• UI 极简：没有任何杂乱的功能，专注“上传 -> 转换 -> 下载”。
• 全能王：一个应用顶替掉了一打的小工具。

❌ 缺点：

• 资源依赖：由于底层调用了 LibreOffice 等大块头，Docker 镜像体积较大（约 1.5GB+）。
• 配置上限：对于极特殊的专业级转换参数，目前的 WebUI 调节选项有限。

---

🔗 项目地址与资源

资源类别	信息链接
GitHub 仓库	C4illin/ConvertX
Docker Hub	ghcr.io/c4illin/convertx
技术栈	TypeScript / Bun / Elysia
支持格式列表	查看全格式支持表

---

小编点评：ConvertX 是那种“用了就回不去”的工具。一旦你在 NAS 或云服务器上挂载了它，你会发现以后任何格式转换的需求，都只是打开浏览器书签这么简单。