greyltc/h5ai

docker-h5ai 镜像文档

镜像概述

docker-h5ai 是一个在 Docker 容器中运行的 Web 服务器，集成了 h5ai 工具。h5ai 是一款增强型目录列表工具，能够为 Web 服务器提供美观的文件目录浏览界面、文件预览、搜索及排序等功能，适用于文件共享、文档托管等场景。

核心功能和特性

• 增强型目录浏览：提供现代化、美观的文件目录展示界面，支持多种视图模式
• 文件预览：支持常见文件类型（如图片、文本、PDF等）的在线预览
• 搜索与筛选：可快速搜索目录中的文件，并按名称、大小、修改时间等条件筛选
• Docker 化部署：封装为 Docker 镜像，简化部署流程，便于在不同环境中快速启动

使用场景和适用范围

• 个人文件共享：通过 Web 界面分享本地文件目录
• 项目文档托管：托管项目文档、资料，方便团队成员查看
• 本地文件管理：在本地环境中通过浏览器便捷管理文件
• 小型文件服务器：快速搭建轻量级文件服务，用于临时或小型团队使用

使用方法和配置说明

基本部署命令

可通过以下命令启动 docker-h5ai 容器（假设存在 run-docker-h5ai.sh 脚本）：

bash
./run-docker-h5ai.sh

手动部署示例

若需手动配置，可使用 docker run 命令：

bash
docker run -d \
  -p 80:80 \  # 映射容器80端口到主机80端口（可根据需要修改主机端口）
  -v /path/to/your/files:/var/www/html \  # 将本地文件目录挂载到容器Web根目录
  --name h5ai-server \  # 容器名称
  docker-h5ai  # 镜像名称

说明：

• /path/to/your/files 需替换为本地实际文件目录路径
• 访问 http://localhost（或主机IP）即可查看挂载目录的文件列表

配置说明

容器默认配置已优化 h5ai 功能，若需自定义 h5ai 配置（如主题、显示选项等），可通过挂载 h5ai 配置文件实现：

bash
docker run -d \
  -p 80:80 \
  -v /path/to/your/files:/var/www/html \
  -v /path/to/h5ai-config:/var/www/html/_h5ai/private/conf \  # 挂载自定义配置目录
  --name h5ai-server \
  docker-h5ai

h5ai 配置文件详细说明可参考 https://larsjung.de/h5ai/%E3%80%82