---
kind: external_dependency
name: kkFileView 在线预览服务
slug: kkfileview
category: external_dependency
category_hints:
    - vendor_identity
scope:
    - '**'
---

### kkFileView 在线预览
- 角色：文档在线预览服务，支持多种文件格式的浏览器端预览
- 集成点：`crm-file` 模块通过 `crm.file.preview.kkfileview-url` 配置地址；后端对文件生成内网 presigned GET → 拼入 kkFileView onlinePreview 地址返回给前端
- 使用模式：浏览器只接触 kkFileView，MinIO 不暴露公网；kkFileView 凭短时效凭证从 MinIO 拉取原始文件进行格式转换（回源）
- 关键约束：kkFileView 地址必须浏览器可达；presign-ttl 控制回源凭证有效期（默认 10m）
- verify exact API/params against official docs