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系统兼容性
问题汇总
删除根目录下面的默认index.html文件
需要注意的是,在虚拟主机根目录下,如果有 index.html 的话(宝塔或者其他面板可能会放置一个默认的 index.html 文件),请将其删除,否则不显示虚拟主机下的任何目录及文件。
报错
如果打开网页出现以下错误:Warning: putenv() has been disabled for security reasons in
原因:禁用了部分存在危险的PHP函数
解决方法:
php禁用函数删去putenv
修改网站配置
根据个人需求,在/_h5ai/private/conf/options.json
中修改配置
如设置默认语言为中文
"l10n": {
//用户是否可以自行选择语言
"enabled": true,
//默认语言,"zh-cn"为简体中文,其他支持的语言可以到"/_h5ai/conf/l10n"中查看
"lang": "zh-cn",
//根据浏览器自动判断语言
"useBrowserLang": true
},
开启搜索功能
依然是修改options.json
这个文件,将
"search": {
"enabled": false,
"advanced": true,
"debounceTime": 300,
"ignorecase": true
},
false
修改为true
就OK了
"search": {
"enabled": true,
"advanced": true,
"debounceTime": 300,
"ignorecase": true
},
显示二维码
某些手机软件为了方便下载,可以开启二维码显示功能,直接用手机扫描下载,非常方便。修改options.json
配置文件,
"info": {
"enabled": false,
"show": false,
"qrcode": true,
"qrFill": "#999",
"qrBack": "#fff"
},
false
修改为true
就OK了
"info": {
"enabled": true,
"show": true,
"qrcode": true,
"qrFill": "#999",
"qrBack": "#fff"
},
替换Google字体
这时候你会发现h5ai打开速度非常缓慢,原因是加载了Google字体导致,Google字体在墙内总是时灵时不灵的一会儿打得开一会儿打不开,干脆替换掉。修改options.json
配置文件将fonts.googleapis.com
替换为fonts.lug.ustc.edu.cn
即可,替换后如下:
"resources": {
"scripts": [],
"styles": [
"//fonts.lug.ustc.edu.cn/css?family=Ubuntu:300,400,700%7CUbuntu+Mono:400,700"
]
},
总结
h5ai是一款很不错的软件,可以实现很多功能,比如安装ffmpeg可以达到在线播放的功能。
安装过程也相对简单,只是不适合作为私人文件的存储,如果是私人网盘的话可以考虑KodCloud或者NextCloud。