bin20088/h5ai Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

docker-h5ai

![]([] ![]([]

![]([] ![]([] ![]([***]

镜像概述和主要用途

h5ai是一个现代的HTTP Web服务器文件索引器，专注于文件展示。它以美观的方式显示目录，并通过不同视图、面包屑导航和树形概览增强浏览体验。本Docker镜像基于Alpine Linux构建，集成Nginx、PHP和h5ai，旨在为使用Docker构建服务器的用户提供轻量级、功能完善的文件共享解决方案。

核心功能和特性

基础组件

采用Alpine Linux作为基础镜像以实现轻量级服务，并选择Nginx-Alpine版本以利用Nginx的优化配置。主要组件包括：

• Alpine Linux 3.18
• Nginx 1.25.3
• PHP 8.2
• h5ai 0.30.0

通过supervisor管理所有进程，确保组件协同工作。

全功能支持

!功能展示 h5ai支持扩展功能，如音视频缩略图显示、缓存优化等，本镜像已激活所有这些功能。

PHP 8 JIT编译启用

!JIT启用 默认启用PHP 8引入的JIT编译器，提升性能。

多架构支持

通过GitHub Actions构建，支持amd64、arm/v6、arm/v7、arm64、ppc64le、s390x等多种架构，可在大多数支持Docker的设备上使用。

使用场景和适用范围

• 个人文件共享服务器
• 团队内部文档管理
• 本地网络文件浏览
• 轻量级Web文件索引服务

使用方法和配置说明

前提条件

需在系统上安装Docker。

拉取镜像

使用以下命令从Docker Hub拉取镜像：

bash
docker pull bin20088/h5ai

基本用法

临时运行（示例）

bash
docker run -it --rm \
-p 80:80 \
-v /shared/dir:/h5ai \
-v /config/dir:/config \
-e PUID=$UID \
-e PGID=$GID \
-e TZ=Asia/Shanghai \
bin20088/h5ai

--rm选项会在容器退出后自动删除容器，适用于测试。

关键映射目录

• /h5ai：共享文件存放目录，需映射到主机目录
• /config：h5ai配置和Nginx设置存储目录，需映射到主机目录

环境变量说明

• PUID：运行服务的用户ID，默认911
• PGID：运行服务的用户组ID，默认911
• TZ：时区设置，如Asia/Shanghai
• HTPASSWD：是否启用身份验证，设为true启用
• HTPASSWD_USER：身份验证用户名
• HTPASSWD_PW：身份验证密码（可选，若不设置需在交互模式下设置）

后台运行

bash
docker run -d --name=h5ai \
-p 80:80 \
-v /shared/dir:/h5ai \
-v /config/dir:/config \
-e PUID=$UID \
-e PGID=$GID \
-e TZ=Asia/Shanghai \
bin20088/h5ai

开机自启

bash
docker run -d --name=h5ai \
-p 80:80 \
-v /shared/dir:/h5ai \
-v /config/dir:/config \
-e PUID=$UID \
-e PGID=$GID \
-e TZ=Asia/Shanghai \
--restart unless-stopped \
bin20088/h5ai

启用身份验证

添加身份验证以防止***访问：

bash
docker run -it --name=h5ai \
-p 80:80 \
-v /shared/dir:/h5ai \
-v /config/dir:/config \
-e PUID=$UID \
-e PGID=$GID \
-e TZ=Asia/Shanghai \
-e HTPASSWD=true \
-e HTPASSWD_USER=admin \
bin20088/h5ai

首次运行需添加-it进入交互模式设置密码。若通过HTPASSWD_PW指定密码，则无需交互模式：

bash
docker run -d --name=h5ai \
-p 80:80 \
-v /shared/dir:/h5ai \
-v /config/dir:/config \
-e PUID=$UID \
-e PGID=$GID \
-e TZ=Asia/Shanghai \
-e HTPASSWD=true \
-e HTPASSWD_USER=admin \
-e HTPASSWD_PW=admin \
--restart unless-stopped \
bin20088/h5ai

访问服务

容器运行后，通过浏览器访问：

http
http://localhost/

!示例文件展示 即可查看共享的目录和文件。

更新注意事项

当h5ai新版本发布时，镜像会覆盖对应目录的更新文件，可能替换用户自定义文件。因此强烈建议在更新前备份自定义配置。

init.sh脚本会检查private/conf/options.json是否过时，若过时会在/config目录下创建备份，但不会备份所有h5ai相关文件，需用户自行注意。

使用HTTPS（SSL）

为确保数据安全，强烈建议通过HTTPS运行服务。本镜像未包含HTTPS配置，可通过反向代理实现，推荐使用LinuxServer.io的SWAG镜像。

待办事项

• 简化options.json访问
• 通过htpasswd实现访问权限控制
• 支持PUID/PGID设置以优化权限管理
• 将Nginx、PHP日志文件暴露到主机