简介

H5ai，全称是 HTML5 Apache Index，是一款基于 HTML5 的目录列表程序，它不仅支持 Apache，还支持 Lighttpd、Nginx 和 Cherokee 等 WEB 服务器，H5ai 以其优雅的界面和实用性，成为了许多人搭建个人网盘的首选工具，本文将详细介绍如何在云服务器上安装 H5ai，并展示其强大的功能。

一、准备工作

在安装 H5ai 之前，您需要确保服务器具备以下条件：

1、操作系统：任何可以运行 PHP 的 Linux 发行版或 Windows 系统。

2、WEB 服务器：如 Apache、Nginx 等。

3、PHP 版本：要求 PHP 5.5+，并且需要启用scandir 函数。

4、其他依赖项：根据需要，可能需要安装 ImageMagick、ffmpeg 或 libav 等工具。

二、安装步骤

1. 安装环境依赖

以 Ubuntu 为例，首先更新软件包列表并安装必要的依赖项：

sudo apt-get update
sudo apt-get install apache2 php libapache2-mod-php php-cli php-curl php-gd php-mbstring php-xml php-zip

对于 Nginx 用户，可以使用以下命令安装 Nginx 和 PHP：

sudo apt-get install nginx php-fpm

2. 下载并配置 H5ai

下载最新版本的 H5ai 压缩包：

wget https://release.larsjung.de/h5ai/h5ai-0.30.0.zip
unzip h5ai-0.30.0.zip

将解压后的_h5ai 文件夹移动到您的网页根目录（例如/var/www/html/）：

sudo mv _h5ai /var/www/html/

编辑 Web 服务器配置文件（如 Apache 的httpd.conf 或 Nginx 的默认配置文件），添加以下内容以确保访问 H5ai：

对于 Apache：

<IfModule mod_dir.c>
    DirectoryIndex index.html index.htm index.php /_h5ai/public/index.php
</IfModule>

对于 Nginx：

location / {
    root /var/www/html;
    index index.html index.htm index.php /_h5ai/public/index.php;
}

保存后，重启 Web 服务器：

sudo systemctl restart apache2  # For Apache
sudo systemctl restart nginx    # For Nginx

3. 安装额外依赖项

如果需要预览图片、视频或音频文件，还需要安装额外的软件：

sudo apt-get install imagemagick ffmpeg zip unzip

对于使用 PHP-FPM 的用户，还需要确保启用了putenv 函数：

sudo nano /etc/php/7.4/fpm/php.ini

取消putenv 前的注释。

三、配置 H5ai

H5ai 的配置主要通过修改_h5ai/private/conf/options.json 文件完成，您可以根据需要调整以下参数：

语言设置：将"l10n" 中的"lang" 设置为"zh-cn"。

搜索功能：启用搜索功能，将"search" 中的"enabled" 设置为true。

打包下载：允许多文件打包下载，将"download" 中的"enabled" 设置为true，并将"type" 设置为"shell-zip"。

显示二维码：启用文件信息和二维码显示，将"info" 中的"enabled" 设置为true，并将"show" 和"qrcode" 设置为true。

四、完成安装与测试

完成上述步骤后，通过浏览器访问您的服务器域名或 IP 地址，即可看到 H5ai 的主界面，如果一切正常，您将看到一个简洁且功能强大的文件管理器界面。

五、总结

H5ai 是一个功能强大且易于使用的目录列表程序，适合作为个人网盘或文件管理系统，通过本文的介绍，您可以轻松地在云服务器上安装和配置 H5ai，无论是预览文件、搜索还是打包下载，H5ai 都能满足您的需求，希望这篇文章对您有所帮助，祝您使用愉快！