心悦搜索5分钟快速上手:新手必会的资源搜索与转存分享全流程

原创2026-11-14 16:11:072,128 阅读

心悦搜索5分钟快速上手:新手必会的资源搜索与转存分享全流程

心悦搜索(xinyue-search)是一款多网盘资源搜索与转存分享工具,支持夸克网盘、百度网盘、阿里云盘、UC网盘、迅雷云盘,自带前台搜索引擎、全网搜索线路配置和后台管理界面。本文面向新手,带你在5分钟内完成部署、搜索、转存、导入的完整流程。

一、心悦搜索能做什么

部署完成后,你会得到一个类似下面这样的前台搜索页面:

心悦搜索前台首页:输入关键字即可搜索网盘资源

它的核心能力可以概括为4点:

  • 🔍 关键词搜索:精准、模糊、分词三种搜索模式,首页展示最新/热门资源排行榜
  • 🌐 全网搜索:本地没有资源时,自动走后台配置的搜索线路(API接口、TG频道、网页爬虫三种类型)
  • 💾 一键转存分享:把搜索到的网盘链接转存到自己账号,再生成新的分享链接
  • 📥 批量导入:支持直接导入和转存分享导入,一次最多500条

心悦搜索前台资源排行榜:最新与热门资源一屏展示

二、部署:从下载到可用只需3步

1. 获取代码

使用 git clone 下载仓库代码到服务器:

git clone https://gitcode.com/gh_mirrors/xin/xinyue-search

2. 运行一键安装向导

v3.0 版本起自带一键安装向导(入口文件 public/install/index.php),访问 你的域名/install 即可进入安装页面。向导共5个步骤:

  1. 安装许可协议
  2. 运行环境检测(PHP 版本、上传限制、Session 等)
  3. 安装参数设置(填写数据库账号密码、数据库名)
  4. 安装详细过程(自动导入 public/install/data.sql 数据表)
  5. 安装完成

3. 进入后台

安装完成后,访问 /qfadmin 进入后台管理(登录页面逻辑见 app/admin/controller/Admin.php),左侧菜单包含资源管理、分类管理、资源日志、账号管理、用户需求五大模块。

⚠️ 提示:本项目仅供技术交流与学习使用,项目本身不集成任何第三方资源采集源,搜索线路和账号需自行配置。

心悦搜索后台资源管理界面:支持添加资源、批量删除、导入导出

三、配置转存账号:Cookie 获取方法

转存分享功能依赖你的网盘账号 Cookie。以夸克网盘为例,获取步骤如下:

  1. 浏览器打开夸克网盘网页版并登录
  2. 按 F12 打开开发者工具,切换到网络面板
  3. 刷新页面,在请求列表中找到 list 接口
  4. 查看该请求的请求头,复制完整的 cookie 值
  5. 粘贴到后台「账号管理」中对应的网盘账号位置

夸克网盘Cookie获取教程:在浏览器开发者工具网络面板复制cookie值

账号配置完成后,搜索到的资源就可以一键转存到你的网盘并生成新的分享链接了。多网盘的转存逻辑统一由 extend/netdisk/Transfer.php 调度,按链接域名自动识别是夸克、阿里、百度、UC 还是迅雷网盘。

四、资源搜索:关键词搜索 + 全网搜索

关键词搜索(本地资源)

在前台输入框直接输入关键字即可,接口逻辑见 app/api/controller/Search.php,支持列表、详情、最新、热门、分类五种查询。

全网搜索(无结果时自动跳转)

当本地没有命中资源时,系统会按线路权重依次请求全网搜索线路。全网搜索接口 app/api/controller/Other.php 支持4种线路类型:

线路类型 说明
api 调用第三方接口,支持固定参数与字段映射
tg 搜索 TG 频道公开页
html 网页爬虫,用标签+类名定位结果列表
kk 内置问答类接口

线路在后台「接口配置」中管理(app/admin/controller/ApiList.php),可以设置权重、启停状态、每条线路最多返回的资源数,还能通过配置项 ban_keywords 屏蔽特定搜索关键词。

五、资源导入:两种模式一次看懂

后台「资源管理」页点击导入资源,会弹出导入窗口,提供两种模式:

  • 直接导入:粘贴夸克、阿里、UC 的网盘直链,一资源一行,链接有效后即可入库
  • 转存分享导入:把第三方分享链接先转存到自己的账号,再分享生成新链接入库,避免原链接失效

心悦搜索后台导入资源弹窗:支持直接导入与转存分享导入两种模式

此外还支持批量导入、导出资源和夸克导入专用按钮,配合资源分类管理,方便搭建自己的资源索引库。

六、常见问题速查

  • 搜索没有结果? 优先检查后台是否配置了可用搜索线路(状态为启用),或先在「资源管理」中导入本地资源
  • 转存失败? 检查账号管理中的 Cookie 是否过期,网盘 Cookie 需要定期更新
  • 转存接口提示"今天已经执行过"? 定时转存接口(app/api/controller/Source.php 中的 day 方法)每天只能执行一次,请1小时后再试
  • 如何升级版本? 查看仓库根目录的 更新说明,其中列出了各版本需要更新的文件与数据表语句

写在最后

心悦搜索的架构非常清晰:前台展示在 app/index/controller/Index.php,API 层在 app/api/controller/,网盘适配层在 extend/netdisk/pan/,视图模板集中在 public/views/。对于想学习 ThinkPHP 实战或搭建个人资源索引站的新手来说,这是一个很好的入门项目。

祝你搭建顺利!🚀

登录后查看全文
xinyue-search