在当今信息化时代，文件管理和展示变得越来越重要，h5ai 是一个基于 HTML5 的文件索引和管理系统，支持多种 Web 服务器如 Apache、lighttpd、nginx 和 Cherokee，本文将详细介绍如何安装和配置 h5ai 文件服务器。

一、准备工作

1、安装Docker：确保你的系统已经安装了 Docker，如果没有安装，可以从 [Docker官网](https://www.docker.com/) 下载并安装适合你操作系统的版本。

2、创建数据文件夹：在你的系统中创建一个用于存放 h5ai 数据的文件夹，命令如下：

   mkdir -p /opt/docker/h5ai

二、拉取并运行 h5ai 镜像

1、拉取 h5ai 镜像：使用 Docker 拉取官方提供的 h5ai 镜像，打开终端并执行以下命令：

   docker pull ilemonrain/h5ai

2、运行 h5ai 容器：通过以下命令启动 h5ai 容器，并将本地数据文件夹挂载到容器中，此命令会将本地的/opt/docker/h5ai 目录挂载到容器的/h5ai 目录。

   docker run -d -p 80:80 -v /opt/docker/h5ai:/h5ai --name h5ai --restart=always ilemonrain/h5ai

这里我们将端口80 映射到容器的80 端口，因此你可以通过浏览器访问http://your_server_ip 来查看 h5ai 界面。

三、配置 h5ai

1、绑定域名（可选）：如果你有域名并希望使用它来访问 h5ai，可以在宝塔面板中添加一个新的站点，并绑定你的域名，记录下新站点的 MySQL 用户和密码。

2、下载并解压 h5ai 文件：在宝塔面板中进入对应的网站根目录，例如/www/wwwroot/你的域名，然后点击远程下载并输入以下 URL 来下载 h5ai 压缩包：

   https://release.larsjung.de/h5ai/h5ai-0.29.2.zip

下载完成后，解压该文件。

3、安装依赖和配置 PHP：访问你的域名/_h5ai/public/index.php 以查看依赖信息，如果左侧显示绿色或“yes”，则表示依赖已经安装成功，否则，根据提示安装缺少的依赖。

   yum -y install ImageMagick
   wget https://www.moerats.com/usr/down/ffmpeg/ffmpeg-git-64bit-static.tar.xz
   tar xvf ffmpeg-git-64bit-static.tar.xz
   mv ffmpeg-git-20180831-64bit-static/ffmpeg ffmpeg-git-20180831-64bit-static/ffprobe /usr/bin/

4、设置默认文档：进入宝塔面板，选择你的网站，点击设置，然后在默认文档中添加/_h5ai/public/index.php。

四、优化配置

1、修改配置文件：进入_h5ai/private/conf/options.json 文件进行一些优化配置，启用搜索功能：

   "search": {
       "enabled": true,
       "advanced": true,
       "debounceTime": 300,
       "ignorecase": true
   }

2、替换 Google 字体（可选）：由于网络问题，Google 字体可能导致加载缓慢，可以将其替换为国内的 CDN，编辑options.json 文件，找到字体配置项并进行替换：

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

3、多语言支持：h5ai 支持多语言，默认是英文，你可以修改options.json 文件中的语言配置，使默认语言变为中文：

   "l10n": {
       "enabled": true,
       "lang": "zh-cn",
       "useBrowserLang": true
   }

通过以上步骤，你已经成功安装并配置了 h5ai 文件服务器，这是一款功能强大且易于使用的 HTML5 文件索引工具，适用于多种 Web 服务器环境，无论是个人用户还是企业用户，都可以通过 h5ai 轻松管理和展示文件。