Stirling PDF Docker Compose 的替代方案使用 IronSecureDoc

设置 IronSecureDoc 非常简单，这要归功于它的 基于 Docker 的部署。 这使得开发人员无需处理复杂的安装过程就能快速集成其安全功能。

步骤 1：拉取 IronSecureDoc Docker 镜像

首先，拉取最新的 IronSecureDoc Docker 镜像：

docker pull ironsoftwareofficial/ironsecuredoc:latest

docker pull ironsoftwareofficial/ironsecuredoc:latest

步骤 2：运行 IronSecureDoc 容器

镜像下载后，运行容器并设置必要的环境变量：

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> \
-e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> \
-e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

用您的 有效许可证密钥 替换 <IRONSECUREDOC_LICENSE_KEY>。 这确保了服务能够在功能完整的情况下运行。

步骤 3：访问 API 端点

容器启动后，您可以使用 Swagger 探索 API 端点：

• Swagger UI （端口 8080）：
  http://localhost:8080/swagger/index.html

通过这种设置，您可以开始将 IronSecureDoc 的高级安全功能 集成到您的应用程序中。

StirlingPDF 是一个 开源 的 PDF 处理工具，可以快速通过 Docker 部署。 设置很简单，并且允许您立即利用其安全和文档操作功能。

步骤 1：拉取 StirlingPDF Docker 镜像

首先，通过运行以下命令下载最新的 StirlingPDF Docker 镜像：

docker pull casjaysdevdocker/stirlingpdf:latest

docker pull casjaysdevdocker/stirlingpdf:latest

或在 Docker Desktop 中搜索：

步骤 2：运行 StirlingPDF 容器

当镜像可用时，您可以启动一个新容器。 在 Docker 界面中，按如下设置配置：

• 容器名称：StirlingPDF
• 主机端口：8090

或者，您可以通过 CLI 运行它：

docker run --rm -p 8090:8080 casjaysdevdocker/stirlingpdf:latest

docker run --rm -p 8090:8080 casjaysdevdocker/stirlingpdf:latest

步骤 3：访问 API

容器运行后，访问 StirlingPDF Swagger UI 以探索可用的 API 端点：

http://localhost:8090/swagger-ui/index.html#/

通过这种设置，您可以开始使用 StirlingPDF 的文件安全功能。

文本编辑

在处理机密信息时，最重要的安全功能之一是编辑，指永久性删除 PDF 文档中的敏感内容。 IronSecureDoc 在这项任务中表现出色，提供一个用户友好且有效的 API 端点可以快速编辑特定的单词或短语。

• 灵活的文本编辑： 用户可以指定确切的单词或短语进行编辑。 API 支持部分和完整单词匹配，可通过查询参数配置。

• 区分大小写的控制： 它允许切换区分大小写匹配，给予编辑行为精确的控制。

• 可视化编辑： 所选文本可以用明确的黑色框覆盖，清晰表示 PDF 中的编辑区域。

以此为例，假设一个 PDF 文档中包含短语 "Dummy"：

使用 IronSecureDoc 的简单 API，开发人员可以轻松发出命令以编辑敏感文本。

这是一个使用 Curl 的实际示例：

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/redact-text?draw_black_box=true&match_whole_word=false&words_to_redact=Dummy&match_case=false&save_as_pdfa=false&save_as_pdfua=false' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/redact-text?draw_black_box=true&match_whole_word=false&words_to_redact=Dummy&match_case=false&save_as_pdfa=false&save_as_pdfua=false' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

一旦命令成功执行，您将收到类似以下的响应：

生成的 PDF 展示了 IronSecureDoc 的高效编辑能力。 敏感内容被永久遮盖，确保机密信息保持安全：

IronSecureDoc 还支持高级编辑方法，例如使用正则表达式或特定区域编辑 PDF 内容：

• /v1/document-services/pdfs/redact-regular-expression
• /v1/document-services/pdfs/redact-region

这一简单而强大的功能确保文件保持隐私，并符合严格的数据保护标准。

认证文件

认证文档确保 PDF 文件的真实性和完整性。 IronSecureDoc 使用专用 API 简化了此过程。 以下是如何通过 Swagger UI 认证 PDF 文件的过程：

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/certify?certificate_password=P%40ssw0rd123&certificate_permissions=3' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf' \
  -F 'certificate_file=@certificate.p12;type=application/x-pkcs12'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/certify?certificate_password=P%40ssw0rd123&certificate_permissions=3' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf' \
  -F 'certificate_file=@certificate.p12;type=application/x-pkcs12'

当调用此 API 时，PDF 会被数字证书签名，从而锁定其内容并证明其合法性。 certificate_permissions 参数确定认证后收件人可以对文件进行的操作，例如打印或填写表单。

服务器响应包括一个可下载的认证文件。这提供了一种自动化认证过程的无缝方式，确保您的 PDF 是安全、可验证和合规的。

签署 PDF 文档

除了认证，IronSecureDoc 还提供了另一个重要功能——数字签署 PDF 文档。 与认证不同，认证是锁定整个文档，数字签名是在无需限制编辑的情况下提供验证。

使用 Swagger UI 中的 /v1/document-services/pdfs/sign 端点，您可以在文件特定页面放置可见的签名图像。 您甚至可以通过调整 signature_image_x, signature_image_y, signature_image_w 和 signature_image_h 参数自定义其位置和尺寸。

除了签名位置，您还可以提供用户或所有者密码，应用证书以增强信任，并可以选择将文件转换为 PDF/A 或 PDF/UA 格式以符合标准。

要签署文件：

1. 上传您要签署的 PDF。
2. 上传有效数字证书文件（.p12 格式）。
3. 上传签名的图像文件（PNG 或 JPEG）。
4. 设置签名位置坐标和大小。
5. 点击 执行。

完成后，服务器将返回一个已经数字签名的 PDF 准备分发。 此功能非常适合自动化审批流程、确认作者身份或在官方文件上添加品牌，同时保持文件完整性。

PDF 文件加密

PDF 安全的一个最重要的支柱是加密。 通过 IronSecureDoc，开发人员可以使用强大的用户和所有者密码加密文件，同时还可以微调文件使用的权限设置。 要使用 Swagger UI 执行此操作，导航到 /v1/document-services/pdfs/encrypt 端点并配置所需字段：

您可以限制各种文档功能，例如：

• 内容提取
• 表单填写
• 注释添加
• 打印
• 修改

如果您需要完全锁定文件，只需将所有这些选项设置为 false。 这是等效的 CURL 命令供参考：

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?allow_extracting_content=false&allow_form_filling=false&allow_annotations=false&allow_printing=false&allow_modifications=false&new_user_password=123&new_owner_password=123' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?allow_extracting_content=false&allow_form_filling=false&allow_annotations=false&allow_printing=false&allow_modifications=false&new_user_password=123&new_owner_password=123' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

一旦执行，输出将是一个完全加密的 PDF 文件，用户在打开时将会被提示输入密码。

此功能对于保护敏感记录、限制访问以及确保文件控制即使在分发后也是必不可少的。 无论是用于内部备忘录、法律文件还是客户报告，IronSecureDoc 使得在不打破开发流程的情况下执行文件安全性变得简单。

从 PDF 中提取文本

需要从 PDF 文件中提取内容？IronSecureDoc 提供了一种快速准确的方法，通过 /v1/document-services/pdfs/extract 端点提取文本。 该功能在您想要自动化发票、报告或大型文档内容提取，而不用手动复制粘贴时特别有用。 要提取文本，请前往 Swagger UI 并通过提供的表单上传您的文件：

参数允许您输入密码（如果 PDF 是受保护的），甚至可以指定页码，以便您仅需要查看选择的页码中的内容。 或者，您可以使用以下 CURL 命令：

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/extract' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@long_text_test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/extract' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@long_text_test.pdf;type=application/pdf'

一旦执行，API 将作为响应体原样返回提取的文本：

然后可以根据需要解析、存储或分析该输出。 这简单快速，不需要任何特殊插件或人工审查。 无论您是在构建文档处理管道还是希望快速访问文件的内容，这个功能都可以完成任务。

验证文件密码

在处理任何受保护的 PDF 之前，最好先检查您的密码是否有效。 IronSecureDoc 提供了一种快速且可靠的方式，通过 /v1/document-services/pdfs/verify-password 端点验证用户和所有者密码。 当自动化涉及第三方文件或存档文件的工作流时，此功能尤其有用，因为必须确认密码的准确性才能进一步操作。

在 Swagger UI 中，上传受保护的 PDF，然后根据访问级别填写相关的 user_password 或 owner_password 字段：

提交后，API 将返回密码有效时的成功（200 OK），如果密码无效则返回错误。 这个轻量级的验证步骤可以节约时间，防止不必要的失败，并有助于流畅地管理 PDF 自处理。

验证数字签名

验证数字签名是确保 PDF 文档自签署以来未被更改以及签名有效的关键步骤。 IronSecureDoc 通过 /v1/document-services/pdfs/verify-signatures 端点提供此功能。 当文件来自外部来源或符合性和信任至关重要时，此端点尤其有用。

在 Swagger UI 中，您只需要上传已签名的 PDF 文件，并在必要时输入用户密码或所有者密码以访问文件：

您还可以使用 CURL 请求运行此过程：

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/verify-signatures' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test_Signed.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/verify-signatures' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test_Signed.pdf;type=application/pdf'

请求执行后，API 返回 JSON 格式的详细验证结果。 如果签名完好且真实，它将返回 true。 如果被篡改或无效，您将看到详细的失败指示。

此功能确保您 PDF 工作流中的每个签名都是可验证和安全的，这是法律、金融和符合性文件必不可少的步骤。

编辑 PDF

StirlingPDF 提供了一种直接而灵活的方式，通过 /api/v1/security/auto-redact 端点编辑 PDF 文档中的内容。 此功能非常适合希望从 PDF 中删除敏感单词或模式而无需高级设置的开发人员。

在 Swagger UI 中，您可以轻松配置编辑参数。 您上传一个 PDF，输入要编辑的文本列表（例如"Dummy"），并调整选项，如：

• useRegex – 基于正则表达式进行编辑
• wholeWordSearch – 仅匹配整个单词
• redactColor – 自定义编辑颜色（例如黑色 #000000）
• customPadding – 添加编辑区域周围的间距
• convertPDFToImage – 将输出转换为图像以增强保护

一旦点击 执行，StirlingPDF 将根据您的配置处理文件并删除所有匹配内容。

验证签名

使用 /api/v1/security/validate-signature 端点，您可以快速检查 PDF 文件中嵌入的数字签名的真实性。端点支持默认和自定义证书验证。 您只需提交一个包含 fileInput（您的 PDF 的 base64 或文件字符串）的请求体，并可选择提供 certFile 以对特定证书进行验证。

此 API 以 JSON 结构回应，概述验证状态。

使用数字证书签署 PDF 文件

StirlingPDF 允许您使用 /api/v1/security/cert-sign 端点使用您的证书对 PDF 文件进行数字签名。 通过 Swagger UI，您可以上传 PDF 并配置数字签名选项。 您需要以下内容：

• fileInput – 您要签署的 PDF 文件
• certType – 您使用的证书类型
• privateKeyFile, certFile, p12File 或 jksFile – 取决于证书类型
• password – 用于密钥库或私钥

您还可以增强签名体验：

• showSignature – 在 PDF 中直观显示签名
• reason, location, name – 签名的元数据
• pageNumber – 签名应出现的页面
• showLogo – 是否显示带有签名的标志

一旦点击 执行，StirlingPDF 将处理输入并返回一个数字签名的 PDF。

添加密码保护

StirlingPDF 允许通过 /api/v1/security/add-password 端点为文件添加密码保护。 此功能允许您定义用户和所有者密码，以及精细化权限设置。

使用 Swagger UI，您可以这样设置：

• fileInput – 上传要保护的 PDF
• password – 用户需要此密码才能打开文档
• ownerPassword – 控制文件内的编辑权限
• keyLength – 选择加密强度（例如 256 位）

除此之外，您可以切换文件限制，例如：

• canPrint, canModify, canFillInForm
• canExtractContent, canExtractForAccessibility
• canModifyAnnotations, canAssembleDocument

当您点击 执行 时，输出将是一个受保护的 PDF，权限设置完全按照您的配置。

IronSecureDoc 提供企业级许可证选项，满足各种组织的需求。 客户可以在单独的 IronSecureDoc 企业许可证和包含 IronSecureDoc 及其他产品的全面 Iron Suite 企业许可证之间进行选择。

IronSecureDoc 企业许可证

• 价格：USD 14,999
• 功能：
  • 支持无代码或任何编程语言的企业 PDF 服务器，本地或云中托管
  • 为保护文档提供无限制的 PDF 编辑、签名和加密功能
  • 支持离线隔离的环境
  • 可获得折扣支持和更新捆绑包

Iron Suite 无限企业许可证

• 价格：USD 19,995
• 功能：
  • 包含所有 Iron 软件产品：IronPDF, IronOCR, IronXL, IronWord, IronBarcode 等
  • 无限的开发人员、位置和项目，包括 OEM 再分配
  • 可定制的永久企业许可证
  • 支持离线隔离的环境
  • 仅提供企业选项
  • 支持和更新订阅涵盖 Suite 和 IronSecureDoc

支持和更新

Iron 软件提供各种支持和产品更新选项，以确保服务不中断：

• 年度订阅：每年 $7,500（每年续订，可随时取消）
• 1 年包：$10,000（一次性购买）
• 5 年包：$30,000（一次性购买）

这些套餐提供对持续产品更新、安全特性升级和来自 Iron 软件工程团队的支持的访问。

评估选项

对于希望在购买前评估 IronSecureDoc 的组织，提供 免费试用。 此试用提供完整功能，允许在不需要立即财务承诺的真实环境中全面评估。

通过选择合适的许可证选项，企业可以确保基于其特定需求的强大文件安全性。

StirlingPDF 提供了一种简单的开源模型：

免费层

在 AGPL v3 许可证下提供，核心功能可免费使用和自托管。适合开发人员或小型内部使用。

企业许可证

对于需要非 AGPL 合规性或其他支持的企业，可提供商业许可证。 价格是定制的，需要联系他们的团队。

IronSecureDoc 提供了一个全面的文档和支持资源套件，旨在促进在您的组织中无缝的集成和操作。

广泛的文档

IronSecureDoc 提供详尽的文档，涵盖：

• 快速入门指南：逐步介绍如何在各种环境中启动和运行 IronSecureDoc，包括本地服务器和云平台。
• API 参考：详细说明端点的全面 RESTful API 文档，例如 PDF 编辑、加密和数字签名任务。
• 教程和使用指南：展示与不同编程语言和框架的集成技巧的实用指南，提高开发者体验。

专注的支持

IronSecureDoc 通过以下方式确保强大的支持：

• 直接的工程协助：通过实时聊天、电子邮件或屏幕共享访问专注的工程师团队，提供及时且博学的技术咨询响应。
• 持续改进：致力于根据用户反馈不断发展产品，确保 IronSecureDoc 满足其用户的动态需求。

这种结构化 的文档和支持方式强调了 IronSecureDoc 提供以用户为中心的体验，并促进在企业环境中高效实施和持续使用。

文档

StirlingPDF 提供涵盖多种平台安装指南、先进的配置选项和大量功能的综合文档。

支持

作为一个开源项目，StirlingPDF 依赖于社区驱动的支持。 用户可通过平台如 GitHub 和 Discord 寻求帮助，在那里他们可以报告问题、请求功能，并与其他用户和贡献者合作。