心悦搜索5分钟快速上手:新手必会的资源搜索与转存分享全流程
心悦搜索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个步骤:
- 安装许可协议
- 运行环境检测(PHP 版本、上传限制、Session 等)
- 安装参数设置(填写数据库账号密码、数据库名)
- 安装详细过程(自动导入 public/install/data.sql 数据表)
- 安装完成
3. 进入后台
安装完成后,访问 /qfadmin 进入后台管理(登录页面逻辑见 app/admin/controller/Admin.php),左侧菜单包含资源管理、分类管理、资源日志、账号管理、用户需求五大模块。
⚠️ 提示:本项目仅供技术交流与学习使用,项目本身不集成任何第三方资源采集源,搜索线路和账号需自行配置。
三、配置转存账号:Cookie 获取方法
转存分享功能依赖你的网盘账号 Cookie。以夸克网盘为例,获取步骤如下:
- 浏览器打开夸克网盘网页版并登录
- 按
F12打开开发者工具,切换到网络面板 - 刷新页面,在请求列表中找到
list接口 - 查看该请求的请求头,复制完整的
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 实战或搭建个人资源索引站的新手来说,这是一个很好的入门项目。
祝你搭建顺利!🚀




