服务器：WindowsServer 2016

Cloudreve

需求方想整一个在小团队内部使用的网盘系统，最终在千挑万选之下选中了 Cloudreve .

Github地址： https://github.com/cloudreve/Cloudreve 。

官网地址： https://docs.cloudreve.org 。

Cloudreve 是采用 go + React 开发的开源网盘系统，优点是部署简单、界面功能精简好用、更新比较活跃、文档详细，目前在 Github 的 Star 1.6w+ .

第一步：下载

下载后的文件结构如下图所示（只有 cloudreve.exe 和 conf.ini ） 。

nssm下载链接 。

提取码: dtbb 。

第二步：修改配置文件

配置文件主要还是配置端口和数据库，其他详细配置可以去官网查看 。

                        
                          [System]
Debug = false
Mode = master
Listen = :7018
SessionSecret = iA9nowZRHi6s5XSAFEVrNl0njyqZfjmx6mZQGWVBbMQG32SE5dx6pVWPTNTeByTh
HashIDSalt = 5hrN8NvlA7LxdVJCkjlHb5A1Ut2Rph85GqfhwZWvpn2tnGi79uEomziXkHStFMZT

[Database]
Type = mysql
Port = 3306
User = cloudreve
Password = xxxxx
Host = 0.0.0.0
Name = Cloudreve
TablePrefix = cd
Charset = utf8

                        
                      

第三步：启动

双击 cloudreve.exe 文件便可以直接启动，启动成功的界面如下:

初始化的数据库表:

真正使用还是建议部署成 windows 服务，这时候可以使用上面提到的 nssm 工具.

cd 到 nssm 工具对应的目录，输入： nssm install 便会出现如下界面:

安装成功后，进到服务管理启动对应的服务即可.

系统成功启动后的界面如下:

kkFileView

网盘部署好了，需求方又提了个需求，想要支持在线预览.

Cloudreve 自带预览 PDF 和 TXT 格式的文件，如果需要预览 Office 相关文件就需要自己对接第三方服务.

目前提供在线预览的第三方服务有很多，比如微软大大就提供有免费的文档在线预览服务，但前面有说到，网盘系统是在内部使用，这一条只能 pass ，第三方不行那就自己做第三方.

于是，万能的 Github 又登场了.

kkFileView 是采用 java 开发的文件文档在线预览方案，目前在 Github 的 Star 7.8K+ .

Github地址： https://github.com/kekingcn/kkFileView 。

Gitee地址： https://gitee.com/kekingcn/file-online-preview 。

官网地址： https://kkfileview.keking.cn 。

两个系统都有个优点，就是部署简单，文档详细.

下载下来的文件结构如下，点击 startup.bat 文件等待片刻后在浏览器中打开： http://localhost:8012 便会看到 kkFileView 的测试页面.

如果能看到上图就表示启动成功了，大家可以自行在测试页面上测试相关文件的预览效果，具体的参数配置可以参考官方文档，非常详细.

集成

上面两步我们已经将网盘服务和在线预览服务都部署成功了，接下来就是合二为一.

我们先进到 Cloudreve 的管理面板 —— 参数设置，有两个信息我们需要配置.

1、站点URL记得添加端口号

2、图像与预览修改Office 文档预览服务地址： http://127.0.0.1:8012/onlinePreview?url={$srcB64}

最后点击保存几即可.

配置成功后，我们去试试预览效果，双击对应的文件:

诶，怎么回事，预览失败了，而且这个文件类型 lpmatwo4pg1n8bc6 是什么鬼.

其实这与 kkFileView 的预览机制有关系， kkFileView 预览是通过下载地址的文件后缀名去判断文件类型，但 Cloudreve 生成的下载链接文件名是一串随即字符且不包括文件后缀，所以 kkFileView 在处理时不知道对应的文件类型，导致预览失败.

知道问题了就有解决办法:

1. 修改 Cloudreve 的下载链接生成逻辑，使其带上文件后缀 。

2. 修改 kkFileView 的文件类型识别逻辑 。

因为 Cloudreve 是将前后端统一打包成 exe 可执行程序，如果修改后还要打包太麻烦，所以放弃解决办法一（其实这个解决办法才是相对科学的。） 。

修改

先去 Gitee 或者 Github 下载 kkFleView 源码 。

下载下来后可以根据如下路径找到对应文件:

                        
                          file-online-preview-master\server\src\main\java\cn\keking\web\controller\OnlinePreviewController.java

                        
                      

修改思路：根据文件的前 n 个起始字节，也被称为魔数去判断对应文件属于什么文件类型，但是这个方法也存在缺陷， wps 和 office 相关文件的魔数一样，无法做详细区分，比如： docx、xlsx、pptx .

上代码

因为本人是微软阵营的，对 Java 这块不熟悉，代码仅做参考.

1、建立魔数与文件类型的键值对映射关系（只列举了常用的一些，准不准确大家可以自行验证）

                        
                          public final static Map<String, String> FILE_TYPE_MAP = new HashMap<String, String>();

static {
    FILE_TYPE_MAP.put("ffd8ff", "jpg");
    FILE_TYPE_MAP.put("89504e47", "png");
    FILE_TYPE_MAP.put("47494638", "gif");
    FILE_TYPE_MAP.put("49492a00227105008037", "tif");
    FILE_TYPE_MAP.put("424d228c010000000000", "bmp"); // 16色位图(bmp)
    FILE_TYPE_MAP.put("424d8240090000000000", "bmp"); // 24位位图(bmp)
    FILE_TYPE_MAP.put("424d8e1b030000000000", "bmp"); // 256色位图(bmp)
    FILE_TYPE_MAP.put("41433130313500000000", "dwg");

    FILE_TYPE_MAP.put("68746d6c3e", "html"); // HTML
    FILE_TYPE_MAP.put("48544d4c207b0d0a0942", "css");
    FILE_TYPE_MAP.put("696b2e71623d696b2e71", "js");
    FILE_TYPE_MAP.put("38425053000100000000", "psd");
    FILE_TYPE_MAP.put("255044462d312e", "pdf");
    FILE_TYPE_MAP.put("75736167", "txt");

    FILE_TYPE_MAP.put("00000020667479706d70", "mp4");
    FILE_TYPE_MAP.put("49443303000000002176", "mp3");
    FILE_TYPE_MAP.put("41564920", "avi");

    FILE_TYPE_MAP.put("3c3f786d6c", "xml");// xml文件
    FILE_TYPE_MAP.put("504b03040a000", "office");// office文件
    FILE_TYPE_MAP.put("504b030414000", "office");// office文件
    FILE_TYPE_MAP.put("d0cf11e0a1b11ae10000", "wps");// WPS文字wps、表格et、演示dps都是一样的
}

                        
                      

注意： office 和 wps 下的相关文件（ docx、xlsx、pptx ）的魔数都一样，所以大家可以默认设置成其中一种即可（我默认的是 xlsx ）， kkFileView 预览 office 相关文件依赖的是 OpenOffice 和 LibreOffice .

2、根据文件流判断文件类型

                        
                          /**
 * 获取文件类型
 */
private String getFileType(String fileUrl) throws IOException {
    URL newUrl = new URL(fileUrl);
    HttpURLConnection conn = (HttpURLConnection) newUrl.openConnection();
    InputStream inputStream = conn.getInputStream();
    byte[] bytes = IOUtils.toByteArray(inputStream);

    StringBuilder stringBuilder = new StringBuilder();
    for (int i = 0; i < 20; i++) {
        int v = bytes[i] & 0xFF;
        String hv = Integer.toHexString(v);
        if (hv.length() < 2) {
            stringBuilder.append(0);
        }
        stringBuilder.append(hv);
    }

    String fileCode = stringBuilder.toString().toLowerCase();
    String fileType = null;
    Iterator<String> keyIter = FILE_TYPE_MAP.keySet().iterator();
    while (keyIter.hasNext()) {
        String key = keyIter.next();
        if (fileCode.startsWith(key)) {
            fileType = FILE_TYPE_MAP.get(key);
            break;
        }
    }
    return fileType;
}

                        
                      

3、找到 OnlinePreviewController.java 文件的对应方法

主要是在 getFileAttribute 方法内加一层后缀名的处理，为了不影响原方法，所以我们新增一个 。

                        
                          /**
 * 获取文件属性（扩展无后缀名）
 *
 * @param url url
 * @return 文件属性
 */
public FileAttribute getFileAttributeEx(String url, String suffix, HttpServletRequest req) {
    FileAttribute attribute = new FileAttribute();
    FileType type;
    String fileName;
    String fullFileName = WebUtils.getUrlParameterReg(url, "fullfilename");
    if (StringUtils.hasText(fullFileName)) {
        fileName = fullFileName;
        type = FileType.typeFromFileName(fullFileName);
        suffix = KkFileUtils.suffixFromFileName(fullFileName);
    } else {
        fileName = WebUtils.getFileNameFromURL(url);
        String newUrl = url;
        int index = newUrl.indexOf("?");
        if (index < 0) {
            newUrl = newUrl + "." + suffix;
        } else {
            newUrl = newUrl.substring(0, index) + "." + suffix + newUrl.substring(index, newUrl.length() - 1);
        }
        type = FileType.typeFromUrl(newUrl);
        suffix = WebUtils.suffixFromUrl(newUrl);
    }
    if (url.contains("?fileKey=")) {
        attribute.setSkipDownLoad(true);
    }
    attribute.setType(type);
    attribute.setName(fileName + "." + suffix);
    attribute.setSuffix(suffix);
    attribute.setUrl(url);

    ......

    return attribute;
}

                        
                      

完事后我们再来看看预览效果:

原文件：

预览效果：

注意： kkFileView 对 xlsx 和 xls 文件的处理默认是以 html 形式转换，其他文件都是以 pdf 形式，由于 xlsx 和 xls 转 pdf 后的效果太过凌乱，权衡利弊下 office 和 wps 相关的文件全部指定为 xlsx ，以 html 形式展示.

---

最后，这个问题其实很早就有人提出过， Cloudreve 的作者也在 Issues 中回复下个版本会增加单独扩展名变量，所以文章的解决方案仅仅做一个分享，大家等 Cloudreve 版本更新会更好.

最后此篇关于在Cloudreve网盘系统中集成kkFileView在线预览（暂时）的文章就讲到这里了,如果你想了解更多关于在Cloudreve网盘系统中集成kkFileView在线预览（暂时）的内容请搜索CFSDN的文章或继续浏览相关文章，希望大家以后支持我的博客！ 。