### [拒绝隐私泄露！ConvertX 深度解析：打造支持 1000+ 格式的私有转换工厂](https://www.qiqiwa.com/article/393)

**Published:** 2026-03-03T06:54:06

**Author:** Hello

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

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

![](https://www.qiqiwa.com/wp-content/uploads/2026/03/1bb87d41d120260303144924.png)

* * *

## 🌟 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](https://github.com/C4illin/ConvertX) |
| **Docker Hub** | [ghcr.io/c4illin/convertx](https://github.com/C4illin/ConvertX/pkgs/container/convertx) |
| **技术栈** | TypeScript / Bun / Elysia |
| **支持格式列表** | [查看全格式支持表](https://github.com/C4illin/ConvertX) |

* * *

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

**Tags:** 开源项目

**Categories:** 项目笔记

---