在线预览图片、文档、文本、视频等格式
# 简介
文件预览模块，通过浏览器在线快速预览文件，支持在线转换为浏览器可识别的格式。
包括但不限于以下格式，只要您可以解析的文件，可很容易扩充其它格式。
- 图片预览：gif、bmp、jpeg、jpg、png、ico
- 文档预览：doc、docx、xls、xlsx、ppt、pptx
- PDF文件：pdf、ofd(v5.12)
- 文本文件：txt
- 音频文件：mp3、ogg、wav
- 视频文件：mp4、webm、mkv
演示地址（请先登录再访问）：http://demo.jeesite.com/js/a/index#/js/a/filemanager/index#文件管理 (opens new window)
# 部署方法
# 引入模块
<!-- 文件在线预览 -->
<dependency>
<groupId>com.jeesite</groupId>
<artifactId>jeesite-module-filepreview</artifactId>
<version>${project.parent.version}</version>
</dependency>
1
2
3
4
5
6
2
3
4
5
6
注意：v4.2.0+ 标准版提供，此模块依赖，请向售后人员索取。
# 参数配置
在线转换需要依赖 LibreOffice（安装方法 (opens new window)）工具，请配置如下参数：
# 文档转换工具
jodconverter:
# 方式一：本地转换服务
local:
enabled: true
# 请安装 LibreOffice 软件，用于转码 office 文件为浏览器可预览文件
# 下载地址：https://zh-cn.libreoffice.org/download/libreoffice/
# ========== 一定要指定 LibreOffice 的主目录 ==========
# Windows 环境：
# officeHome: "C:/Program Files/LibreOffice"
# LibreOffice 便携版，需要加 /App/libreoffice 后缀
officeHome: D:/LibreOffice/LibreOfficePortable/App/libreoffice
# CentOS Linux 环境：
# 方法1：yum -y install libreoffice
# 方法2：https://zh-cn.libreoffice.org/get-help/install-howto/linux/
# Linux 中文字体乱码解决：
# 方法1：`yum groupinstall "fonts"`
# 方法2：
# 1、上传 C:\Windows\Fonts 下的字体到 /usr/share/fonts/windows 目录
# 2、执行命令： chmod 644 /usr/share/fonts/windows/* && fc-cache -fv
# 安装完成后可执行这个命令验证是否成功：libreoffice --version
# officeHome: /usr/lib64/libreoffice
# MacOS 苹果操作系统环境：
# 安装：brew install libreoffice
# officeHome: /Applications/LibreOffice.app/Contents
# 监听端口
portNumbers: 2002
# 方式二：远程转换服务（v5.1.0+），暂不支持 xlsx 中的图片转换
# 联系售后获取 jeesite-web-jodconverter 转换服务
remote:
enabled: false
url: http://127.0.0.1:8002
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
# 常见问题
为什么在线预览打不开，提示 “An error occurred” 错误。若您没有配置 LibreOffice，则此功能默认使用的微软公司 Office Web Viewer (opens new window) 服务，需要将项目部署到外网域名默认端口才可以使用该功能。LibreOffice 不需要外网环境。
Linux 中文字体乱码，您需要安装字体，方法1：
yum groupinstall "fonts"；方法2：上传 C:\Windows\Fonts 下的字体到 /usr/share/fonts/windows 目录，然后进行目录授权：chmod 644 /usr/share/fonts/windows/* && fc-cache -fv如果提示 “Office process died with exit code: 127” 错误。尝试执行
libreoffice --version看看是否提示某动态库错误。可以尝试安装一下依赖：yum -y install cairo cups-libs libSM
- 文件无法预览，请按 F12 查看浏览器控制台，如果提示 “The page at 'https://xxx' was loaded over HTTPS, but requested an insecure resource 'http://xxx/xxx/xxx.pdf?source=preview'. This request has been blocked; the content must be served over HTTPS” 错误是因为，Nginx 和 Tomcat 访问协议不匹配的问题，可尝试修改
application.yml中的server.schemeHttps设置为true
