H5ai文件目录列表程序常见参数配置

h5ai 是用于 HTTP Web 服务器的现代文件索引器，专注于您的文件。目录以吸引人的方式显示，浏览它们通过不同的视图、面包屑和树概述得到增强。最初h5ai是HTML5 Apache Index的首字母缩写，但现在它也支持其他Web服务器。

首先，我们需要部署好H5ai目录列表程序，此文不描述安装部署过程，仅说明常见参数的配置。

配置H5ai

一、安全性设置

这个非常重要，一定不要嫌麻烦而不做。

1、设置功能自检页面访问密码

功能自检访问地址：你的域名/_h5ai/public/index.php

密码修改路径：_h5ai/private/conf/options.json，开头就是密码部分，下面是默认配置。

/*

Password hash.

SHA512 hash of the info page password, the preset password is the empty string.

Online hash generator: https://md5hashing.net/hash/sha512

*/

"passhash": "cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af927da3e",

我们需要修改的密码部分就是"passhash"，它的值是经过 SHA512 hash 计算后的结果，比如这里默认值是

"cf83e1357eefb8bdf1....327af927da3e"（中间太长用...代替）

其实这串字符是“空值“经过SHA512 hash 计算后的结果，所以在最开始功能自检页面不用输入密码，直接就能登录。

所以，这里你要修改密码，其实是填你要修改的密码经过SHA512 hash计算后的结果。

比如，你要修改密码为maxcblog.com，通过在线密码生成工具SHA512 online，进行计算，将生成的结果填入passhash，即替换为"6d3d0bafc00b257c4bd7e....1fa6c7f3571"即可。（中间太长用....代替，实际操作请完整复制）

2、设置/_h5ai/private目录访问返回404

这么私人的目录，当然不能随随便便让人访问啦。设置也很简单，在网站配置文件中添加下面的内容即可。

注意一下格式哦，对齐保持一致哈，不然可能有莫名其妙的错误哦。

location = /_h5ai/private/

{

return 404;

}

3、设置网站访问密码

即访问网站需要先登录账号密码才能查看。

修改文件路径/你的域名/_h5ai/public/index.php,将下面内容添加到末尾。

function auth () {

$valid_passwords = array ("账号" => "密码");

$valid_users = array_keys($valid_passwords);

$user = $_SERVER['PHP_AUTH_USER'];

$pass = $_SERVER['PHP_AUTH_PW'];

$validated = (in_array($user, $valid_users)) && ($pass == $valid_passwords[$user]);

if (!$validated) {

header('WWW-Authenticate: Basic realm="Storage Server"');

header('HTTP/1.0 401 Unauthorized');

die ("Your permission is denied！");

}

}

auth();

分别修改代码内的“账号”和“密码”即可。

设置好之后，访问测试一下，就已经有了要求登录的弹窗。

二、基础功能设置

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、打包下载功能

1）多文件选择设置，即复选框☑️

找到“select”，将false改为true，

"select": {

"enabled": true,

"clickndrag": true,

"checkboxes": true

},

2）下载设置

找到“download”，将false改为true，如果需要设置打包文件的格式为zip，则修改type的值为shell-zip。

"download": {

"enabled": true,

"type": "shell-zip",

"packageName": null,

"alwaysVisible": false

},

4、显示文件信息与二维码下载

找到"info"，将false改为true。H5ai可以通过扫码的方式下载文件，方便了手机及其他终端设备。

"info": {

"enabled": true,

"show": true,

"qrcode": true,

"qrFill": "#999",

"qrBack": "#fff"

},

打开后，网页右侧显示文件类型和二维码，手机扫码即可下载。

5、字体加速，替换google字体库

找到"resources"，替换http://fonts.googleapis.com为国内源，例如http://fonts.lug.ustc.edu.cn

"resources": {

"scripts": [],

"styles": [

"//http://fonts.lug.ustc.edu.cn/css?family=Ubuntu:300,400,700%7CUbuntu+Mono:400,700"

]

},

以上，基本上你就可以愉快的使用这款小而美的文件管理程序啦！