手上有一台 VPS 或者 NAS,想把目录里那堆文件直接挂到浏览器上给人下载,最省事的做法不是装网盘,而是装一个目录列表程序:它把服务器上的文件夹变成网页,谁有链接谁就能点开下载。这件事看着简单,实际有三种深度——只列文件名、能预览缩略图、以及干脆就是一套网盘。

这篇对比三款常被放在一起讨论的程序:Directory Lister、h5ai、FileRun。底子是挖站否 2017 年那篇对比文章,但那篇里的 PHP 版本要求(5.3 / 5.5)早就过时了,h5ai 的官网也已经改成跳转到 GitHub。所以下面的内容按 2026 年 11 月的现状重新核对过,事实以各项目官网和仓库为准,原文章的观点保留在「怎么选」那一节。

一、Directory Lister:把「列个文件」做到极简

Directory Lister 官方演示站:文件名、大小、修改时间三列,底部直接预览 Markdown

解压、上传、把 resources/default.config.php 改名为 config.php,打开浏览器就能看到目录——这是它全部的安装流程,不需要数据库,也不需要配置什么伪静态。当前版本 5.8.3,MIT 协议,GitHub 上约 2500 星,2026 年 11 月还有提交。

界面就是最朴素的三列:文件名、大小、修改时间,顶部一个搜索框,文件夹和文件都有图标。它的「多一点」体现在两处:一是支持换主题(resources/themes/ 下的 bootstrap 主题可以直接改 CSS),二是底部会内联预览选中的文件——演示站里点开 README.md,Markdown 直接渲染出来了。这一点比「只能下载」强不少。

它不适合的场景也很明确:没有用户体系,权限完全靠 Web 服务器(目录密码、IP 限制、或者干脆不公开);没有缩略图;文件多了以后只有一个搜索框,没有分类导航。

二、h5ai:给目录加上缩略图和在线播放

h5ai 的思路是「还是目录列表,但让人愿意多看两眼」。它同样是纯 PHP、不需要数据库,支持 Apache、lighttpd、nginx,装法是往站点根目录放一个 _h5ai 文件夹,再把 /_h5ai/public/index.php 加进默认首页列表。

它比 Directory Lister 多的能力包括:图片缩略图、PDF 与文本在线查看、音视频直接在浏览器里播放、面包屑与分类导航、多种视图切换。代价是依赖一堆外部组件:缩略图需要 PHP 的 exif 模块、ffmpeg、ImageMagick;少一个,图片就退化成文件名。

版本状态值得说明:GitHub 上 lrsjng/h5ai 有 6000 多星,最新版 v0.30.0 发布于 2024 年 11 月,仓库没有归档但也没有 LICENSE 文件;作者原来的官网 larsjung.de/h5ai 现在会 302 跳到 GitHub 仓库,官网上的在线演示已经下线(访问 404)。也就是说它还在,但已经从「有主页有演示的产品」退化成「一个仓库」。

三、FileRun:其实是网盘,只是入口长得像目录列表

FileRun 官方界面截图:左侧目录树、文件网格与缩略图、右侧详情与共享面板

FileRun 的定位和前两个不在一个层面。它要 MySQL、要一整套 PHP 扩展(PDO MySQL、ionCube loader、mcrypt、openssl、gd、mbstring、exif、xml、zlib),还要 ImageMagick 或 GraphicsMagick 做图片处理、ffmpeg 做视频缩略图。装完之后得到的是一个正经网盘:账号体系、群组权限、分享链接、在线预览与编辑 Office 文档、回收站、手机 App 同步。

它是商业软件,但定价方式比较友好:官网当前的家庭版是一次性 €99,5 个用户、功能不阉割、终身免费更新(每年还多送一个账号);商用按用户数按年订阅,另有免费试用。也就是说它不适合「我就想挂个下载目录」的需求,但对「想给自己和小团队一个不依赖第三方的文件中心」的人来说,价格比订阅制网盘便宜得多。

四、横向对比

三款目录程序横向对比信息图:定位、数据库、PHP 版本、预览能力、用户体系、许可与维护状态

对比项Directory Listerh5aiFileRun
本质目录列表目录列表 + 预览网盘系统
数据库不需要不需要必须 MySQL
安装复杂度上传改个文件名即可放目录 + 改首页配置跑安装向导、配扩展
缩略图无有,依赖 ffmpeg / ImageMagick有,依赖同左
在线播放音视频无有有
用户与权限无无(可设访问密码)完整账号、群组、分享
手机 App无无有
许可MIT,免费开源,未标标准许可商业授权,家庭版 €99 买断
维护活跃(2026-11 有提交)v0.30(2024-11)商业项目,持续更新

五、安装时真正会卡住的地方

Directory Lister:唯一的坑是忘了改名 config.php,不改就白屏或者报错。另外新版要求 PHP 8.x,老机器上如果是 7.4 得先升级;想改外观去主题目录改 CSS,别直接动核心文件,不然升级会覆盖。

h5ai:最常见的问题是「装完了但缩略图不出来」,原因基本是缺 ffmpeg 或 ImageMagick;其次是权限——private 与 public 两个目录下的 cache 需要可写;还有一类是主机禁用了 scandir、exec、passthru 这类函数,会导致列表或缩略图异常。默认配置无密码,启用前记得改 _h5ai/private/conf/options.json 里的访问密码,否则等于把整个目录公开。

FileRun:扩展不齐会直接卡在检测页;ionCube loader 是最容易被漏掉的一项,很多面板默认不带。缩略图需要在设置里填 ImageMagick、pngquant、ffmpeg 的路径并点「检测」,不知道路径就用 find 命令找一下。数据库要单独建库建用户,装完记得先在控制台把语言改成中文、调整邮件发送配置。

六、怎么选:按你要解决的问题,而不是按功能多少

如果你只是想让别人下载几个文件——给客户发个安装包、给自己存点资料——Directory Lister 就够,两分钟装完,坏处是页面朴素、没有缩略图。

如果你要一个好看的展示型目录——放摄影作品、放几十期播客、放一堆 PDF——h5ai 更合适,缩略图和在线播放是决定性的差异。但要接受它的维护节奏变慢这件事,以及缩略图对服务器组件的依赖。

如果你要的是网盘——多人使用、要权限、要分享链接、要手机同步——那前两个都不该考虑,直接上 FileRun。它贵在「一次性买断」而不是订阅,但也要接受它是闭源商业软件、依赖 ionCube 这个事实。

最后提一句时效:这类程序的技术门槛一直在降,而「要不要数据库」「要不要用户体系」这两条分界线一直没变。先把这两条想清楚,比对比谁的界面好看有用得多。


本文基于挖站否《三款优秀的在线文件管理器(目录列表)对比》一文重写并做时效性核对,事实来源包括:Directory Lister 官网与 GitHub 仓库(当前版本 5.8.3、MIT 协议、README 安装步骤)、其官方演示站 demo.directorylister.com 的实际界面、h5ai 的 GitHub 仓库与 Releases(v0.30.0,2024-11)以及原官网跳转状态、FileRun 官网与定价页(家庭版 €99 / 5 用户买断、商用按用户年付、所需 PHP 扩展清单)。版本与价格数据截至 2026 年 11 月,具体以各官方页面为准。配图两张分别取自 Directory Lister 官方演示站与 FileRun 官网截图(仅统一格式、去元数据与压缩,未改动像素),一张为按上述来源自绘的对比信息图。原文中的演示地址、 affiliate 链接、打赏与站点推广内容均未收录;文中价格仅作事实说明,不构成购买建议。

本文整理自公开资料并做重写,原始出处:https://wzfou.com/directory-lister/。文中配图已去除站点叠加水印与推广信息;版权归原作者所有。

Last modification:November 11, 2026
如果觉得我的文章对你有用,请随意赞赏