H5ai搭建私人网盘用于存放常用软件下载 - soft.maotao.net 服务器文件目录列表共享程序

一、简介

h5ai 是一款功能强大的 php 文件目录列表程序，提供多种文件目录列表形式，有点类似Windows的文件管理器，可以实现直链下载文件、在线预览 txt / 图片 / 音频 / 视频等文件格式。重点是，h5ai 界面十分友好，还能支持二维码展示！

• 演示站：soft.maotao.net
• h5ai 官网

二、安装

要求：PHP 5.5+，本文使用的 PHP7.4

1、搭建网站环境

可使用一键包或者宝塔等面板程序搭建。宝塔面板安装请看官方教程，并在初次安装 LNMP 时注意 PHP 版本。在宝塔面板中新建网站，输入域名；在域名解析商设置对应的解析。

2、上传h5ai文件到网站根目录

h5ai本地下载地址：h5ai-0.29.0.zip，将文件解压后放在网站根目录。

3、修改配置文件
只需要在配置文件某个地方加上

/_h5ai/public/index.php

即可，宝塔面板的话就是把这个加入到默认文档即可。

最后重启服务器即可！并将要共享的文件均放到根目录（与_h5ai同一目录下）。

安装注意

如果存在文件，但读不出来，可能原因就是php已禁用scandir函数了，请修改php.ini解决。

disable_functions=passthru,exec,system,chroot,scandir,...

删掉scandir,字样，再重启php即可：/etc/init.d/php-fpm restart。

如果是宝塔面板的话，修改 php 配置 – 禁用函数，解除禁用函数 scandir、exec 和 passthru。如果禁用列表中有这三个函数，删除即可。

把h5ai程序_h5ai中private和public两个文件夹中的cache目录权限设置为777。

拓展安装

访问 http://你的域名/_h5ai/public/index.php 进入后台检查，默认密码为空，直接点击 login 进入。

后台检查会列出安装情况，最好都达成 yes！

1. PDF 缩略图拓展

安装 imagemagick 即可满足。

2. EXIF

宝塔后台安装exif 扩展

3. 视频缩略图拓展

请自行搜索系统名称+安装 ffmpeg，这个拓展我用不到，所以就不列出教程了。

功能定制优化

以下均在配置文件/www.xx.com/_h5ai/private/conf/options.json修改

1、开启选择功能

"select": {
        "enabled": false,
        "clickndrag": true,
        "checkboxes": true
    },

将false修改为true，即：

"select": {
        "enabled": true,
        "clickndrag": true,
        "checkboxes": true
    },

该功能可方便我们进行批量下载。

2、开启搜索功能

"search": {
        "enabled": false,
        "advanced": true,
        "debounceTime": 300,
        "ignorecase": true
    },

将false修改为true，即：

"search": {
        "enabled": true,
        "advanced": true,
        "debounceTime": 300,
        "ignorecase": true
    },

开启后我们可以更快的找到文件了。

3、开启二维码功能

"info": {
        "enabled": false,
        "show": false,
        "qrcode": true,
        "qrFill": "#999",
        "qrBack": "#fff"
    },

将false修改为true，即：

"info": {
        "enabled": true,
        "show": true,
        "qrcode": true,
        "qrFill": "#999",
        "qrBack": "#fff"
    },

开启二维码后，我们可以直接手机扫描二维码下载，很方便。

4、 在目录头部或尾部显示 HTML 内容

在需要显示自定义 HTML 的目录下，添加 _h5ai.headers.html 和/或 _h5ai.footers.html。这个通常用于对该目录的一些说明。支持 HTML 标签。

_h5ai.headers.html   头部 HTML

<h1 style="text-align:center">标题</h1>
<p style="text-align:center">
正文内容
</p>

_h5ai.footers.html   尾部 HTML

<p style="text-align:center">正文内容</p>

这里使用 _h5ai.headers.md 和 _h5ai.footers.md 也可以

5、 打包下载

多文件下载设置需要配置两步。第一步，先配置让 h5ai 支持文件选择（就是复选框喽！）

"select": {
"enabled": true,
"clickndrag": true,
"checkboxes": true
},

配置文件中搜索 “download”，将 false 改为 true，如果需要设置打包文件的格式为 zip，而不是默认的 tar 的话，需要将 php-tar 改为 shell-zip。

"download": {
"enabled": true,
"type": "shell-zip",
"packageName": null,
"alwaysVisible": false
},

6、 字体加速

h5ai 使用了谷歌字体，如有必要，可以更换为大佬们制作的镜像地址。
打开文件目录：h5ai/private/conf/options.json，找到 resources 项，将 styles 参数中的 fonts.googleapis.com 替换为：fonts.geekzu.org

7、修改默认显示域名

h5ai安装好后，打开网站默认在浏览器选项卡里显示的标题是域名
修改方法是打开 _h5ai/public/js/scripts.js 文件，
找到下面一行

===t?f.getDomain():n.name

修改为

===t?'你想显示的内容':n.name

8、设置默认语言

在配置文件中搜索“l10n”找到设置，将en改为zh-cn即可。

"l10n": {
        "enabled": true,
        "lang": "zh-cn",
        "useBrowserLang": true
    },