philiplehmann/unoserver

unoserver HTTP包装器 Docker镜像文档

镜像概述与主要用途

philiplehmann/unoserver 是一个基于 unoserver 的 HTTP 包装器 Docker 镜像。它通过简单的 HTTP 接口封装了 unoserver 的文件处理能力，允许用户通过 HTTP 请求（如 POST）进行文件转换等操作，简化了 unoserver 的网络访问方式。

核心功能与特性

• 基于 unoserver 能力：继承 unoserver 的文件处理功能，支持多种文档格式转换（如 docx 转 pdf 等，具体取决于 unoserver 原生支持）。
• HTTP 接口支持：提供 HTTP 接口，可通过 HTTP 请求直接调用文件处理能力，无需直接操作 unoserver 命令行。
• 端口可配置：支持通过环境变量自定义服务端口，默认使用 3000 端口。
• 轻量级包装：仅对 unoserver 进行简单 HTTP 包装，减少额外资源开销。

使用场景与适用范围

使用场景

• Web 应用集成：在后端服务中通过 HTTP API 调用文档转换功能（如在线文档预览、格式转换服务）。
• 跨服务文件处理：需要通过网络接口（而非本地命令行）访问 unoserver 功能的分布式系统。
• 自动化脚本：在需要 HTTP 触发文件处理的自动化流程中使用（如定时任务、事件驱动处理）。

适用范围

适用于需要通过 HTTP 接口访问 unoserver 功能的开发、测试或生产环境，尤其适合需要快速集成文档处理能力的后端服务场景。

使用方法与配置说明

前提条件

• 已安装 Docker 环境。
• 网络环境允许容器端口映射（如宿主机与容器间端口通信）。

运行容器

默认配置运行

使用默认端口 3000，映射宿主机 3000 端口到容器 3000 端口：

bash
docker run -p 3000:3000 --name unoserver philiplehmann/unoserver:latest

自定义端口运行

通过 PORT 环境变量指定容器内服务端口（需同步映射宿主机端口）：

bash
# 容器内端口设为 5000，宿主机映射 5000 端口
docker run -p 5000:5000 --env PORT=5000 --name unoserver philiplehmann/unoserver:latest

Docker Compose 配置示例

创建 docker-compose.yml 文件，配置服务：

yaml
version: '3'
services:
  unoserver:
    image: philiplehmann/unoserver:latest
    ports:
      - "3000:3000"  # 宿主机端口:容器端口（容器端口需与 PORT 环境变量一致）
    environment:
      - PORT=3000  # 可选，默认 3000
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置参数说明

文件转换示例

通过 HTTP POST 请求调用文件转换接口，以下为使用 curl 工具的示例（假设服务运行在 localhost:3000）：

请求格式

• URL：http://<服务地址>:<端口>/convert
• 方法：POST
• 请求头：Content-Type: application/x-www-form-urlencoded
• 请求体：通过 --data-binary 传递待处理文件内容

示例：转换 docx 为 pdf

将本地 path/to/my/document.docx 文件转换为 pdf，并保存为 document.pdf：

bash
curl -X POST \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-binary "@path/to/my/document.docx" \
  --output document.pdf \
  'http://localhost:3000/convert'

参数说明：

• -H 'Content-Type: application/x-www-form-urlencoded'：指定请求内容类型。
• --data-binary "@path/to/my/document.docx"：读取本地文件并作为二进制数据发送（@ 后为文件路径）。
• --output document.pdf：将响应内容保存为 document.pdf 文件。

相关链接

• 镜像源码：https://github.com/philiplehmann/container/tree/main/apps/unoserver
• 基础组件 unoserver：https://github.com/unoconv/unoserver