makinacorpus/convertit Docker 镜像 - 轩辕镜像

Convertit 格式转换Web服务

概述和主要用途

Convertit是一个轻量级文档格式转换Web服务，旨在通过简单的HTTP请求实现多种文档格式的快速转换。支持通过GET请求拉取远程文档或POST请求上传本地文件，转换后的文档将自动返回。该服务具备自动清理机制，会在每次请求时清理已转换的文档，确保资源高效利用。

核心功能和特性

• 多格式支持：提供多种常见文档格式转换，包括：
  • odt → pdf
  • odt → doc
  • ods → xls
  • csv → ods
  • csv → xls
  • svg → pdf
  • svg → png
• 简单API：通过直观的GET或POST请求即可完成转换，无需复杂配置
• 自动清理：已转换文档会在每次请求时自动清理，避免存储空间占用
• 灵活请求：支持远程文档拉取（GET）和本地文件上传（POST）两种模式

使用场景和适用范围

• Web应用集成：为各类Web系统提供文档格式转换功能
• 自动化办公：集成到文档管理流程中实现格式自动转换
• 快速转换需求：无需安装桌面转换软件，通过HTTP请求即可完成转换
• 开发测试：在应用开发过程中快速验证文档格式转换功能

使用方法和配置说明

使用GET请求

通过GET请求转换远程文档，需提供文档的绝对URL。

示例：将odt文档转换为pdf

bash
curl [***]
HTTP/1.1 302 Found
Content-Disposition: attachement; filename=document.pdf
...

GET参数说明：

• url：待转换文档的绝对URL
  支持{X_FORWARDED_FOR}占位符，用于无法确定自身主机的请求。若存在X_FORWARDED_FOR头，占位符将被替换为对应值。注意：X_FORWARDED_FOR可被用户代理或代理服务器修改，仅在必要时使用。
  示例：

  bash
  curl "[***]{X_FORWARDED_FOR}/document.odt&to=application/pdf"
  

使用POST请求

通过POST请求上传本地文件，文件参数名为file。

示例：将本地SVG文件转换为PNG

bash
curl -F "file=@tiger.svg" [***]
HTTP/1.1 302 Found
Content-Disposition: attachement; filename=tiger.png

查询参数

• to：输出MIME类型（可选，未提供时默认值为application/pdf）
• from：输入MIME类型（可选，未提供时从输入URL或文件自动识别）

安装和部署

系统依赖

• OpenDocument格式支持：unoconv
• SVG格式支持：inkscape
  转换工具需在系统PATH中（内部使用which命令查找）。

下载

• 从PyPI下载发布版：pypi
• 开发版（GitHub）：

  bash
  git clone [***]
  cd convertit
  

开发环境

启动开发服务器：

bash
make serve

服务运行后，可通过浏览器访问 http://localhost:6543/

运行测试：

bash
make tests

生产环境部署

使用gunicorn

bash
gunicorn --workers=1 --paste=production.ini

使用Docker

bash
# 构建镜像
sudo docker build -t="convertit" .

# 运行容器
sudo docker run -p :6543 convertit

反馈

报告bug或请求新功能，请提交issue：GitHub Issues

版权信息

公司

|makinacom|_

• Planet Makina Corpus
• 联系我们

.. |makinacom| image:: [] .. _makinacom: []

作者

• Antoine Cezar
• Alex Marandon

贡献者

• kiorky <***>
• Mathieu Leplatre <***>
• Gaël Utard <***>
• Jean-Etienne Castagnede <***>