96DOC 文件在线预览服务与接入说明

96DOC 是为业务系统提供文件在线预览的服务。将 Word、Excel、PPT、PDF、OFD 等文件接入后，用户可以直接在浏览器中阅读，在电脑和手机上使用统一的阅读界面。

适合 CRM、OA、企业知识库、合同管理、客户门户和培训系统。合同、报价单、报表、演示材料可以在业务页面内打开，查看受支持文件时无需先下载或在用户电脑上安装 Office。

需要接入演示、确认文件兼容性、获取私有化部署方案或安装包，可以扫描下面任一二维码联系我们。

企业微信好友	微信咨询

扫码添加企业微信好友	扫码咨询

支持的文件格式

文件类别	常用格式	阅读方式
Word 文档	DOC、DOCX、RTF、ODT	转为分页文档，阅读文字、表格与页面布局
PPT 演示	PPT、PPTX、PPS、PPSX、ODP	连续分页阅读与演示模式
Excel 表格	XLS、XLSX、CSV、ODS	工作表切换、表格阅读或 PDF 排版预览
版式文档	PDF、OFD	PDF 阅读；OFD 转换后阅读
图片与多页图像	JPG、PNG、GIF、WebP、BMP、SVG、TIFF、DICOM	图片缩放、旋转；多页图像转换后分页阅读
文本与网页	TXT、Markdown、JSON、代码文件、HTML、XML	文本、Markdown 或隔离网页阅读
压缩包与邮件	ZIP、EML	查看压缩包目录并预览成员文件；阅读邮件正文
音视频	MP4、WebM、MP3、WAV、OGG	在浏览器中播放，实际支持取决于文件编码

Office 文档主要展示静态排版，PPT 动画不会在预览中播放。复杂文档建议先用实际文件测试兼容性；更多格式和范围请查看开发文档。

功能清单

能力	可以完成的操作
阅读与展示	PDF 精准模式、图片模式、分页阅读、缩略图、缩放、全屏、工作表切换；PDF 有文字层时支持查找、选择与复制
电脑与手机	自适应阅读宽度；演示模式下电脑滚轮向下翻下一页、向上翻上一页，手机向左滑下一页、向右滑上一页
接入与开发	文件 URL 入口、iframe 嵌入、JavaScript 接入、HTTP API、本地文件上传及多语言调用示例
水印	文字、图片及自定义水印，设置字号、角度、透明度、颜色、平铺与间距
访问与分享	访问密码、分享有效期、IP/CIDR 限制、一次性访问、前 N 页试读、自定义页面标题
阅读工具	按需显示缩略图、查找、翻页、缩放、演示、打印、下载与全屏按钮；打印、复制和下载权限可单独配置
缓存与更新	转换结果复用、清除缓存、查询缓存和分享有效期；原 URL 不变时用 mtime 标记文件更新；用 referer 适配源站防盗链
私有化部署	Windows 或 Linux 部署，由企业自己的预览服务获取文件、转换和保存缓存；可配置服务端口、文件域名白名单与转换限制

图片模式没有文字复制功能。水印、禁复制与页面打印控制属于阅读体验设置，不能阻止截图；文件权限应由业务系统和存储服务共同控制。

快速接入

使用文件地址打开预览

对可以公开读取的文件，构造预览链接后打开新窗口，或设置业务页面 iframe 的 src：

私有化部署时，将示例中的预览服务域名替换为企业服务入口。HTTPS 业务页面应使用 HTTPS 预览入口。

由业务后端生成预览链接

业务后端校验用户对文件的访问权限，再调用 POST /api/preview。例如设置精准模式、文字水印和 60 分钟有效期：

{
  "url": "http://www.96doc.com/demo/sample-v2.docx",
  "filename": "sample-v2.docx",
  "mtime": "",
  "pdf": false,
  "options": {
    "displayMode": "precise",
    "heading": "文件预览",
    "allowCopy": true,
    "allowDownload": false,
    "validMinutes": 60,
    "stampMode": "text",
    "stampText": "仅供业务查看"
  }
}

响应包含任务 id、处理状态 status 和预览链接。常规接入直接打开 previewURL；需要让分享入口不包含原文件 URL 时，将签名阅读页 htmlURL 交给前端。htmlURL 在开启转换缓存时提供，生成过程中也可打开加载页。

202 表示任务已受理，转换完成以 status=ready 为准。 内置阅读器会处理等待过程。服务配置 KEY 非空时，由业务后端通过 X-Preview-Key 请求头传入密钥；不要把服务密钥写入公开网页。

三个常用接口

接口	方法	用途	成功状态码
`/api/preview`	POST	生成预览链接，设置阅读模式、水印与分享规则	202
`/api/cache`	POST	action=clear 清除缓存；action=status 查询缓存或指定分享链接的有效期	200
`/api/upload`	POST	使用 multipart/form-data 的 file 字段上传本地文件，再将返回的 url 交给预览接口	201

请求参数、返回字段和示例请查看本项目对应接口。完整参数说明也可查看预览参数。

缓存与文件更新

转换缓存默认保留 7 天，可由部署方调整。分享有效期通过 options.validMinutes 单独设置，0 表示不限制分享时间；本地上传源文件默认保留 24 小时。转换缓存、分享链接和上传源文件是三个不同的期限。

如果客户修改了在线文件但地址未变，需要同步更新顶层 mtime，或清除缓存后重新生成预览。已生成的 HTML 页面是对应文件版本的快照。源站要求防盗链时，在预览请求顶层填写允许的 referer。

私有化部署与技术支持

可选择 Windows 或 Linux 部署，将文件预览接入企业自己的网络与业务系统。推荐服务器配置为 2 核 CPU、4 GB 内存、5 Mbps 带宽、40 GB 磁盘。安装依赖、首次部署、启动、重启与升级步骤见部署指南。

我们可以协助确认文件格式、接入方式、部署环境和授权方案。请提供准备接入的业务系统、常用文件类型与部署系统，通过上方二维码联系我们。

查看在线体验 · 查看授权与技术支持方案

96DOC 文件在线预览服务与接入说明

支持的文件格式#

功能清单#

快速接入#

使用文件地址打开预览#

由业务后端生成预览链接#

三个常用接口#

缓存与文件更新#

私有化部署与技术支持#