星芒下载站

一个简洁美观的PHP文件下载系统，支持文件夹浏览、文件下载和图片预览功能。

功能特性

• 📁 文件夹浏览 - 支持多层级目录结构浏览
• ⬇️ 文件下载 - 安全的文件下载功能
• 🖼️ 图片预览 - 支持常见图片格式的在线预览
• ?? 响应式设计 - 适配桌面和移动设备
• 🎨 现代化界面 - 采用毛玻璃效果和渐变背景
• ⚡ 流畅动画 - 丰富的交互动画效果
• 🔒 安全防护 - 防止目录遍历攻击

技术栈

• 后端: PHP
• 前端: HTML5, CSS3, JavaScript
• 样式: 现代化CSS，支持响应式布局
• 图标: Emoji图标系统

文件结构

星芒下载站/
├── index.php              # 主页面，文件列表展示
├── download.php            # 文件下载处理
├── get_folder_content.php  # 文件夹内容获取
├── preview.php             # 图片预览页面
├── script.js               # 前端交互脚本
├── style.css               # 样式文件
├── robots.txt              # 搜索引擎配置
└── Data/                   # 文件存储目录（需要创建）

安装说明

1. 环境要求

   • PHP 7.0 或更高版本
   • Web服务器（Apache/Nginx）
   • 支持文件读取权限

2. 部署步骤

   # 1. 将项目文件上传到Web服务器目录
   # 2. 创建Data目录用于存储文件
   mkdir Data
   chmod 755 Data
   
   # 3. 确保PHP有读取Data目录的权限
   # 4. 访问index.php开始使用

3. 文件组织

   • 将所有需要分享的文件放入 Data/ 目录
   • 支持在Data目录下创建子文件夹进行分类管理

使用说明

基本操作

• 浏览文件: 点击文件夹图标进入子目录
• 下载文件: 点击文件名直接下载
• 预览图片: 点击图片文件名进行预览
• 返回上级: 点击"返回上级目录"或面包屑导航

快捷键支持

• ESC - 返回首页
• ↑/↓ - 在文件列表中导航
• Ctrl+Enter - 在预览页面下载当前文件

支持的图片格式

• JPG/JPEG
• PNG
• GIF
• BMP
• WebP

安全特性

• 路径验证: 防止目录遍历攻击（../）
• 文件类型检查: 限制可预览的文件类型
• 路径过滤: 防止空字节注入
• 安全下载: 强制下载而非执行

自定义配置

修改文件存储路径

编辑 index.php, download.php, preview.php 中的 $targetDir 变量：

// 默认为 'Data'
$targetDir = 'YourCustomFolder';

添加支持的文件类型

在 preview.php 中修改 $imageExtensions 数组：

$imageExtensions = array('jpg', 'jpeg', 'png', 'gif', 'bmp', 'webp', 'svg');

浏览器兼容性

• Chrome 60+
• Firefox 55+
• Safari 12+
• Edge 79+

更新日志

v1.0.0

• 初始版本发布
• 支持文件浏览和下载
• 图片预览功能
• 响应式设计
• 安全防护机制

贡献

欢迎提交Issue和Pull Request来改进这个项目。

许可证

本项目采用 MIT 许可证。

联系方式

如有问题或建议，请通过以下方式联系：

• 邮箱: [huhuangchenglin@petalmail.com]

---

星芒下载站 - 让文件分享更简单、更美观！