• 欢迎访问水熊虫网站,这里是我个人的工作博客,内容大多是遇到问题完善后,会在这里进行总结归纳内容! QQ群
  • 网站导航中的友情链接专栏上线,更新的都是自己这三年整理的一些东西,感兴趣可以看看!
  • 你所浪费的今天,是昨天死去的人奢望的明天。你所厌恶的现在,是未来的你回不去的曾经!

h5ai 目录列表程序完整安装使用教程

云主机问题 WaterBear 3年前 (2018-01-14) 618次浏览 已收录 扫描二维码
文章目录[隐藏]

h5ai 目录列表程序完整安装使用教程

什么是 h5ai

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

请注意,默认情况下,放到目录下的 .php 文件将会被直接执行,并不以文本显示。

安装

1.1 首先需要搭建好 Web 服务器,例如 LNMP(Linux/Nginx/MySQL/Php)组合,本文直接以 LNMP 组合为例。

推荐使用 PHP 7 版本。

1.2 下载 h5ai 安装包

转至官网下载:https://larsjung.de/h5ai/

1.3 设置好虚拟主机后,编辑虚拟主机配置文件:

vim /usr/local/nginx/conf/vhost/your_domain.conf

1.3.1 将配置默认首页 一行,改为:

index index.html index.php /_h5ai/public/index.php;

1.4 去除被禁用的 PHP 函数:

vim /usr/local/php/etc/php.ini
搜索 scandirexecpassthru,将其从被禁用的函数中删除。

1.5 重启 web 服务器:

service php-fpm restart
service nginx reload

1.6 虚拟主机 ROOT 目录大概是这个样子的,要在网站上显示的目录和 _h5ai 文件夹放在一起:

.
├── _h5ai
│   ├── CHANGELOG.md
│   ├── private
│   ├── public
│   └── README.md
├── 您要显示的文件夹
│   ├── 子文件夹1
│   ├── 文件1
│   └── 文件2
└── 您要显示的文件夹
├── 文件1
└── 文件2

开启 h5ai 更多功能

到目前为止,h5ai 可以正常使用了,但是我们可以开启 _h5ai 全部功能。通过 http(s)://your_domain/_h5ai/public/index.php 可以查看 _h5ai 的全部功能开启情况,默认密码是空的。

2.1 安装 FFmpeg

[v_organge]debian 8:2.1.1 编辑软件源文件:

vim /etc/apt/sources.list

2.1.2 添加四个软件源

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

2.1.3 更新软件源

apt-get -y update

[/v_organge]


[v_organge]

 Ubuntu 16.04+:
直接通过命令安装:

apt-get -y install ffmpeg

[/v_organge]


[v_organge]

CentOS:需要安装 FFmpeg 或 libav软件 

安装详情请查看:https://waterbear.pw/796.html

[/v_organge]

2.2 略缩图功能

2.2.1 图片:
将 _h5ai 中,private 与 public 文件夹中的 cache 目录设置权限为 755。
2.2.2 EXIF:
通过 phpize 安装 PHP 的 exif 模块即可。
2.2.3 视频略缩图:
参考 2.1 安装 FFmpeg 即可。
2.2.3 PDF 略缩图:
安装 ImageMagick。

可使用如下命令:

Ubuntu/Debian:
apt-get install ImageMagick -y
CentOS:
yum install ImageMagick ImageMagick-devel -y

2.3 Shell tar、Shell zip和Shell du

参考 1.4 去除在 php.ini 中被禁用函数 exec与 passthru 、putenv即可。

另外去除禁用的 scandir 函数(如果有),不然会导致无法显示目录。

2.4 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

 },

设置好后,h5ai左上角就有会有一搜索按钮,即可搜索h5ai目录里的文件。

3.多文件下载支援设置。多文件下载设置需要配置两步。第一步,先配置让h5ai支持文件选择(就是复选框喽!),第二步支援打包下载。

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右侧显示文件类型和二维码,手机扫码就可以下载文件。

以上就是h5ai我使用时候的设置,也是比较常用的设置,开启之后使用更加方便了,更加符合我们的操作习惯了,因此我推荐以上功能全部启用。

默认密码:

首先生成自定义 sha512 密码:http://md5hashing.net/hashing/sha512
然后搜索 “passhash”,大概第 10 行,将其密码改成自己生成的。

上一张完整开启所有功能的截图:

h5ai 目录列表程序完整安装使用教程

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

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

_h5ai.headers.html 头部 HTML
_h5ai.footers.html 尾部 HTML

2.6 H5ai加密目录

对于h5ai的目录加密来说,我个人的需求仅仅是部分目录加密,比如存放个人资料或者某类种子的时候,才需要加密,其余目录依旧是属于公共开放目录。

1.在nginx的安装目录下生成一个用户登录的账号和密码。

#生成你的账号密码信息,请替换命令中的用户名和密码。

printf “youruser:$(openssl passwd -crypt yourpassword)\n” >> /usr/local/nginx/conf/htpasswd

2.编辑虚拟主机配置文件,其实在安装h5ai的时候就已经配置过一次了,路径不变依旧是:

#虚拟主机配置文件路径

/usr/local/nginx/conf/vhost/your_domain.conf

在截图位置处添加一下代码。

代码如下:

 location ~ ^//.*
{
       auth_basic "please login!";
        auth_basic_user_file htpasswd;
        autoindex on;
 }

其中将红色部分xzymoe替换为你需要加密的目录即可。

h5ai 目录列表程序完整安装使用教程

不要忘记重启nginx哦。依旧直接重启lnmp。

lnmp restart

重新打开你的h5ai,登陆刚才已经加密了的目录试一试。

h5ai 目录列表程序完整安装使用教程


WaterBear , 版权所有丨如未注明 , 均为原创丨本网站采用BY-NC-SA协议进行授权
转载请注明原文链接:h5ai 目录列表程序完整安装使用教程
喜欢 (0)
[[email protected]]
分享 (0)