convertx/convertx-cn

!https://github.com/pi-docket/ConvertX-CN/raw/main/images/logo.png

ConvertX-CN

ConvertX-CN 是一个以 Docker 为主要交付方式的文件转换服务，提供 Web UI、批量上传、转换历史、格式推断、多语言界面，以及可选的 Rust API Server。

!Docker Image Size (Latest Lite)>)

https://hub.docker.com/r/convertx/convertx-cn · https://github.com/pi-docket/ConvertX-CN/releases · https://github.com/pi-docket/ConvertX-CN/blob/main/LICENSE

主要特色

• 支持多类文件转换：影音、图片、文档、电子书、PDF、OCR、向量图、3D 模型与结构化数据。
• 内置多种转换引擎，包括 FFmpeg、ImageMagick、GraphicsMagick、libvips、LibreOffice、Pandoc、Calibre、Inkscape、PDFMathTranslate、BabelDOC、MinerU、OCRmyPDF 等。
• 提供 Web UI，支持用户登录、上传、转换、下载和历史记录。
• 提供 Lite / Standard / Full 映像选择，便于在镜像体积与功能完整度之间取舍。
• 提供可选 API Server，用于 REST API、JWT 鉴权与任务式转换流程；该部分仍可能重构。

适合谁使用

• 需要私有部署文件转换服务的个人或团队。
• 需要用 Docker 快速集成多种转换工具的部署者。
• 需要通过 API 接入 ConvertX-CN 转换能力的开发者。
• 想维护转换引擎、格式矩阵或文档体系的贡献者。

Quick Start

bash
mkdir -p convertx-cn/data
cd convertx-cn
cp .env.example .env
# 编辑 .env，设置固定且足够随机的 JWT_SECRET
docker compose up -d

启动后打开：

text
http://localhost:3000

最小 compose.yaml 示例：

yaml
services:
  convertx:
    image: convertx/convertx-cn:latest
    container_name: convertx-cn
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
    env_file:
      - .env

Docker Run 示例：

bash
docker run -d \
  --name convertx-cn \
  --restart unless-stopped \
  -p 3000:3000 \
  -v ./data:/app/data \
  --env-file .env \
  convertx/convertx-cn:latest

在线演示(正在維護)

![Live Demo]([***]

演示地址：[***]

演示站仅供测试，请勿上传敏感文件，会定期清理数据。

文档入口

版本选择摘要

API Server 状态

API Server 是可选服务，不影响 Web UI 的基本使用。当前实现位于 api-server/，使用 Rust + Axum，提供 REST API 与 GraphQL 入口；由于后续可能重构，对外集成前请阅读 https://github.com/pi-docket/ConvertX-CN/blob/main/docs/zh-CN/api-server.md 与 https://github.com/pi-docket/ConvertX-CN/blob/main/docs/zh-CN/api-reference.md%E3%80%82

安全提醒

• 生产环境必须设置固定、随机且足够长的 JWT_SECRET。
• 公开部署时请使用 HTTPS，并正确配置反向代理相关环境变量。
• 不建议在公网开启未认证访问。
• 上传和转换敏感文件前，请确认数据目录、备份策略和访问控制符合你的安全要求。

授权与致谢

ConvertX-CN 使用 AGPL-3.0 授权。项目集成并依赖多个开源转换工具，详见各工具原始项目与本仓库文档。