h5ai是一款功能强大 php 文件目录列表程序，不需要数据库，支持在线预览文本、图片、音频、视频等。
h5ai功能包括：文件排序，不同视图模式，本地化，面包屑，树视图，自定义页眉和页脚，文件过滤器和搜索，文件夹大小，自动刷新，打包下载，QR码，缩略图，文件预览。这篇文章就分享下利用宝塔面板来安装h5ai方法以及如何使用。

一、h5ai介绍

h5ai要求PHP 5.5+ 。兼容Apache httpd, lighttpd, nginx 和 Cherokee. 在Chrome, Firefox, Opera, Vivaldi, Safari and Edge上可以获得最佳体验。
官网：https://larsjung.de/h5ai/
github：https://github.com/lrsjng/h5ai

二、安装

1.web环境检查
在宝塔面板安装之前，我们需要在php中安装ImageMagick、fileinfo、exif扩展。

2.宝塔后台添加站点，用你自己的域名或IP都可以：

站点添加完成后将根目录下所有文件删除，并上传解压后的 _h5ai 文件夹，如下图：

然后修改 宝塔后台 - 网站 - 设置 - 默认文档，全部删除替换成下面的代码然后点击添加：
*index
index.html
index.php
/_h5ai/public/index.php*
示例图：

OK，完成，搭建其实很简单。打开 http://XXX.XXXX.com/_h5ai/public/index.php, 检查一下h5ai 是否可以访问. 同时，如果你的服务器有不兼容的话这里会显示。默认密码留空，如图：

登录之后，会有web环境检查的结果，如图：

确认无误，打开域名即可访问，界面如下：

三、h5ai使用与问题

1.密码
h5ai默认的是空密码，你可以在_h5ai/private/conf/options.json.中修改。h5ai其它的一些配置，例如字体、CSS、标题等都可以在options.json进行修改。

2.一些异常
h5ai运行异常
打开报错：
Warning : putenv() has been disabled for security reasons in /www/wwwroot/box.xsi.me/_h5ai/private/php/class-bootstrap.php on line 8
依次点击宝塔左侧的软件管理，搜索框中搜索PHP，找到自己使用的PHP版本，在对应的PHP版本后面，点击设置，然后选择禁用函数。按照下图，找到putenv，点击putenv后面的删除。

做完上面的操作之后，再次访问自己搭建h5ai的网址，就会发现，能正常打开了。
h5ai缩略图问题
需要配置好PHP的exif模块、ffmpeg、ImageMagick等组件。使用宝塔面板，自带了ImageMagick、fileinfo PHP Extension等一键安装。
打开缓慢的问题
由于h5ai引用了谷歌的字体库，而虽然谷歌字体在大陆恢复了解析，但是由于dns污染或者运营商问题访问还是有些抽风，所以才会导致这种情况的发生。为了加快打开速度，我们可以替换国内字体。
在站点根目录下的_h5ai/private/conf/options.json中找到resources项，将styles参数字符串中的fonts.googleapis.com更换为fonts.geekzu.org即可。

四：功能介绍

h5ai支持直接在线查看PDF、TXT、PHP、sh。doc不能在线阅读，只可以下载。

可以在线观看视频，如图：

可以在线预览图片，如图：

五、其他设置

h5ai虽然安装好了，但是功能还没有完全开启。通过以下一些设置，我们可以开启h5ai的全部功能。通过 http(s)://xxx.xxxx.com/_h5ai/public/index.php 可以查看 _h5ai 的全部功能开启情况，默认密码是空的。

Public Cache directory和Private Cache directory
把h5ai程序_h5ai中private和public两个文件夹中的cache目录权限设置为777，刷新一下网页可以看到两个no变为yes了。

Use EXIF thumbs
安装php的exif模块即可。
主要参考http://www.vpser.net/manage/lnmp-php-install-ext.html
把需要的exif模块编译进去，然后重启lnmp即可。

Movie thumbs（视频浏览）
选择安装ffmpeg，安装方法参考官网。
其中centos的安装ffmpeg方法记得好像很麻烦。最后找到两个打包好的源码包，直接就可以用。
CentOS 64位：http://down.lc/Linux/Tool/ffmpeg-3.1-64bit-static.tar.xz
CentOS 32位：http://down.lc/Linux/Tool/ffmpeg-3.1-32bit-static.tar.xz
tar xvJf解压到系统某个地方，然后在/usr/bin/目录创建软链接ffmpeg，指向解压包里面的ffmpeg就可以了。
完成后执行ffmpeg，显示版本等信息即可。
也可以选择安装avconv，到http://libav.org/download/下载源码编译安装即可。

Image thumbs（图片浏览）
安装 PHP 的 exif 模块

PDF thumbs（PDF浏览）
选择安装convert，直接yum -y install ImageMagick即可。

Shell tar，Shell zip和Shell du
这三项，根据h5ai官网，在php.ini被禁用函数中去掉exec和passthru即可，是否有危险不知道，自己掂量，禁用好像也不影响一些功能。
另外顺便把scandir函数去掉禁用，不然会出现无非显示目录中文件的情况。

除了网页中的功能以外，options.json还有一些默认关闭的小功能，我们可以选择开启他们。
打包下载
搜索 “download”
enabled 由 false 改为 true
文件信息及二维码
搜索 “info”
enabled 由 false 改为 true
默认简体中文
搜索 “l10n”
lang 由 en 改为 zh-cn
enabled 由 false 改为 true
文件及文件夹多选
搜索 “select”
enabled 由 false 改为 true。

https://blog.iwyc.cn/h5ai