ComOffice SDK · 服务器

在你的服务器上使用 Office 文档

同一个 .NET 软件包可在 Windows Server 和 x64 Linux 上运行,API 也相同。在服务、批处理作业或容器中打开、编辑并保存 Word、Excel 和 PowerPoint 文件,把页面渲染为图像,并导出为 PDF。

.NET 8+Windows ServerLinux x64容器

可免费评估至 2027-01-01:从 GitHub 下载。

C#

using ComOfficeKit;

Engine.Configure(new EngineOptions {
    WorkingDirectory = workDir,
    WorkingDirectoryQuota = 2L << 30 });
License.Configure(LicenseStorage.Memory);
License.Activate(key);

using var limit = new CancellationTokenSource(
    TimeSpan.FromSeconds(60));
using var doc =
    Document.Open(input, limit.Token);
doc.ExportPdf(output, limit.Token);

它能做什么

一个 .NET 库。打开文档、修改、保存,并绘制它的页面。

打开、编辑和保存

打开 .docx、.xlsx、.xlsm、.pptx、.csv 和 .tsv 文件,可直接保存或另存为新文件,也能创建空白的文档、工作簿和演示文稿。

页面图像、文字和 PDF

把任意一页渲染为 24 至 600 dpi 的 PNG 图像,并把整份文档导出为 PDF。每一页还会提供该页绘制的文字及其位置,让你的应用程序可以让用户在图像上选择、复制和搜索文字。

Word 文档

读取文档的文本,在全文中替换文本,并比较两份文档,生成以修订标记显示差异的第三份文档。

工作簿

列出工作表,读取和设置单元格的内容,并读取公式计算出的值,与单元格显示的一致。

可在哪里运行

Windows Server 和 Linux,均为 x64,使用同一个软件包。

Windows Server

Windows Server 2022 和 2025 都已测试,Windows 容器也是:包括两者的完整镜像,以及 2025 较小的镜像。详情请见ComOffice for Windows。

Linux

glibc 2.34 或更高版本的 x64 Linux,已在 Ubuntu 24.04、Debian 12 和 Red Hat Enterprise Linux 9 上测试,也能在基于 Microsoft .NET 8 运行时镜像的 Linux 容器中运行。详情请见Linux 上的 ComOffice。

同一个软件包

两者使用同一个 .NET 软件包和相同的 API,服务无需修改就能在两者之间迁移。许可证会写明涵盖哪些平台。

在服务器上运行

服务器指南的要点,附有一个监督程序及其工作进程的示例。

工作进程

同时要转换几份文档,就运行几个工作进程,通常每个处理器一个。引擎在一个进程内一次只排版一份文档,所以多线程不会更快;某份文档让它的工作进程崩溃时,也不会连累其他作业。

每项作业的限制

解压后远超原本大小的文档,会在写入任何内容之前就被拒绝。磁盘有配额,每个调用都可以取消,取消后不会改变任何内容;内存则由容器或作业对象设定上限。

字体

请安装文档所用的字体。每份文档都会报告绘制时缺少的字体,所以页面排得和作者的不一样时,原因一目了然。

在网页中显示

你的网页现在就能显示文档,仅供查看。由你的服务器用 ComOffice 绘制每一页,浏览器负责显示:引擎留在服务器上,浏览器只会收到每一页的图像和文字,以及整份文档的 PDF。网页查看器可以直接使用:包含网页组件、它调用的服务,以及 HTML、React 和 Vue 模板。它会把每一页的文字叠在图像上,让用户可以选择、复制和搜索;设置 text-layer="none" 则只显示图像。要修改文档,由你的服务用 SDK 编辑。

常见问题

可以在哪些服务器上运行?

Windows Server 2022 和 2025,以及 glibc 2.34 或更高版本的 x64 Linux(已在 Ubuntu 24.04、Debian 12 和 Red Hat Enterprise Linux 9 上测试),均需 .NET 8 或更高版本。两者也都能在容器中运行。

可以在网页中显示文档吗?

可以,现在就能,仅供查看。网页查看器为你的网页提供现成的组件、它调用的服务,以及 HTML、React 和 Vue 模板:由你的服务器用 ComOffice 绘制每一页,浏览器负责显示,文字还能选择、复制和搜索。要修改文档,由你的服务用 SDK 编辑。服务对外开放之前,请加上你自己的登录机制。直接在浏览器中运行的 SDK 正在开发中。

在服务器上要怎么使用许可证?

请把许可证保留在内存中,并在每个工作进程启动时启用,因为容器在两次运行之间不会保留任何内容。许可证会写明涵盖哪些平台,所以服务器需要涵盖其平台的许可证。

如何获取?

从 GitHub 下载:每个版本都附带软件包,它的 README 还公布了一个免费评估密钥,有效期至 2027-01-01。如需许可证,请通过联系表单向我们的销售团队介绍你的项目,或写信至 sales@comofficekit.com。

可以打开 PDF 文件吗?

不能。ComOffice 处理 .docx、.xlsx、.xlsm、.pptx、.csv 和 .tsv 文件,并将它们导出为 PDF,但不能打开或编辑 PDF 文档。

咨询服务器上的 ComOffice

告诉我们你在构建什么,我们的销售团队会与你联系。你也可以写信至 sales@comofficekit.com。