pad92/docker-h5ai

h5ai-base

基于h5ai项目的Docker镜像，提供文件目录的Web索引服务，支持Intel和armhf架构。

镜像概述和主要用途

h5ai-base是一个轻量级Docker镜像，封装了h5ai文件目录索引工具，可将指定目录以美观的Web界面形式展示，支持文件预览、搜索、排序等功能。适用于个人文件共享、服务器文件索引、局域网文件浏览等场景，无需复杂配置即可快速部署。

核心功能和特性

• 多架构支持：兼容Intel和armhf架构，可在多种设备上运行
• Web界面：提供现代化、响应式的文件浏览界面
• 文件管理：支持文件预览、搜索、排序、下载等功能
• 易于部署：通过简单的Docker命令即可快速启动
• 可自定义配置：支持挂载自定义配置文件，调整界面和功能参数

使用场景和适用范围

• 个人文件共享服务器
• 本地开发环境的资源文件索引
• 家庭局域网内的文件共享
• 小型团队的文档资源库
• 临时文件展示与分享

使用方法和配置说明

基本使用

通过以下命令快速启动h5ai服务，将本地目录挂载为共享目录：

bash
docker container run -it -p 80:80 \
  -v $PWD/sharing-file:/share \
  pad92/docker-h5ai

• -p 80:80：将容器的80端口映射到主机的80端口
• -v $PWD/sharing-file:/share：将本地当前目录下的sharing-file文件夹挂载到容器内的/share目录（此目录为h5ai默认索引目录）

启动后，访问http://localhost即可看到文件目录的Web界面。

自定义h5ai配置

h5ai的配置文件options.json位于容器内的/usr/share/h5ai/_h5ai/private/conf/options.json。如需自定义配置，可通过挂载本地配置文件覆盖默认配置：

bash
docker container run -it -p 80:80 \
  -v $PWD/sharing-file:/share \
  -v $PWD/options.json:/usr/share/h5ai/_h5ai/private/conf/options.json \
  pad92/docker-h5ai

配置文件可从https://raw.githubusercontent.com/lrsjng/h5ai/v0.29.0/src/_h5ai/private/conf/options.json%E8%8E%B7%E5%8F%96%E5%B9%B6%E4%BF%AE%E6%94%B9%EF%BC%8C%E6%94%AF%E6%8C%81%E8%87%AA%E5%AE%9A%E4%B9%89%E7%95%8C%E9%9D%A2%E4%B8%BB%E9%A2%98%E3%80%81%E6%98%BE%E7%A4%BA%E9%A1%B9%E3%80%81%E6%8E%92%E5%BA%8F%E6%96%B9%E5%BC%8F%E7%AD%89%E5%8F%82%E6%95%B0%E3%80%82