Xdir是一款源于 Directory Lister，基于2.7.1原版内核，使用PHP开发的目录列表程序，由笔者魔改、优化后的Xdir版本。这是一个非常简单即优秀的目录列表程序，体积小巧，功能丰富强大，界面精致友好，简单实用，上传即用无需数据库，纯保姆级全局调配部署运行。
程序后端采用基于Tiny File Manager的管理方式，功能丰富，界面友好，支持像操作本地文件一样具备上传下载、URL上传、多用户账号/密码权限设置、在线编辑、预览、解压、压缩、创建、移动、粘贴、移动、删除、重命名等常规操作，并支持简单的离线下载功能，在线搜索和筛选，支持全局配置文件中隐藏指定文件及文件夹。
最新版 Xdir v1.4.0 20230519 正式版本程序最大程度上满足了功能上的刚需使用，新增功能最大化提升了整体的使用感知、便捷，大幅度提升了本地中文化、体验感较好、功能较全的一款Xdir版本，保留了Directory Lister原版内核，优化细节并整体提升和调优了程序的运行速度，全新UI美化，下面是魔改前后的对照及Xdir V1.4.0版本中的具体功能介绍。
使用说明
- 下载Xdir源码放到站点并解压全部文件至站点指定的Web根目录（有条件的，建议目录尽量放到大一点的储存空间中，方便日后大文件存放）；
- 首先需要将Xdir目录下的文件“config.simple.php”修改为 “config.php” 并检查是否可以正常访问Xdir主页，这一步很重要噢；
config.php文件为Xdir站点全局统一参数配置部署文件，推荐使用类似Notepad++、EditPlus、DW工具来进行调配；- 程序做了优化，化繁为简，核心配置统一接口对接，纯保姆式级别全局调配，大大降低并简化非专业人员的代码性繁琐修改；
- 需对Xdir站点根目录权限进行预设，赋予目录
\functions\caches读写删权限（Linux / Centos / Ubuntu 等系统下如无http用户，则增加一个，授予读写删权限）; - 支持
Windows / Linux / Centos / Ubuntu等系统下部署安装（傻瓜式部署环境建议通过类似面板的方式，有能力的还是建议采用更为专业的环境部署方案）； - 程序运行核心组件采用PHP内核，建议PHP版本为5.6 – 7.2版本之间为好，官方采取的是PHP 7.4版本，暂不支持更高版本下部署运行，因为笔者未尝试过；
config.php支持自定义网站标题/关键词/描述/logo/尾部运行起始时间/密码/功能唤醒/忽略目录及文件/简介说明解析方式等，化繁为简，纯保姆级调配；- 排除首页遍历列表下某个目录或文件，请于路径/resources/config.php中调整屏蔽；
- 排除文件管理器后端列表下不显示某个目录或文件，请于根目录路径/config.php中调整屏蔽；
- 文件索引页面支持通过”功能键盘快捷方式
“Ctrl + F”，找文件也是分分钟的事情噢。 - 当Xdir遍历目录列表下出现
.html / .md文件后缀时，程序则自动判断并显示该文件在遍历目录列表下输出预览，无README文件时则不显示简介功能展示； - 赞助版
（同演示站全线功能一致） - 清爽版
（除无维护模式外同赞助版全线功能一致） - 标准版
（除无暗黑明亮、无维护模式功能外，其余功能保持不变） - 清爽版、标准版后台管理无Guest只读用户权限启用，可自行调整或有偿支持调整；
- 若开启密码访问方式，修移步至文件“Xdir\resources\themes\bootstrap\index.php”、“gengxin.php”中搜索“访问密码”可修改默认密码参数值；
- 统一配置文件中thedir值，请务必修改为站点实际目录路径，如:/wwwroot/demo.xuxiaokun.com，不修改则无法登陆文件管理器后台；
- 本程序适合个人、初创期单位做网盘，轻需求的你，必备工具的多场景下适用。
更新日志
问题反馈请移步至：问答社区Xdir用户及问题反馈
文件结构
假设你的主机是/home/wwwroot/Xdir v1.4.0
/home/wwwroot/Xdir v1.4.0
│
├─ functions
│ ├ caches
│ │ └ indexes.html # 索引文件 #
│ │ └ css
│ │ └ dropzone.min.css # 自定义样式 #
│ │ └ js
│ │ └ dropzone.min.js # JavaScript脚本文件 #
│ │ └ .....
├─ resources
│ ├ jianzhanshi
│ │ └ .....
│ ├ Top
│ │ └ .....
│ ├ themes
│ │ └ bootstrap
│ ├ └ css # 样式文件夹 #
│ ├ └ fonts
│ ├ └ img
│ ├ └ js # JavaScript脚本文件夹 #
│ ├ └ less
│ ├ └ scss
│ ├ └ default_bulletin.php # 顶部公告栏内容 #
│ ├ └ default_footer.php # 底部公共文件 #
│ ├ └ default_header.php # 顶部公共文件（可放网站流量统计代码）#
│ ├ └ index.php # 站点主文件 #
│ ├ DirectoryLister.php # 核心函数处理文件 #
│ ├ config.php # 基础配置文件 #
│ └ fileTypes.php # 遍历图标控制器 #
│ └ Parsedown.php # Markdown解析器 #
│ └ ParsedownExtra.php # 可配置的Markdown到HTML转换器 #
│ └ ParsedownExtraPlugin.php # Markdown扩展插件 #
├─ static
├─ └ ..... # 核心库文件夹 #
├─ template
├─ └ gengxin # 更新日志页 #
├─ └ img
├─ └ .....
├ README.html / README.md # 文件夹内简介说明文件 #
├ config.simple.php # 核心配置文件 #
├ index.php # 核心 #
├ gengxin.php # 更新日志调用 #
├ Xdir v1.4.0 LOGO.png
├ LICENSE # 许可证 #
├ COPYING # 许可说明 #
├ 其它文件*.*升级方法：
由于此次版本更新，核心框架目录结构有所变动，新增功能文件调用和删除了部分陈旧目录和文件，建议备份遍历附件数据后重新部署安装Xdir最新版，本次版本更新不建议直接覆盖更新方式进行。
历史版本更新日志
版本号：魔改 v1.3.9 20221205 正式版
- 2022/11/15，性能优化；
- 2022/11/15，优化CSS/Javascript，以及部分功能细节优化；
- 2022/11/15，新增顶部炫酷暗黑模式/夜间模式自助按钮功能，默认支持自夜间22点至次日凌晨6点无忧模式；
- 2022/11/15，新增功能，支持线上PDF文档预览（支持内外网预览）；
- 2022/11/15，更新上一版本二维码失效的问题，调整API接口；
- 2022/11/15，其他细节优化；
- 2022/11/16，修复上一版本BUG问题，更新layer至3.5.1版本，支持弹窗预览时最大化/最小化；
- 2022/11/17，功能更新，支持线上JS、HTML、CSS文件预览，并支持代码高亮；
- 2022/11/18，功能更新，支持线上REG、HTM文件预览，并支持代码高亮；
- 2022/11/18，优化更新，个别图标样式更新、文件管理器个别中文转码更新；
- 2022/11/21，优化更新，代码高亮更新、优化调整后支持自动识别文件类型展示代码高亮，并支持代码自动行号、支持一键复制功能；
- 2022/11/23，魔改 v1.3.9 2022.11.23 正式版，上线；；
- 2022/11/23，魔改 v1.3.9 2022.11.23 正式版，优化更新，优化文本查看器代码高亮区域实现左右滑动块，方便看全内容；
- 2022/11/26，魔改 v1.3.9 2022.11.23 正式版，优化更新，调整并支持jquery-jtoast样式的消息提醒；
- 2022/11/27，魔改 v1.3.9 2022.11.23 正式版，版本更新，调整站点更新日志页面，去除旧日志页面，减轻站点程序体积；
- 2022/12/01，魔改 v1.3.9 2022.11.23 正式版，优化更新，调整文本查看器代码复制随屏滚动、消息提醒由jquery-mac-message-tips提供支持；
- 2022/12/06，魔改 v1.3.9 2022.12.05 正式版，优化调优、版本发布；
版本号：魔改 v1.3.8 20220627 正式版
- 2022/5/11，减轻重量，提升运行性能；
- 2022/5/15，优化CSS/Javascript，以及部分功能细节优化；
- 2022/5/17，新增当前位置导航路径目录复制按钮功能，方便目录链接分享；
- 2022/6/15，优化复制文件及目录链接弹窗提醒样式；
- 2022/6/15，优化功能按钮CSS；
- 2022/6/15，升级jQuery版本；
- 2022/6/16，支持jQuery的图像预览imagePreview功能，支持全局预览；
- 2022/6/21，功能区域新增“下载按钮”；
- 2022/6/23，功能区域新增“音乐、视频、office文档预览按钮”，待优化为判断文件后缀类型并自动识别显示功能按钮；
- 2022/6/25，功能区域新增“文本、MD文档预览按钮”，并优化判断文件后缀类型并自动识别显示功能按钮；
- 2022/6/25，功能区域按钮样式优化更新；
- 2022/6/27，发布 Xdir v1.3.8 20220627 正式版，功能强大，使用便捷，体积轻、访问快；
- 2022/6/29，文本预览新增支持“go、c、cpp、json”后缀格式并支持代码高亮预览；
- 2022/10/9，Tiny File Manager 2.4.1 优化，部分字符中文显示；
- 2022/10/17，更新二维码API接口；
版本号：魔改 v1.3.7 20220420 正式版
- 2022/4/16，站标LOGO及文本UI效果调整；
- 2022/4/16，优化遍历目录列表导航栏UI效果；
- 2022/4/17，优化新简介功能展开和折叠状态，默认为折叠状态，简介功能配置独立文件调用，修复当子目录下无简介文件时默认隐藏简介说明；
- 2022/4/18，优化CSS，部分CSS压缩、格式化，大力提升加载速度；
- 2022/4/19，优化JS，部分Javascript压缩、格式化，大力提升加载速度；；
- 2022/4/20，遍历目录列表文件后缀图标更新；
- 2022/4/20，修复一些BUG错误；
- 2022/4/23，修复建站史页面部分谷歌字体为国内调用；
- 2022/4/25，因站长统计cnzz.com需要续费，现更新为百度统计；
呜谢
基于 Directory Lister 2.7.1 魔改 Xdir 的诞生离不开以下资源的技术支撑，其内核原版版权归原作者所有。
- Directory Lister 2.7.1
- Zdir
- Tiny File Manager
- LayUI
- jQuery Growl
- jQuery.imagePreview
- highlightjs-line-numbers
- jquery-jtoast
- DPlayer
- Markdown
- woytu
Demo
Xdir v1.4.0 正式版：https://demo.xuxiaokun.com/
Directory Lister v2.7.1 原版魔改 v1.4.0 赞助版于 20230525 编译发布（与原版功能一致）
索取源码方式
白金会员
黄金会员Xdir v1.4.0 标准正式版源码可关注笔者公众号，并按指定格式跟帖留言可免费索取。魔改不易，也可线上获取对应版本，赞助版及清爽版支持提供线上技术支持，标准版技术相关问题请跟帖或问答社区提问。
Xdir v1.4.0 20230519 标准、清爽正式版源码解压缩密码获取方式，请通过公众号获取验证码。
【注】微信扫描二维码可快速关注“ITxuxiaokun”官方公众号。
一起来秀一秀吧，以下格式跟帖互动！
1、您的昵称：
2、电子邮箱：
3、将作何用：
4、不妨拿出来秀秀（访问地址）：本文最后更新于 2023-05-29 08:27
请博主喝杯咖啡呢，谢谢^_^
如果本文“对您或有帮助”，欢迎随意打赏，以资鼓励继续创作！
原创文章《Directory Lister魔改Xdir发布》，作者：笔者 徐哲
，未经允许不得转载。
转载或复制时，请注明出处：https://www.xuxiaokun.com/2205.html，本文由 Mr.xu 博客网 整理。
本站资源下载仅供个人学习交流，请于下载后24小时内删除，不允许用于商业用途，否则法律问题自行承担。
微信扫一扫赞赏 
支付宝扫一扫赞赏 
评论列表（6条）
已赞助，求发赞助版我，谢谢。
@huiju-china：收到，已发送赞助版至邮箱，请注意查收。
@笔者 徐哲：收到，用着挺好的，很实用，谢谢。
@huiju-china：感谢支持，用着好就行，有使用上的问题请随时反馈沟通。
如果使用的是宝塔面板，索引页面出现报 is_file(): open_basedir restriction in effect 错误，进入宝塔面板网站目录，去掉【防跨站攻击(open_basedir)】前的“√”即可解决。
Xdir v1.50版本见：https://www.xuxiaokun.com/1046.html