网盘资源搜索神器-毕业帮

一、 PanSou 是什么？

PanSou 是一个 高性能的网盘资源搜索 API 服务，主要特点包括：

支持通过 Telegram (TG) 频道 以及 自定义插件 搜索资源；
设计核心聚焦 高性能 和 可扩展性，可实现多频道与多插件的 并发搜索，并附带智能排序与网盘类型分类功能；
提供 Docker 容器一键部署，包含前后端集成镜像，操作简单，开箱即用。(GitHub)

此外，该项目的发展动向也被介绍在了 ruanyf/weekly 的自荐 issue 中，进一步体现其功能全面、部署便捷的优势。(GitHub)

二、功能亮点概览（详解）

1. 高性能搜索与并发机制

利用 工作池设计，并行调度多个 TG 频道与插件进行搜索，极大提升响应速度与吞吐性能。(GitHub)
支持异步插件机制：针对响应时间过长的搜索源进行异步处理，先响应，再持续更新结果。(GitHub)

2. 网盘类型智能分类

自动识别并分类多种主流网盘资源，如百度网盘、阿里云盘、夸克网盘、115、PikPak、迅雷网盘、磁力链接 (magnet)、电驴链接 (ed2k) 等。(GitHub)

3. 智能排序策略

结合多个维度：插件等级、更新时间、新鲜度、关键词优先级等，实现更精准、更有价值的排序。(GitHub)

4. 高效缓存系统（“二级缓存”）

采用 分片内存缓存 + 分片磁盘缓存 的结构，提升缓存命中率及并发处理性能；
针对内存与磁盘，启用高效锁机制与位运算哈希算法减轻并发瓶颈。(GitHub)
支持 Gob/json 序列化、缓存压缩与写入策略定制（immediate / hybrid 等）。(GitHub)

5. RESTful API 接口与配置灵活性

提供标准接口 /api/search 支持 GET/POST；以及 /api/health 用于状态检测。(GitHub)
丰富的环境变量支持：代理设置（如 SOCKS5）、搜索频道配置、缓存控制（启用、TTL、分片数等）、插件超时、HTTP 连接数优化等。(GitHub)

6. 一键部署能力

提供 docker-compose.yml 和单镜像方式，一键启动服务；
支持 amd64 与 arm64 架构，具备灵活的镜像兼容性。(GitHub)

7. 前端集成与可视化调试界面（pansou-web）

专门提供一个简洁的前端页面集成 REST 接口、在线调试搜索 API、配置界面展示等功能。(GitHub)

三、细节演示与使用流程

1. 克隆仓库与部署

git clone https://github.com/fish2018/pansou.git
cd pansou

可选择使用 Docker 或源码直运行。

Docker Compose（推荐）：

wget https://raw.githubusercontent.com/fish2018/pansou/main/docker-compose.yml
docker-compose up -d

访问 http://localhost:8888 即可使用 API。(GitHub)

直接 Docker 命令：

docker run -d --name pansou \
  -p 8888:8888 \
  -v pansou-cache:/app/cache \
  -e CHANNELS="tgsearchers2,SharePanBaidu,yunpanxunlei" \
  -e CACHE_ENABLED=true \
  -e ASYNC_PLUGIN_ENABLED=true \
  ghcr.io/fish2018/pansou:latest

可用上述环境变量调整频道、开启缓存及异步插件。(GitHub)

2. 使用 API 搜索资源示例：

GET 示例：

GET /api/search?kw=速度与激情&channels=tgsearchers2,xxx&conc=2&refresh=true&res=merge&src=all&cloud_types=baidu,quark&ext={"title_en":"Fast and Furious","is_all":true}

POST 示例：

POST /api/search
{
  "kw":"速度与激情",
  "channels":["tgsearchers2","xxx"],
  "conc":2,
  "refresh":true,
  "res":"merge",
  "src":"all",
  "cloud_types":["baidu","quark"],
  "ext":{"title_en":"Fast and Furious","is_all":true}
}

返回包含 results 和 merged_by_type 分类后的结构化数据。(GitHub)

3. 健康检查接口：

GET /api/health

{
  "channels":["tgsearchers2"],
  "plugin_count":16,
  "plugins":[ ... ],
  "plugins_enabled":true,
  "status":"ok"
}

可查看系统当前加载插件数量、状态等信息。(GitHub)

体验地址：https://so.252035.xyz/

四、近期迭代亮点（2025 年 7–8 月更新展示）

TG 搜索支持图片匹配与 images 字段返回，便于获取封面、海报等视觉内容。(LINUX DO)
前后端集成镜像发布，一键启动，无需额外配置。(LINUX DO)
新增海盗湾 (ThePirateBay) 插件，支持利用英文标题优先搜索。(LINUX DO)
状态页面展示插件与频道信息，实现可视化运维监控。(LINUX DO)
优化缓存写入策略：采用批量写入机制，减少磁盘 I/O。(LINUX DO)
搜索插件持续丰富，包括 fox4k、wanou、zhizhen、huban、muou、duoduo、labi、shandian 等，提升覆盖面。(LINUX DO)
重构异步插件缓存更新策略与排序算法，体验更加流畅、响应更快。(LINUX DO)
支持缓存优化（内存管理）、arm64 架构镜像。(LINUX DO)

目录CONTENT

网盘资源搜索神器