groupdocs/conversion-cloud

云端文档转换

GroupDocs.Conversion Cloud 是一个REST API，支持将超过50种文档和图像格式转换为Word、Excel、HTML、PDF、PowerPoint和图像格式，可对整个文档、逐页或自定义页面范围进行转换。此Docker镜像使GroupDocs Conversion Cloud API能够在单机上使用，或集成到现有应用程序或系统解决方案中。

快速开始

GroupDocs.Conversion可在试用模式和授权模式下启动。您还可以选择通过设置预定义凭据启用认证。

试用模式启动

要启动容器并以试用模式运行GroupDocs.Conversion Cloud，请输入以下命令。

Windows (PowerShell)

powershell
docker run `
    -p 8080:80 `
    -v "${pwd}/data:/data" `
    --name conversion_cloud `
    groupdocs/conversion-cloud

Linux (bash)

bash
docker run \
    -p 8080:80 \
    -v $(pwd)/data:/data \
    --name conversion_cloud \
    groupdocs/conversion-cloud

等待启动过程完成，您将看到以下日志：

bash
info: GroupDocs.Conversion.Cloud.Web.Startup[0]
      "License" parameters are omitted, the app works in trial mode.
...

如上述消息所示，GroupDocs.Conversion Cloud以试用模式运行，因此会应用试用限制：

• 只能转换文档的前两页。
• 输出文件会添加评估水印。

授权模式启动

如果您已有许可证密钥，可以在授权模式下运行GroupDocs.Conversion Cloud。为此，请通过环境变量传递许可证的公钥和私钥，如下所示。

Windows (PowerShell)

powershell
docker run `
    -p 8080:80 `
    -v "${pwd}/data:/data" `
    -e "LICENSE_PUBLIC_KEY=public_key" `
    -e "LICENSE_PRIVATE_KEY=private_key" `
    --name conversion_cloud `
    groupdocs/conversion-cloud

Linux (bash)

bash
docker run \
    -p 8080:80 \
    -v $(pwd)/data:/data \
    -e LICENSE_PUBLIC_KEY=public_key \
    -e LICENSE_PRIVATE_KEY=private_key \
    --name conversion_cloud \
    groupdocs/conversion-cloud

容器启动后，您将看到指示许可证设置成功的消息：

bash
info: GroupDocs.Conversion.Cloud.Web.Startup[0]
      The license has been set.
...

您可以通过调用此处描述的API方法获取计量许可证消耗情况。

启用认证

要启用认证，请设置CLIENT_ID/CLIENT_SECRET参数，如下所示。请注意，如果要使用https://github.com/groupdocs-conversion-cloud%EF%BC%8C%E5%88%99%E9%9C%80%E8%A6%81%E8%AE%A4%E8%AF%81%E3%80%82

TOKEN_SECRET用作使用HMAC-SHA256算法签名JWT令牌的对称密钥。 • 如果设置了TOKEN_SECRET环境变量，其值将用作签名密钥。 • 如果未设置TOKEN_SECRET，应用程序将在运行时生成随机的256位密钥。此随机密钥不会持久化，每次应用程序重启时都会更改。

Windows (PowerShell)

powershell
docker run `
    -p 8080:80 `
    -v "${pwd}/data:/data" `
    -e "CLIENT_ID=client_id" `
    -e "CLIENT_SECRET=client_secret" `
    -e "TOKEN_SECRET=aifvtf67769fydrdjh089y86f7cfnr6e5ev856db7ii8t787rtb6r689f07t897tk907tn8f6b68d987yh0u" `    
    --name conversion_cloud `
    groupdocs/conversion-cloud

Linux (bash)

bash
docker run \
    -p 8080:80 \
    -v $(pwd)/data:/data \
    -e CLIENT_ID=client_id \
    -e CLIENT_SECRET=client_secret \
    -e TOKEN_SECRET=aifvtf67769fydrdjh089y86f7cfnr6e5ev856db7ii8t787rtb6r689f07t897tk907tn8f6b68d987yh0u \    
    --name conversion_cloud \
    groupdocs/conversion-cloud

启用Google Cloud Storage

默认情况下，容器内使用本地存储进行文件操作。通过设置GOOGLE_APPLICATION_CREDENTIALS和GOOGLE_STORAGE_BUCKET环境变量，可以连接Google Cloud存储。

Windows (PowerShell)

powershell
docker run `
    -p 8080:80 `
    -v "${pwd}/data:/data" `
    -e "GOOGLE_APPLICATION_CREDENTIALS=/data/key.json" `
    -e "GOOGLE_STORAGE_BUCKET=bucket_id" `
    --name conversion_cloud `
    groupdocs/conversion-cloud

Linux (bash)

bash
docker run \
    -p 8080:80 \
    -v $(pwd)/data:/data \
    -e GOOGLE_APPLICATION_CREDENTIALS=/data/key.json \
    -e GOOGLE_STORAGE_BUCKET=bucket_id \
    --name conversion_cloud \
    groupdocs/conversion-cloud

启用AWS S3 Cloud Storage

默认情况下，容器内使用本地存储进行文件操作。通过设置以下环境变量，可以连接AWS S3 Cloud存储：

Windows (PowerShell)

powershell
docker run `
    -p 8080:80 `
    -v "${pwd}/data:/data" `
    -e "S3_STORAGE_BUCKET=main_bucket" `
    -e "S3_STORAGE_ACCESS_KEY=XXXXXXXXXXXXXXXXXXX" `
    -e "S3_STORAGE_SECRET_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" `
    -e "S3_STORAGE_REGION=us-west-2" `
    --name conversion_cloud `
    groupdocs/conversion-cloud

Linux (bash)

bash
docker run \
    -p 8080:80 \
    -v $(pwd)/data:/data \
    -e S3_STORAGE_BUCKET=main_bucket \
    -e S3_STORAGE_ACCESS_KEY=XXXXXXXXXXXXXXXXXXX \
    -e S3_STORAGE_SECRET_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \
    -e S3_STORAGE_REGION=us-west-2" \
    --name conversion_cloud \
    groupdocs/conversion-cloud

健康检查

容器和GroupDocs.Conversion Cloud启动后，可通过调用GET http://localhost:8080/检查服务状态。成功响应状态为200，表示服务已启动并运行。

Windows (PowerShell)

powershell
Invoke-WebRequest -Uri http://localhost:8080/

Linux (bash)

bash
curl -i http://localhost:8080/

使用UI

启动后，可通过http://localhost:8080/swagger/访问Swagger UI，开始探索API。

停止容器

要停止运行中的Docker容器，只需在运行容器的终端中按Ctrl+C。或者，您可以通过名称停止容器：

bash
docker stop conversion_cloud

自动关闭和重启

从v24.2版本开始，添加了自动关闭功能。默认情况下，如果发生内存不足异常，应用程序和容器将正常停止。 要在这种情况下继续运行容器，启动容器时应应用自动重启选项：

Windows (PowerShell)

powershell
docker run `
    --restart always `
    -p 8080:80 `
    -v "${pwd}/data:/data" `
    --name conversion_cloud `
    groupdocs/conversion-cloud

Linux (bash)

bash
docker run \
    --restart always \
    -p 8080:80 \
    -v $(pwd)/data:/data \
    --name conversion_cloud \
    groupdocs/conversion-cloud

此外，为了更好地控制容器稳定性，添加了新参数：CONVERSIONS_LIMIT。设置后，服务会计算转换次数，当超过限制时，应用程序和容器将正常停止。要继续运行容器，与上述情况相同，应应用自动重启选项：

Windows (PowerShell)

powershell
docker run `
    --restart always `
    -p 8080:80 `
    -v "${pwd}/data:/data" `
    -e "CONVERSIONS_LIMIT=100" `
    --name conversion_cloud `
    groupdocs/conversion-cloud

Linux (bash)

bash
docker run \
    --restart always \
    -p 8080:80 \
    -v $(pwd)/data:/data \
    -e CONVERSIONS_LIMIT=100 \
    --name conversion_cloud \
    groupdocs/conversion-cloud

容器配置

卷

参数

注意事项

• 如果省略“License”参数，应用将以试用模式运行。
• 如果设置了“CLIENT_ID”参数，每个请求都需要“Authorization”头（JWT认证）。
• 获取令牌的URL为“/connect/token”。

后续步骤

我们提供多种语言的SDK，您可以查看以下列表是否有您需要的语言。如果没有找到，欢迎在我们的支持论坛请求，或使用GroupDocs.Conversion Cloud for cURL中详细说明的原始REST API请求。

流行语言的GroupDocs.Conversion Cloud SDK

产品页面 | 文档 | 演示 | Swagger UI | https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet-samples | 博客 | 搜索 | 免费支持 | 免费试用