Xdir 帮助文档【介绍】

  Xdir是一款使用基于PHP开发的目录列表程序,基于开源Directory Lister内核,无需数据库,体积小巧,功能完善,简单实用,免费开源,下载源码开箱即用,就是这么干脆 。

  本程序是在Zdir v1.55二次开发中调优了部分程序而编译的,调优了部分程序功能、保留了绝大部分内核,基本实现本地化、部分内容完全中文语言化,体验感更好了。

Xdir
 
suoying

如果页面提示Unable to open file! 或 无法打开索引文件,说明您的索引目录不可写,请自行检查目录权限,确保functions/caches该目录可读写。

为了降低资源消耗,文件索引存在24小时缓存,您可以访问index.php?c=cache&del=cache清除当前缓存并重新生成索引。

环境要求

  • PHP >= 5.6(建议PHP 7.2,博主用的是PHP 7.4)
  • 文件索引依赖于curl组件
  • 如果需要获得更高级的文件管理功能,依赖于Fileinfo, iconv, zip, tar and mbstring组件(非必须)
  • 如果是Linux环境,前端不显示文件和目录,那么可能是 PHP函数 scandir 被禁用;

本软件库已实现的主要功能

  • [√] 列表目录浏览
  • [√] MarkDown文件预览
  • [√] CSS/JavaScript一键复制
  • [√] 支持文件Hash查看
  • [√] 支持在线图片预览 [√] 支持在线视频播放(支持.mp4格式和.m3u8)
  • [√] 支持音乐播放
  • [√] 支持文本查看器(支持的格式有.txt .sh .py .go .c .cpp)
  • [√] 支持Office在线预览(支持.doc .docx .xls .xlsx .ppt .pptx)注意:如果是内网或IP访问方式不支持预览
  • [√] 支持站内文件索引
  • [√] 支持二维码生成分享使用
  • [√] 文件删除
  • [√] 文件搜索(建议搜索之前,通过底部更新索引一下,搜索效果更佳)
  • [√] 文件上传
  • [√] 密码验证
  • [√] 支持中文显示(Linux、Windows)
  • [√] 手机界面支持搜索
  • [√] 去除前台删除按钮转入文件管理操作
  • [√] 首页支持密码验证登录
  • [√] 支持程序放在子目录运行
  • [√] 支持网站统计代码,程序将自动加载(可以新建static/tongji.js)
  • [√] 支持广告设置(程序根目录下创建config.json可支持广告设置)
  • [√] 文件夹与文件重新排序(默认文件夹在最前面)
  • [√] 文件管理(上传、删除、压缩等)
  • [√] 增加页面返回顶部控件
  • [√] 优化了部分CSS

v1.50更新说明

此版本基于Zdir v1.55版本源码二次开发,现可将Xdir放在子目录中运行

  • 优化CSS
  • 修复一些BUG
  • 可以新建static/tongji.js并添加网站统计代码,Xdir将自动加载
  • 文件管理器的用户名、密码可以在config.php自定设置
  • config.json可支持广告设置
  • 此版本可将Xdir放在字目录中
    自v1.50版本开始,Xdir支持安装在子目录运行,比如您的站点目录为/data/wwwroot/default,您可以将Xdir源码放在/data/wwwroot/default/Xdir安装在子目录需要设置伪静态才能正常运行。

Nginx伪静态

  • 需要个将默认首页设置为Xdir/index.php,比如index Xdir/index.php index.html index.htm index.php
  • 需要在Server的配置中添加一行伪静态规则:rewrite ^/static/(.+) /Xdir/static/$1 break;

下方是一个示例配置:

server {
  listen 80;
  server_name localhost;
  #access_log /var/log/zdir.log combined;
  index zdir/index.php index.html index.htm index.php;
  root /data/wwwroot/default;

  #rewrite
  rewrite ^/static/(.+) /zdir/static/$1 break;
  #error_page 404 /404.html;
  #error_page 502 /502.html;

  location ~ [^/]\.php(/|$) {
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index index.php;
    include fastcgi.conf;
  }

  location ~ .*\.(gif|jpg|jpeg|png|bmp|swf|flv|mp4|ico)$ {
    expires 30d;
    access_log off;
  }
  location ~ .*\.(js|css)?$ {
    expires 7d;
    access_log off;
  }
  location ~ /\.ht {
    deny all;
  }
}

Apache伪静态

Apache环境直接将/data/wwwroot/default/Xdir/.htaccess.bak复制为/data/wwwroot/default/.htaccess即可。或者自行在站点根目录下新建一个.htaccess文件,内容为:

RewriteEngine On
DirectoryIndex Xdir/index.php
RewriteRule 'static/(.*)

config.php设置

需要在config.php文件中将"thedir" => '',设置为您的站点根目录,比如:

"thedir"	=>	'/data/wwwroot/default',

注意:安装在子目录的方式,站点根目录不能以zdir命名,比如:/web/zdir是不允许的,应改为/web/xxx


其它安装说明

  1. 可通过捐赠向笔者索引提供源码下载路径,后并解压到站点根目录下。
  2. config.simple.php修改为config.php
  3. 修改config.php 文件,设置网站关键词、描述等、密码等
  4. 访问您的域名测试,文件管理用户名为admin,密码为config.php中设置的密码。
    更多说明请查看帮助文档:https://www.xuxiaokun.com/1046.html

config.php配置文件说明

设置站点基本信息

打开config.php 配置文件

$siteinfo = array(
		"site_name"	=>	"<i class='fa fa-sitemap' aria-hidden='true'></i> Xdir软件库",
		"title"		=>	"Xdir 实用的目录列表程序",
		"keywords"	=>	"xdir,h5ai,Directory Lister,Fdscript,目录列表,目录索引",
		"description"	=>	"Xdir是一款使用PHP开发的目录列表程序,简单实用,免费开源,是Zdir源码二次开发版本。"
	);
  • site_name:网站名称(左上角显示)
  • title:设置站点标题(浏览器上显示)
  • keywords:设置网站关键词
  • description:设置网站描述

排除某个目录

//需要忽略的目录
	$ignore	= array(
		".",
		".git",
		"favicon.ico",
		"functions",
		"config.php",
		"index.php",
		"static",
		"LICENSE",
		"template",
		"cache.php",
		"indexes.php"
	);

如果您需要排除某个目录,请修改上面的$ignore变量。

支持添加统计代码

此版本可以在Zdir目录下新建一个tongji.js文件,里面放入网站统计代码,Zdir将自动加载,注意统计代码不需要script标签,百度统计代码测试通过,其它统计代码未做测试。

左右两侧悬浮广告设置

此版本支持网站左右两侧的悬浮广告设置,需要在Zdir目录下新建一个文件命名为config.json,内容参考:

{
"gg":{
    "gg_left":"<a href='https://dwz.ovh/d' target='_blank' rel="noopener noreferrer"><img src='https://dwz.ovh/c'></a>",
    "gg_right":"<a href='https://www.xiaoz.me/archives/11183' target='_blank' rel="noopener noreferrer"><img src='https://i.bmp.ovh/imgs/2019/11/39adab31131a53a8.png'></a>"
}

其它功能使用说明

Markdown预览

  Xdir支持Markdown文件预览,如果以readme.md命名,会直接出现“使用说明”按钮,如果是其它.md后缀的文件会出现一个“小眼睛”按钮,点击该按钮可以预览Markdown文件。

Xdir 帮助文档【介绍】

文件索引

  为了快速找出需要的文件,Xdir提供了文件索引功能,可访问点击导航栏“文件索引”进行查看,访问该页面后可按Ctrl + F搜索文件,如下截图。

suoying

  如果页面提示无法打开文件!,说明您的目录不可写,请自行检查目录权限,确保functions/caches该目录可读写。

  为了降低资源消耗,文件索引存在24小时缓存,您可以访问index.php?c=cache&del=cache清除当前缓存并重新生成索引。

已知问题,当启用密码验证时,因两者冲突,更新索引会出现失败异常。

文件搜索

  文件搜索功能依赖于“文件索引”,因此请先确保您的文件索引功能可以正常使用,并且已经成功生成了索引文件。然后在右上角输入搜索框进行搜索,如下截图。

sousuo

文件管理

  点击导航栏“文件管理”或者访问functions/admin.php进入,用户名为admin,密码为config.php中设置的密码。文件管理支持上传、修改、删除等功能,如下截图。

Xdir 帮助文档【介绍】

启用密码验证

  1. 修改 config.php 将 "auth"  => FALSE 参数修改为 TRUE 
  2. 再次访问首页会要求输入账号、密码,用户名为 admin 密码为 config.php 中设置的密码

注意事项:
  应部分网友要求,添加了简单的密码验证,但此功能无法防止用户下载文件,只要知道真实地址依然可请求文件。

移动手机访问

2021072705000113

2021072705001295

查看程序版本

找到路径 /functions/version.txt

注意事项

  • 仅限于本工作室自用及赞助者通过密码获得访问与下载
  • 访问者若出现页面乱码、无法下载时请与笔者联络,谢谢反馈。

Demo

联系博主及获取捐赠版

  未经作者授权,请勿去掉底部版权。或者通过赞赏通道,留言您的网址可获取捐赠版,捐赠版可去除底部版权。

请笔者喝一杯咖啡

呜谢

  Xdir的诞生离不开以下开源项目,在此表示感谢,非常感谢xiaoz的耐心和指导并提供程序源文及技术咨询,原版版权归原作者。

原创文章《Xdir 帮助文档【介绍】》,作者:Admin,未经允许不得转载。
转载或复制时,请注明出处:https://www.xuxiaokun.com/1046.html,本文由 Mr.xu 博客网 整理。

发表评论

登录后才能评论

此站点使用Akismet来减少垃圾评论。了解我们如何处理您的评论数据

线上沟通

笔者期待与您共勉 · 互赢

有言必答:点击这里给我发消息

商务洽谈:交互沟通 · 共赢互利

邮件:admin@xuxiaokun.com

线上沟通:周一至周五 9:30 - 17:30

其余时间Mail或QQ我,有言必应。

微信关注
微信关注
投递稿件 我要留言
分享本页
返回顶部