为AList V3添加在线epub预览支持教程

为AList V3添加在线epub预览支持教程

本文章同步发布于我的个人博客：
萌萌哒赫萝的小站

AList V3是一个支持多种存储的文件列表程序，使用 Gin 和 Solidjs开发。

AList的默认预览功能中，并不支持epub格式电子书的在线预览，经过我的摸索，成功基于epub.js项目，为AList添加了epub的预览支持，效果如下所示：

下面，我就介绍一下如何进行搭建。

说明

类似于pdf.js，一些不支持CORS的相关云盘无法预览，比如阿里云盘。

此外，如果未使用https，也可能会出问题，请提前为域名部署证书。

文件加载速度与网速密切相关，如果是200M以上的全本小说可能需要数分钟的时间，请耐心等待。

动图演示

工具准备

首先我们需要准备以下文件，js和css可以通过CDN链接的方式引入html文件或者下载到需要部署的本地服务器目录内。

• jszip.min.js
• epub.min.js
• examples.css
• spreads.html

部署

修改Nginx设置

在自己的AList网站根目录下，新建一个epub目录，将刚才下载的文件复制进来并修改用户和用户组为www:www。

在部署Alist时，根据官方指南，我们设置了如下的反向代理，这会使得我们新添加的epub目录也被转发。

location / {
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header Host $http_host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header Range $http_range;
  proxy_set_header If-Range $http_if_range;
  proxy_redirect off;
  proxy_pass http://127.0.0.1:5244;
  # the max size of file to upload
  client_max_body_size 20000m;
}

因此，我们需要添加如下一行来进行排除。

location /epub/ {}

修改spreads.html文件

如果将js文件和css文件都下载在了本地服务器，请修改对应部分的引入代码为本地相对路径，例如放在同一目录下时：