zrrrzzt/docker-unoconv-webservice

docker-unoconv-webservice镜像说明

镜像概述

该Docker镜像将unoconv工具以Web服务形式运行，基于https://github.com/zrrrzzt/tfk-api-unoconv%E5%AE%9E%E7%8E%B0%E3%80%82%E6%82%A8%E5%8F%AF%E7%9B%B4%E6%8E%A5%E6%8B%89%E5%8F%96%E9%A2%84%E6%9E%84%E5%BB%BA%E9%95%9C%E5%83%8F%EF%BC%8C%E6%88%96%E8%87%AA%E8%A1%8C%E6%9E%84%E5%BB%BA%E4%BD%BF%E7%94%A8%E3%80%82

核心功能

1. 支持多种文档格式转换（如docx转pdf、ppt转图片等）
2. 提供API接口：
   • /unoconv/{目标格式}：上传文件并转换为指定格式
   • /unoconv/formats：查看所有支持的转换格式
   • /unoconv/formats/{类型}：查看特定类型（文档/图形/演示/表格）的格式
   • /unoconv/versions：查看unoconv及依赖版本
   • /healthz：检查服务健康状态
3. 可通过环境变量配置端口、文件大小限制和超时时间

使用场景

• 批量转换文档格式
• 集成到应用系统中实现在线文档转换功能
• 需要自动化文档格式转换的场景

配置说明

支持以下环境变量配置：

• SERVER_PORT：服务端口，默认3000
• PAYLOAD_MAX_SIZE：最大文件大小，默认1MB（***字节）
• TIMEOUT_SERVER：服务器超时时间，默认2分钟（***毫秒）
• TIMEOUT_SOCKET：socket超时时间，默认2分20秒（***毫秒）

可通过Dockerfile修改，或使用环境变量文件加载配置：

bash
docker run --env-file=docker.env -d -p 80:3000 --name unoconv docker.xuanyuan.run/docker-unoconv-webservice

部署示例

拉取预构建镜像

bash
docker pull docker.xuanyuan.run/zrrrzzt/docker-unoconv-webservice

自行构建镜像

bash
docker build -t docker-unoconv-webservice .

运行容器

使用预构建镜像：

bash
docker run -d -p 80:3000 --name unoconv docker.xuanyuan.run/zrrrzzt/docker-unoconv-webservice

或自行构建的镜像：

bash
docker run -d -p 80:3000 --name unoconv docker.xuanyuan.run/docker-unoconv-webservice

API调用示例（docx转pdf）

bash
curl --form file=@myfile.docx http://localhost/unoconv/pdf > myfile.pdf

许可证

MIT