目录列表程序：h5ai 作者: Fmq 时间: 2019-03-27 分类: 随手笔记,搬运 h5ai是一款功能强大的php文件目录列表程序,它提供多种文件目录列表呈现方式,支持多种web服务器,支持多国语言（如英语,简体中文等）,你可以在线预览txt,图片,音频,视频等文件格式。 <!--more--> ## 功能 当前版本`0.29.2` ，支持功能： - 排序 - 查看模式 - 多国语言 - 访问足迹 - 文件夹树状图 - 自定义页眉+页脚 - 过滤器+搜索 - 文件夹大小 - 自动刷新 - 压缩打包下载 - 二维码 - 缩略图 - 图像+文本+音频+视频的预览 ## 安装 ### 1.搭建php网站环境 要求：PHP 5.5+ ,推荐宝塔面板，简单方便。 ### 2.上传h5ai文件到网站根目录 进入发布网站 https://larsjung.de/h5ai/ ，将最新的程序包下载到服务器上并解压。注意，**_h5ai文件夹要放在你需要共享的文件夹同目录下**。类似这样： 网站根目录 ├ _h5ai ├ 你要共享的文件 └ 你要共享文件夹 或者 网站根目录 └ 子目录xN ├ _h5ai ├ 你要共享的文件 └ 你要共享文件夹 然后访问 http://yourdomain.xxx/_h5ai/public/index.php 查看是否安装。 若把h5ai安装到子目录，那么上面的网址就要更改为子目录。 第一次登陆，密码为空。 #### 检测页面说明 1. h5ai version 检测源代码版本 2. Index file found 检测文件完整性（是否存在index.php） 3. Options parsable 检测设置是否正确，较重要 4. Types parsable 检测类型设置是否正确，较重要 5. Server software 检测服务器Web解析器是否支持，目前官方宣称支持4种：Nginx、Apache、Lighttpd、cherokee 6. PHP version 检测PHP版本，h5ai仅支持PHP 5.5及以后的版本 7. PHP arch 检测是x86还是x64，x86对显示文件的大小有限制，较重要 8. Public Cache directory 检测Cache目录是否可写 9. Private Cache directory 检测Cache目录是否可写 10. Image thumbs 检测是否支持JPEG图片预览，即检测PHP GD扩展是否安装 11. Use EXIF thumbs 检测是否支持EXIF信息（照片里面对拍摄参数的存储信息）读取，即检测PHP EXIF扩展是否安装 12. Movie thumbs 检测是否支持视频预览，即检测avconv或者ffmpeg是否安装 13. PDF thumbs 检测是否支持PDF预览，即检测convert或者gm是否安装 14. Shell tar 检测是否支持tar压缩，即检测tar命令是否安装 15. Shell zip 检测是否支持zip压缩，即检测zip命令是否安装 16. Shell du 检测是否支持文件大小查看，即检测du命令是否安装 ### 3.修改网站配置文件 将 `/_h5ai/public/index.php` 添加到默认主页里面，比如： Apache httpd ：`httpd.conf` DirectoryIndex index.html index.php /_h5ai/public/index.php lighttpd ：`lighttpd.conf` index-file.names += ("index.html", "index.php", "/_h5ai/public/index.php") nginx ：`nginx.conf` index index.html index.php /_h5ai/public/index.php; ### 4.安装依赖 如果存在文件读不出来的情况，可能原因就是php已禁用 `scandir` 函数了，请修改php.ini解决。 disable_functions=passthru,exec,system,chroot,scandir,... 删掉scandir,字样，再重启php即可：/etc/init.d/php-fpm restart。 宝塔默认启用该函数。 另外，h5ai使用 `exec` 和 `passthru` 函数是为了实现打包下载和获取文件使用空间，如不需要应该要禁用这两个高危函数。 ### 5.配置参数 用编辑器编辑 `_h5ai/private/conf/options.json` ```json /* h5ai v0.29.1 - https://larsjung.de/h5ai/ */ { /* 密码的SHA512，预设值为空 Online hash generator: http://md5hashing.net/hashing/sha512 */ "passhash": "cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af927da3e", /* 资源 附加于所有页面的脚本和CSS等，路径不要使用http协议头开头，可以相对于h5ai安装目录_h5ai/public/ext/（不检查是否存在） 修改字体库，提高访问速度 - scripts：字符串数组 - styles：字符串数组 */ "resources": { "scripts": [], "styles": [ "//fonts.geekzu.org/css?family=Ubuntu:300,400,700%7CUbuntu+Mono:400,700" ] }, /* 一般视图选项。 - binaryPrefix：布尔值，设置为true在格式化文件大小时使用KiB而不是KB（参阅http://en.wikipedia.org/wiki/Binary_prefix） - disableSidebar：布尔值，隐藏边栏和切换按钮 - fallbackMode：布尔型，服务于后备模式 - fastBrowsing：布尔型，使用History API（如果可用）（无需重新加载整个页面） - fonts：字符串数组，常规上下文中使用的字体 - fontsMono：字符串数组，在monopspace化的上下文中使用的字体 - hidden：字符串数组，不要列出匹配这些正则表达式匹配的项目 - hideFolders：布尔值，隐藏主视图中的所有文件夹 - hideIf403：布尔值，隐藏服务器无法读取的文件和文件夹 - hideParentFolder：布尔值，在主视图中隐藏父文件夹链接 - maxIconSize：数字，主视图中图标的最大尺寸 - modes：字符串数组，[“细节”，“网格”，“图标”的子集]，第一个值表示默认视图模式。如果只有一个值，给出的视图模式是固定的，并且选择器按钮被隐藏。用户选择的视图模式也保存在现代浏览器的本地，所以它会保存好长时间。 - modeToggle：布尔值，在工具栏中显示视图模式切换，或“next” - setParentFolderLabels：布尔值，将父文件夹标签设置为实际文件夹名称 - sizes：数组数组 第一个值表示默认视图大小。如果只有一个值，给出的视图大小是固定的，并且选择器按钮被隐藏。用户选择的视图大小也存储在现代浏览器的本地所以它会保存很长时间。 - theme：字符串，“_h5ai/images/themes”中文件夹的名称之一，默认为“Normal” - unmanaged：字符串数组，不要显示包含某个文件（名）的文件夹 - unmanagedInNewWindow：布尔值，在新窗口/选项卡中打开非托管链接 */ "view": { "binaryPrefix": false, "disableSidebar": false, "fallbackMode": false, "fastBrowsing": true, "fonts": ["Ubuntu", "Roboto", "Helvetica", "Arial", "sans-serif"], "fontsMono": ["Ubuntu Mono", "Monaco", "Lucida Sans Typewriter", "monospace"], "hidden": ["^\\.", "^_h5ai"], "hideFolders": false, "hideIf403": true, "hideParentFolder": false, "maxIconSize": 40, "modes": ["details", "grid", "icons"], "modeToggle": false, "setParentFolderLabels": true, "sizes": [20, 40, 60, 80, 100, 140, 180, 220, 260, 300], "theme": "comity", "unmanaged": ["index.html", "index.htm", "index.php"], "unmanagedInNewWindow": false }, /***扩展（按字母顺序）***/ /* 监视并更新当前文件夹内容。 - interval：数值，更新时间间隔，以毫秒为单位，至少1000，默认5秒 */ "autorefresh": { "enabled": false, "interval": 5000 }, /* 显示可点击的文件目录树状图 */ "crumb": { "enabled": true }, /* 允许自定义页眉和页脚文件。 首先检查当前目录中的文件“_h5ai.header.html”和“_h5ai.footer.html”。如果不成功，它会检查所有父目录（从当前目录开始）文件“_h5ai.headers.html”和“_h5ai.footer.html”。 注意不同的文件名：“header”（仅当前） - “headers”（当前和子目录）！ header和footer必须同时存在，且文件名一致才起作用 该文件的内容将放置在主目录上方/下方的div标签内。 如果文件的扩展名是“.md”而不是“.html”，则其内容将以Markdown解释。 */ "custom": { "enabled": true }, /* 启用所选条目的打包下载。 要选择文件，需要启用“select”扩展（在本设置下面）。 - type：字符串，“php-tar”，“shell-tar”或“shell-zip” - packageName：字符串，下载包的基本名，当前文件名或文件夹名为空 - alwaysVisible：布尔值，始终显示下载按钮（默认为下载当前文件夹） */ "download": { "enabled": false, "type": "php-tar", "packageName": null, "alwaysVisible": false }, /* 允许过滤当前文件夹中显示的文件和文件夹。 也检查子字符串。如果启用了高级功能，它将检查条目的顺序，即“ab”匹配“ab”，“axb”，“xaxbx”而不是“ba”。 空间分离序列得到OR-ed。 如果你用“re：”作为前缀搜索将被视为JavaScript常规表达式。 - advanced：布尔值，使用高级模式解析 - debounceTime：数字，防止等待时间以毫秒为单位 - ignorecase：布尔值，忽略大小写 */ "filter": { "enabled": false, "advanced": true, "debounceTime": 100, "ignorecase": true }, /* 计算文件夹的大小。 这个操作很慢。两者的计算尺寸略有不同。类型若是“php”仅添加文件大小，“shell-du”还会添加实际文件夹文件的大小。 */ "foldersize": { "enabled": false, "type": "php" }, /* Google Analytics - id: 字符串 */ "google-analytics-ua": { "enabled": false, "id": "UA-000000-0" }, /* 启用通用信息栏。 - show：布尔 - qrcode：布尔值，显示二维码 - qrColor：字符串，二维码填充颜色 */ "info": { "enabled": false, "show": false, "qrcode": true, "qrFill": "#999", "qrBack": "#fff" }, /* 本地化，例如“en”，“de”等 - 请参阅“_h5ai / conf / l10n”文件夹可能的值。根据您的需求进行调整。默认为“en”。 - lang：字符串，默认语言 - useBroserLang：布尔型，尝试使用浏览器语言 */ "l10n": { "enabled": true, "lang": "en", "useBrowserLang": true }, /* 添加Piwik跟踪器JavaScript代码。 - baseURL：字符串，不包括协议，例如“mydomain.tld/ piwik” - idSite：号码 */ "piwik-analytics": { "enabled": false, "baseURL": "some/url", "idSite": 1 }, /* 点击播放音频预览。 - autoplay - types：字符串数组 */ "preview-aud": { "enabled": true, "autoplay": true, "types": ["aud"] }, /* 单击时显示图像预览。 - types：字符串数组 - size：数量，样本量或原始尺寸为false */ "preview-img": { "enabled": true, "size": false, "types": ["img", "img-bmp", "img-gif", "img-ico", "img-jpg", "img-png", "img-raw", "img-svg"] }, /* 单击时显示文本文件预览。 可用的样式是： 0：浮动文字 1：固定宽度文本 2：markdown 3：语法高亮 - styles：将字符串转换为int，将类型映射到样式 */ "preview-txt": { "enabled": true, "styles": { "txt": 1, "txt-authors": 1, "txt-c": 3, "txt-cpp": 3, "txt-css": 3, "txt-diff": 1, "txt-go": 3, "txt-h": 3, "txt-hpp": 3, "txt-install": 1, "txt-js": 3, "txt-json": 3, "txt-less": 3, "txt-license": 1, "txt-log": 1, "txt-makefile": 1, "txt-md": 2, "txt-py": 3, "txt-rb": 3, "txt-readme": 1, "txt-rtf": 1, "txt-rust": 3, "txt-script": 3, "txt-xml": 1 } }, /* 点击播放视频预览。 - autoplay - types：字符串数组 */ "preview-vid": { "enabled": true, "autoplay": true, "types": ["vid-avi", "vid-flv", "vid-mkv", "vid-mov", "vid-mp4", "vid-mpg", "vid-webm"] }, /* 允许在当前文件夹内和下面搜索文件和文件夹。 检查子字符串。 如果启用了高级功能，它将检查条目的正确顺序，即“ab”匹配“ab”，“axb”，“xaxbx”而不是“ba”。 空间分离序列得到OR-ed。如果你用“re：”作为前缀搜索将被视为JavaScript常规表达式。 - advanced：布尔值，使用高级模式解析 - debounceTime：数字，防止等待时间以毫秒为单位 - ignorecase：布尔值，忽略大小写 */ "search": { "enabled": false, "advanced": true, "debounceTime": 300, "ignorecase": true }, /* 使条目可选。 目前只用来打包下载。 - clickndrag：布尔值，允许左键拖动选择 - checkboxes：布尔值，显示鼠标悬停在项目上的复选框 */ "select": { "enabled": false, "clickndrag": true, "checkboxes": true }, /* 默认排序顺序。 “column”和“reverse”在本地存储。 - column：编号，0代表“名称”，1代表“日期”，2代表“大小” - reverse：布尔型，false为升序，true为降序 - ignorecase：布尔型，忽略大小写 - natural：布尔值，使用自然排序顺序 - folders：数字，放置文件夹的位置，0代表“顶部”，1代表“就地”，2代表“底部” */ "sort": { "enabled": true, "column": 0, "reverse": false, "ignorecase": true, "natural": true, "folders": 0 }, /* 显示图像文件的缩略图。需要“/_h5ai/cache”文件夹 可写入Web服务器。 - img：字符串数组 - mov：字符串数组 - doc：字符串数组 - delay：数字，延迟“dom-ready”之后的毫秒，然后开始处理缩略图请求 - size：数值，生成的缩略图像素大小 - exif：布尔值，如果可能的话，使用包含EXIF的缩略图 - chunksize：整数，每个请求的缩略图数 */ "thumbnails": { "enabled": true, "img": ["img-bmp", "img-gif", "img-ico", "img-jpg", "img-png"], "mov": ["vid-avi", "vid-flv", "vid-mkv", "vid-mov", "vid-mp4", "vid-mpg", "vid-webm"], "doc": ["x-pdf", "x-ps"], "delay": 1, "size": 240, "exif": false, "chunksize": 20 }, /* 用当前的缩略图名称替换窗口标题。 */ "title": { "enabled": true }, /* 显示文件夹树。 请注意，这可能会影响性能。 - show：布尔，首次可见的初次用户 - maxSubfolders：数字，树中显示的最大子文件夹数 - naturalSort：布尔值，对文件夹使用自然排序顺序 - ignorecase：布尔值，排序忽略大小写 */ "tree": { "enabled": true, "show": true, "maxSubfolders": 50, "naturalSort": true, "ignorecase": true } } ``` 重启服务器，完成安装。 ## 开启更多功能 ### 1.安装FFmpeg 打开 `/etc/apt/sources.list` 添加软件源 ```bash 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 ``` 更新软件源 `apt-get -y update` 安装 ffmpeg `apt-get -y install ffmpeg` ### 2.略缩图功能 将_h5ai中，private与public文件夹中的cache目录设置权限为755。 同时在宝塔面板PHP扩展里找到 `ImageMagick` 和 `exif` 进行安装即可。 ### 3.Shell tar、Shell zip和Shell du 去除在 php.ini 中被禁用函数 `exec`与 `passthru` 即可。 ### 4.给H5ai加密码 首先找到这个文件_h5ai/public/index.php,在最下面增加以下代码 ```php function mima(){ $user=array('填写你的用户名','填写你的密码'); if(!($user[0]===$_SERVER['PHP_AUTH_USER'] && $user[1]===$_SERVER['PHP_AUTH_PW'])){ header('WWW-Authenticate: Basic realm="realm"'); header('HTTP/1.0 401 Unauthorized'); die("please login"); } } ``` 然后在第一行，也就是<?php的下面（也就是第二行）插入以下代码： ```php mima(); ``` ## 总结 操作简单，界面冷淡，适合懒人。 标签: nginx, php, h5ai
感觉你dl站比我4k.orz.us加载快多了
都是h5ai