打造私有全能网盘搜索引擎 高性能开源项目 PanSou 深度部署教程

在资源极其碎片化的今天,寻找一份网盘文件往往需要在百度网盘、阿里云盘、夸克、迅雷等多个平台间反复横跳,效率极低。虽然市面上有很多网盘搜索工具,但大多充满广告,且搜索源不可控。

PanSou 是一款专为极客打造的高性能网盘资源搜索 API 服务。它不仅支持通过自定义插件抓取网页资源,还能直接通过 ✈️ 频道获取第一手的影视、软件与书籍。通过并发搜索技术,PanSou 能在几秒钟内聚合全网主流网盘的结果,并进行智能去重与排序。对于想要搭建属于自己的搜索站点或 API 服务的开发者来说,这无疑是目前最顶级的开源方案。


简介

PanSou (盘搜) 核心定位是一个“搜索引擎聚合器”。它解决了传统网盘搜索工具更新慢、来源单一、容易被封禁的痛点。

该项目采用 Go 语言 编写,通过异步插件系统和 ✈️ 爬虫机制,实现了秒级响应。其最大的特色在于集成了 MCP (Model Context Protocol) 协议,这意味着你可以直接将它接入 Claude 或 ChatGPT 等 AI 助手,让 AI 帮你找资源。

核心功能

  • 多源并发搜索:同时检索数十个 ✈️ 频道及自定义插件源,速度快如闪电。 ⚡
  • 智能排序算法:基于资源新鲜度、插件等级、关键词匹配度进行多维度权重排序。 🧠
  • 全平台网盘覆盖:自动识别并分类百度、阿里、夸克、天翼、115、迅雷等 10+ 种网盘。 📂
  • 二级缓存机制:内存 + 磁盘分片缓存,大幅降低重复请求,提升高并发下的稳定性。 🚀
  • 开箱即用:提供 Docker 前后端集成镜像,一键启动完整搜索门户。 🐳
  • 安全认证:可选的 JWT 认证系统,支持多用户管理,保护你的私有 API 不被滥用。 🔐

支持的网盘类型

类型名称标识符支持状态
百度网盘baidu✅ 已支持
阿里云盘aliyun✅ 已支持
夸克网盘quark✅ 已支持
迅雷网盘xunlei✅ 已支持
115网盘115✅ 已支持
磁力/电驴magnet / ed2k✅ 已支持
其他 (移动/UC等)mobile / uc / 123✅ 已支持

准备工作

在开始部署之前,请确保你的服务器环境满足以下条件:

  1. 操作系统:主流 Linux 发行版(Ubuntu/CentOS/Debian)。
  2. 基础环境:已安装 DockerDocker Compose
  3. 网络环境
    • 若需搜索 ✈️ 频道资源,服务器需能访问 ✈️ 服务器(或配置 SOCKS5 代理)。 🌐
  4. 硬件要求:最低 1 核 1G 内存(Go 语言极其节省资源)。

部署步骤

PanSou 提供了三种灵活的部署方案,建议根据你的需求选择。

方案一:前后端集成版 (推荐) 🌟

此方案包含美观的前端界面和强大的后端 API,适合直接搭建搜索门户。

1. 使用 Docker Compose 一键启动

创建 docker-compose.yml 文件:

curl -o docker-compose.yml https://raw.githubusercontent.com/fish2018/pansou-web/main/docker-compose.yml

启动服务:

docker-compose up -d

启动后,访问服务器 http://IP 即可看到搜索界面。


方案二:纯后端 API 版 🛠️

如果你只需要后端数据接口,用于自己的应用或小程序,请使用此方案。

1. 快速启动命令

docker run -d --name pansou-api \
  -p 8888:8888 \
  -e PORT=8888 \
  ghcr.io/fish2018/pansou:latest

2. 配置 SOCKS5 代理 (抓取 TG 必备)

如果你的服务器在国内,需要配置代理才能正常抓取 ✈️ 的数据:

docker run -d --name pansou-api \
  -p 8888:8888 \
  -e PROXY=socks5://127.0.0.1:1080 \
  -e ENABLED_PLUGINS="labi,zhizhen,shandian" \
  ghcr.io/fish2018/pansou:latest

方案三:源码编译安装 💻

适合开发者进行二次开发。

1. 环境要求

  • Go 1.18+

2. 克隆与编译

git clone https://github.com/fish2018/pansou.git
cd pansou
# 编译
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o pansou .
# 运行
./pansou

进阶:配置安全认证 (JWT)

为了防止 API 被盗刷,你可以启用认证功能:

修改环境变量或在 Docker 启动时加入:

  • AUTH_ENABLED=true
  • AUTH_USERS=admin:password123 (格式为:用户名:密码)

启用后,所有 API 请求需在 Header 中携带 Authorization: Bearer <token>


总结评价

优点

  • 性能极佳:Go 语言的并发优势在多源搜索中体现得淋漓尽致,几乎没有延迟感。 🚄
  • 数据源丰富:TG 频道+插件模式保证了资源的覆盖面,尤其在影视资源上非常强势。 🎬
  • 架构优雅:支持 MCP 协议和异步处理模式,扩展性极强。 🏗️

缺点

  • 网络门槛:✈️ 爬虫功能依赖代理,对于部分小白用户有一定的网络配置成本。 📶
  • 前端局限:集成的 Web 端虽简洁,但自定义样式略显繁琐。 🎨

适用建议

如果你想建立一个私人的资源库,或者为你的社群提供资源搜索服务,PanSou 是目前性能最优、配置最灵活的开源方案。


项目地址

资源名称链接地址
GitHub 主仓库fish2018/pansou
演示地址so.252035.xyz
© 版权声明
THE END
喜欢就支持一下吧
点赞28 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容