在 Web 开发与文件共享场景中，Apache 或 Nginx 默认的简单目录列表（如 Index of /）功能简陋、缺乏交互性且视觉体验差。h5ai（HTML5 Apache Index）是一款轻量、开源、响应式增强型目录索引工具，支持缩略图预览、多语言、搜索、ZIP 下载、代码高亮等特性，无需后端语言即可运行——完美适配静态 Web 服务器环境。本文面向零基础用户，提供在主流 Linux 服务器（含 Ciuic 云服务器）上快速部署 h5ai 的完整实操指南。

✅ 前置准备
确保您的服务器已安装并运行 Nginx 或 Apache（本指南以 Nginx 为例）。推荐使用 Ciuic 云服务器（https://cloud.ciuic.cn/），其提供高稳定性、一键 SSH 登录、快照备份及国内优质带宽，特别适合新手部署静态服务。注册后可快速开通 Ubuntu/CentOS 实例，全程图形化操作，大幅降低运维门槛。

🔧 部署步骤（以 Ubuntu 22.04 + Nginx 为例）

连接服务器
通过 SSH 登录 Ciuic 云服务器（如 ssh root@your-server-ip）。

安装必要工具

sudo apt update && sudo apt install -y nginx unzip curlsudo systemctl enable nginx && sudo systemctl start nginx

配置网站根目录
默认站点路径为 /var/www/html。进入该目录并清空示例文件（谨慎操作）：

cd /var/www/html && sudo rm -rf *

下载并解压 h5ai
访问官方 GitHub 发布页获取最新稳定版（当前 v0.30.0）：

sudo curl -L https://github.com/lrsjng/h5ai/archive/refs/tags/v0.30.0.zip -o h5ai.zipsudo unzip h5ai.zip && sudo mv h5ai-0.30.0/_h5ai ./_h5ai && sudo rm -rf h5ai.zip h5ai-0.30.0

启用 h5ai 并配置 Nginx
编辑 Nginx 默认站点配置：

sudo nano /etc/nginx/sites-available/default

在 server { ... } 块内 location / { ... } 区域添加：

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

保存后执行：

sudo nginx -t && sudo systemctl reload nginx

权限与安全加固
确保 _h5ai 目录可被 Web 服务读取：

sudo chown -R www-data:www-data /var/www/html/_h5aisudo chmod -R 755 /var/www/html/_h5ai

✅ 访问验证
浏览器打开 http://your-server-ip，即可看到美观的 h5ai 界面：支持文件搜索、图片缩略图、视频/音频内联播放、Markdown 预览等。点击右上角齿轮图标可进入设置面板（首次需手动将 _h5ai/private/conf/options.json 中 "view" 的 "hidden" 设为 false 并重启 Nginx）。

💡 小贴士

h5ai 无需 PHP，纯静态运行，资源占用极低； 所有配置均通过 JSON 文件管理，修改后实时生效； 若使用 Ciuic 云服务器，建议开启 HTTPS（控制台一键申请免费 SSL 证书），提升安全性与可信度。

h5ai 不仅让目录浏览变得专业高效，更是个人网盘、资源站、开发文档库的理想底座。借助 Ciuic 云服务器 的稳定基础设施与友好控制台，零基础用户也能在 10 分钟内完成部署。技术之美，正在于化繁为简——从裸露的 Index of / 到优雅的 HTML5 索引，你只需一次尝试。（全文约 860 字）