关于H5ai
H5ai
是一款功能强大 php
文件目录列表程序,由德国开发者 Lars Jung 主导开发,它提供多种文件目录列表呈现方式,支持多种主流 Web
服务器,例如 Nginx
、Apache
、Cherokee
、Lighttpd
等,支持多国语言,可以使用本程序在线预览文本、图片、音频、视频等。
H5ai 需要最低 php5.5+

安装教程
1. 搭建web环境
可以用 LNMP,LAMP,或者直接宝塔一类面板安装。
2. 下载并上传H5ai程序到根目录
官网下载最新版本: https://release.larsjung.de/h5ai/
然后上传到网站根目录
目录关系
DOC_ROOT
├─ _h5ai
├─ your files
└─ and folders
把 public
和 private
权限 777
3. 修改Nginx配置文件
根据不同系统,修改当前域名下的 Nginx
配置文件
在 root
一行把 /_h5ai/public/index.php
添加进去
Apache httpd 2.2 / 2.4:httpd.conf
DirectoryIndex index.html index.php /_h5ai/public/index.php
lighttpd 1.4:lighttpd.conf
index-file.names += ("index.html", "index.php", "/_h5ai/public/index.php")
nginx 1.2:nginx.conf
index index.html index.php /_h5ai/public/index.php;
Cherokee 1.2: in cherokee.conf
vserver!1!directory_index = index.html,index.php,/_h5ai/public/index.php
最后重启 Apache
或者 Nginx
系统即可!
如宝塔面板,只需在
网站-设置-配置文件
中添加即可!
4. 修改PHP配置,解除禁用函数
php 配置文件路径:/usr/local/php/etc/php.ini
搜索:disable_functions
找到下列内容
disable_functions=passthru,exec,system,chroot,scandir,...
删除 scandir
、exec
、passthru
保存
重启 php
: /etc/init.d/php-fpm restart
5. 检测H5ai系
访问:http://YOUR-DOMAIN.TLD/_h5ai/public/index.php
检测 H5ai 系统兼容性


6. H5ai更多功能
6.1 安装FFmpeg
6.1.1打开/etc/apt/sources.list
添加软件源
deb http://www.deb-multimedia.org jessie main non-free
deb ftp://ftp.deb-multimedia.org jessie main non-free
deb http://www.deb-multimedia.org stable main non-free
deb ftp://ftp.deb-multimedia.org stable main non-free
详情去: http://ffmpeg.org/download.html
6.1.2 更新软件源
apt-get -y update
6.1.3 安装FFmpeg
1. 用 avconv
代替:
sudo apt-get update
sudo apt-get install libav-tools
2.FFmpeg:
apt-get -y install ffmpeg
安装时出现错误无法安装,提示没有安装依赖库

查了好多不知道怎么安装依赖库,最后不知道怎么自己就安装好了
先按照 6.1.1 把软件源改成了系统一样的 Jessie (oldstable):deb http://www.deb-multimedia.org jessie main
执行命令:
sudo apt-get update
sudo apt-get install deb-multimedia-keyring
sudo apt-get install ffmpeg
参考:https://superuser.com/questions/286675/how-to-install-ffmpeg-on-debian
CentOS7
安装 FFmpeg
或 libav
。
请查看 FFmpeg 官方最新版本:Here
升级系统
sudo yum install epel-release -y
sudo yum update -y
sudo shutdown -r now
安装 Nux Dextop Yum
源
由于 CentOS 没有官方 FFmpeg rpm 软件包。但是,我们可以使用第三方 YUM 源(Nux Dextop)完成此工作。
sudo rpm --import http://li.nux.ro/download/nux/RPM-GPG-KEY-nux.ro
sudo rpm -Uvh http://li.nux.ro/download/nux/dextop/el7/x86_64/nux-dextop-release-0-5.el7.nux.noarch.rpm
安装 FFmpeg
和 FFmpeg
开发包
sudo yum install ffmpeg ffmpeg-devel -y
测试是否安装成功
ffmpeg
如果你想了解更多关于 FFmpeg
使用方面的资料,可以输入:
ffmpeg -h
6.2 略微图功能
图片:
将 _h5ai
中,private
与 public
文件夹中的 cache
目录设置权限为 755
。
EXIF
:
直接用宝塔面板安装 PHP
,在 PHP
扩展选项里选择 Exif
模块安装
PDF
略缩图:
宝塔面板 PHP
扩展里找到 ImageMagick
安装
7.H5ai其他功能
以下不专门注明的话,都是在 h5ai
的默认设置文件中进行修改即可。默认设置文件路径为:
_h5ai/private/conf/options.json
1.设置默认语言。在配置文件中搜索l10n
找到设置,将en
改为zh-cn
即可。
"l10n": {
"enabled": true,
"lang": "zh-cn",
"useBrowserLang": true
},
2.开启文件搜索功能。在配置文件中搜索search
,将false
改为true
。
"search": {
"enabled": true,
"advanced": true,
"debounceTime": 300,
"ignorecase": true
},
3.多文件下载支援设置。
3.1 在配置文件中搜索 select
,将 false
改为 true
。之后你的 h5ai
点击文件先端的时候,并不是下载,而是选中文件,下载的按钮呢在左上角喽。如果要下载文件呢,可以点击文件名字依旧还是下载功能。
"select": {
"enabled": true,
"clickndrag": true,
"checkboxes": true
},
3.2 在配置文件中搜索 download
,将 false
改为 true
,如果需要设置打包文件的格式为 zip
,而不是默认的 tar
的话,需要将 php-tar
改为 shell-zip
。
"download": {
"enabled": true,
"type": "shell-zip",
"packageName": null,
"alwaysVisible": false
},
4.二维码下载
可以通过扫码的方式下载文件。在配置文件中搜索 info
,将 false
改为 true
,这里有 2
个地方要改。
"info": {
"enabled": true,
"show": true,
"qrcode": true,
"qrFill": "#999",
"qrBack": "#fff"
},
当你鼠标置于文件上时,可以看见 h5ai
右侧显示文件类型和二维码,手机扫码就可以下载文件。
5.加密
首先生成自定义 sha512
密码:http://md5hashing.net/hashing/sha512
然后搜索 passhash
,大概第 10
行,将其密码改成自己生成的。
请问显示 empty 怎么办?明明在_h5ai 的上一级放了好几个文件的...
好久不用了,刚刚装了一下,按步骤做,没问题呢
是不是那几个禁用函数,没有删掉?
删掉后重启 php
好吧… 文件夹里面有个 index.html 给识别到了… 删了完事
谢谢 awa
[...] H5ai 完整安装及使用教程 - 雨林的博客 [...]
我在安装成功之后只能进入检查兼容性页面,而无法进入目录页面。且在查询过官方文档以及大量教程后依然无法找到 “文件目录” 的路径,希望能告知。
直接访问你的网址就行了,不要加后缀
好吧… 文件夹里面有个 index.html 给识别到了… 删了完事
谢谢 aea