mirror of
https://github.com/kuaifan/dootask.git
synced 2026-08-01 19:05:55 +00:00
54 lines
2.3 KiB
Markdown
54 lines
2.3 KiB
Markdown
---
|
||
id: fileview.plugin.concept
|
||
title: fileview 插件元信息
|
||
type: concept
|
||
feature: fileview
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- fileview 插件
|
||
- kkfileview 插件
|
||
- 安装文件预览
|
||
- 文件预览插件版本
|
||
- 预览插件多大
|
||
related_tools: []
|
||
related_pages: [application]
|
||
prerequisites: []
|
||
negative:
|
||
- 未安装 fileview 插件时，PDF/Office 等文件点击后会报错或下载，无法在线预览
|
||
- 主程序不内置 kkfileview，本插件是唯一来源
|
||
- 不能离线安装到不联网的环境（需访问应用市场镜像源）
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# fileview 插件元信息
|
||
|
||
## 定义
|
||
文件在线预览由 `fileview` 插件提供（应用市场 app id 为 `fileview`，当前主版本 4.4.0，基于开源 kkfileview 引擎）。主程序在用户点击文件时判断扩展名，若属于 fileview 范畴则 301 跳转到 `fileview/onlinePreview?url=<base64>`，由 fileview 容器渲染。
|
||
|
||
## 关键属性
|
||
- **作者**：社区维护（Community），上游 https://kkview.cn/
|
||
- **分类**：微应用（不在管理员应用区，但行为更像「基础设施」——不直接出现在「应用中心」用户菜单，由文件页自动触发）
|
||
- **包大小**：约 630MB（含 LibreOffice + 各类转码工具）
|
||
- **运行形态**：独立 Docker 容器，对接主程序 nginx 上的 `/fileview/` 反代
|
||
- **渲染方式**：服务器侧用 LibreOffice 把 docx/pptx 转 PDF 再推到浏览器；纯 PDF 直接 PDF.js 渲染；图片格式化预览
|
||
- **跨设备**：桌面端、移动端均能预览
|
||
|
||
## 安装与启用
|
||
1. 在应用市场（管理员入口）搜索「FileView」或「文件预览」
|
||
2. 点击安装，等待镜像下载（约 630MB，按「安装日志」判断进度）
|
||
3. 安装完成后插件自动启用，所有未被主程序原生预览覆盖的文件点击后会自动用 fileview 渲染
|
||
|
||
## 卸载影响
|
||
- 卸载后点击 PDF/Office 等文件会失败（路径仍指向 fileview 但容器不存在）
|
||
- 重装后自动恢复
|
||
|
||
## 与 OnlyOffice 共存
|
||
- 同时装了 office 和 fileview：Word/Excel/PPT 优先走 OnlyOffice 编辑器（可编辑）
|
||
- 只装 fileview：Word/Excel/PPT 只能用 fileview 只读预览
|
||
- 只装 office：fileview 才能预览的格式（如 PDF、Visio、CAD 等）无法在线预览
|
||
|
||
## 相关
|
||
- 是什么：[[fileview.concept]]
|
||
- 支持的文件类型：[[fileview.supported.concept]]
|