网友前端秀

[fish2018]

https://pan.ailinux.de/

https://www.gugeso.com/

https://sou.makifx.com/

https://yx.zerovv.top/

https://so.yinpai.xyz/

[Rust]网友移植的手机/桌面端 仓库
[Go]网友移植的桌面版 仓库
[TypeScript ]网友移植的纯前端版 仓库

[OsGits]

我制作了一个基于pansou为API接口的前端，纯PHP，完全依托pansou才能运行的源码！

PanBbs - 网盘资源聚合

一个轻量级的网盘资源聚合展示系统，从远程 API 拉取数据并分类展示，支持搜索、滚动加载、详情弹窗、密码一键复制等功能。

📦 仓库地址：OsGits/PanBbs

项目来源

本项目是基于开源网盘搜索工具 PanSo 的扩展前端。

• PanSo 提供了网盘资源搜索的后端 API 服务，负责数据抓取与检索
• PanBbs 在 PanSo 的基础上，构建了一套完整的前端展示层，提供更友好的浏览、搜索、分类体验

两者关系：

PanSo（后端 API）  ←   PanBbs（扩展前端）
   │                        │
   │ 提供/api/search        │ 调用 API + 本地缓存
   │ 负责搜索与爬取          │ 分类展示 + 滚动加载 + 搜索 UI
   │                        │
   └──────── 配合使用 ────────┘

功能

• 资源聚合展示 — 从远程 API 抓取数据，按类型分类展示
• 搜索模块 — 弹窗输入关键词，直接调用远程 API 搜索，支持网盘类型复选框筛选
• 滚动加载 — 首屏展示 10 条，滚动到底自动追加，滑到底自动刷新获取新数据
• 详情弹窗 — 点击「查看详情」弹出无边框弹窗，展示标题、正文、标签、密码、添加时间
• 密码一键复制 — 卡片和弹窗中的密码区域点击即可复制到剪贴板
• 源链接复制 — 详情弹窗中一键复制网盘源链接到剪贴板
• 毛玻璃弹窗 — 搜索 / 版本信息 / 详情弹窗均采用毛玻璃半透明风格
• 骨架屏加载 — 首屏加载时显示骨架屏动画，提升感知体验
• 回到顶部 — 右下角浮动按钮，滚动超过 500px 时显示
• 全局加载遮罩 — 数据刷新时显示遮罩，防止重复操作
• 后台管理面板 — 提供数据统计、系统设置（SEO / 接口 / 缓存 / 账号密码）、版本管理等功能
• 缓存配置 — 后台可配置缓存网盘类型及每种类型的最大记录数
• 版本更新检测 — 自动从 GitHub Releases 获取远程版本，前端弹窗提示更新，支持在线/离线更新
• 静态资源版本控制 — 通过 version.php 统一管理 CSS/JS 缓存版本号

目录结构

PanBbs/
├── index.php                  # 前台路由入口（home / api / search / version）
├── api.php                    # 工具函数库（数据获取、解析、展平、存储）
├── ting.php                   # 数据抓取触发脚本（覆盖模式，拉取远程数据 → 替换 oss.json）
├── version.php                # 统一版本管理（本地版本 + 远程 GitHub 版本 + curl 兜底）
├── admin.php                  # 后台路由入口（dashboard / settings / version）
├── admin/                     # 后台管理模块
│   ├── actions.php            # AJAX 操作处理（抓取数据、清空缓存、修改配置等）
│   ├── auth.php               # 登录验证逻辑
│   ├── layout_head.php        # 后台公共头部
│   ├── layout_sidebar.php     # 后台侧边栏导航
│   ├── layout_topbar.php      # 后台顶部栏
│   ├── page_dashboard.php     # 控制面板（数据统计概览）
│   ├── page_login.php         # 登录页面
│   ├── page_settings.php      # 系统设置（SEO / 接口 / 缓存 / 修改账号密码）
│   └── page_version.php       # 版本管理（在线更新 / 离线更新 / 更新日志）
├── data/                      # 数据与配置
│   ├── data.php               # 配置文件（账号密码、SEO、API地址、缓存类型、最大记录数）
│   └── index.php              # 目录占位（oss.json 由 ting.php 自动生成）
├── log/                       # 更新日记
│   ├── V**********.md
│   ├── V**********.md
│   ├── V**********.md
│   └── V**********.md
└── template/                  # 前台模板（模块化拆分）
    ├── home.php               # 模块中枢（require 各子模块）
    ├── _head.php              # HTML头部 + 数据准备 + SEO 注入
    ├── _header.php            # 顶部导航栏
    ├── _toolbar.php           # 工具栏 + 骨架屏 + 加载指示器
    ├── _content.php           # 卡片容器 + 空状态
    ├── _fab.php               # 右下角浮动按钮组（搜索 / 版本信息）
    ├── _modal_search.php      # 搜索弹窗（含网盘类型复选框筛选）
    ├── _modal_version.php     # 版本信息弹窗（本地 vs 远程对比 + 连接器状态指示）
    ├── _modal_detail.php      # 资源详情弹窗（无边框，复制源链接 + 密码复制）
    ├── _footer.php            # 页脚 + 全局加载遮罩 + JS 注入
    ├── app.js                 # 前端交互脚本（滚动加载、搜索、详情弹窗、版本检测等）
    └── style.css              # 样式表（现代简约风格 + 毛玻璃效果）

架构与数据流

路由分发 (index.php)

Action	说明
?a=home（默认）	渲染前端模板页面
?a=api&type=xxx	返回本地 data/oss.json 中指定类型的数据（JSON）
?a=search&kw=xxx&types=xxx	调用远程 API 搜索，解析展平后直接返回 JSON，不存储到本地
?a=version	返回本地版本与远程版本号（JSON），供前端版本检测使用

数据抓取 (ting.php)

• 访问 ting.php 触发从远程 API 拉取全量数据
• 按类型分类后，按 URL 去重，覆盖写入 data/oss.json（非增量合并）
• 缓存类型和最大记录数由 data/data.php 中的 $cachePans / $maxRecords 控制
• 支持 ?debug=1 调试模式，逐步排查抓取问题

后台管理 (admin.php)

• 访问 admin.php 进入后台登录页，默认账号密码见 data/data.php 中 $accounts 数组
• 控制面板（默认，?a=dashboard）：数据统计概览 + 版本信息
• 系统设置 (?a=settings)：SEO 配置 / 接口设置 / 缓存网盘类型 / 修改账号密码
• 版本管理 (?a=version)：在线更新 / 离线更新 / 查看 GitHub Releases 更新日志
• 所有配置修改通过正则替换直接写入 PHP 源文件，无需数据库

前端数据加载

1. 首次访问 — home.php 将本地 oss.json 数据注入 JS 变量 PANBBS_DATA
2. 滚动到底 — 当前数据全部渲染完毕后，触发 ting.php 拉新数据，再通过 ?a=api 重新加载
3. 搜索 — 弹窗输入关键词 + 选择网盘类型，直接请求 ?a=search&kw=xxx&types=xxx 获取远程结果并展示

远程 API 格式

项目对接的远程 API 地址由 data/data.php 中的 $apiBaseUrl 统一配置。

参数：

• kw — 搜索关键词（空字符串拉取全量）
• conc=30 — 并发数
• res=all — 返回全部结果

返回的 JSON 结构支持多种格式（data.results / data.list / list 等），由 parseRemoteData() 自动兼容。

注意事项

1. 远程 API 依赖 — 项目依赖远程搜索 API 接口，部署前需确保该服务可用。API 地址由 data/data.php 中的 $apiBaseUrl 统一配置，也可在后台「系统设置」→「接口设置」中修改。

2. 数据目录权限 — data/ 目录需要 PHP 写入权限，ting.php 运行时会在此目录生成 oss.json。

3. 目标类型 — 缓存网盘类型由 data/data.php 中的 $cachePans 配置控制，可在后台「系统设置」→「缓存设置」中修改，或直接编辑配置文件。

4. 搜索不落盘 — 搜索请求走 ?a=search 直接从远程 API 获取并返回，不会写入本地 oss.json，确保本地数据干净。

5. 超时处理 — 前端请求超时设为 60 秒（搜索）/ 20 秒（数据刷新），超时仅提示不中断请求；数据抓取 ting.php 的 cURL 超时为 30 秒。

6. UTF-8 修复 — api.php 中的 fixUtf8() 函数会自动修复远程返回数据中的非法 UTF-8 字符，防止 JSON 解析失败。

7. 缓存刷新 — 修改 CSS/JS 后，更新 version.php 中的版本号即可强制浏览器刷新缓存。

8. 最大记录数 — 每种类型最多保留的记录数由 data/data.php 中的 $maxRecords 配置控制（默认 100），超出部分会被自动截断。可在后台「系统设置」→「缓存设置」中修改。

部署

将项目放置到 PHP 支持的 Web 服务器目录下，确保：

• PHP 版本 ≥ 7.0
• 允许 file_get_contents() 远程访问或已安装 cURL 扩展
• data/ 目录可写

首次访问前，先访问一次 ting.php 拉取初始数据，然后访问首页即可正常使用。