pansou： 全网网盘搜索神器

2025年09月28日 10:23:52
14628
网盘搜素 Docker MCP Go

项目结构

📌 pansou fish2018/pansou

PanSou是一款高性能的网盘资源搜索API服务，支持TG频道和插件搜索。系统设计以性能和可扩展性为核心，支持多频道多插件并发搜索、结果智能排序和网盘类型分类。docker集成前后端，一键启动，开箱即用。 https://so.252035.xyz/

项目大小 55.86 KB
涉及语言 Go 94.07% TypeScript 4.64% JavaScript 1.04% Dockerfile 0.25%
许可协议 MIT License
Gitee Github

PanSou 网盘搜索API

PanSou是一个高性能的网盘资源搜索API服务，支持TG搜索和自定义插件搜索。系统设计以性能和可扩展性为核心，支持并发搜索、结果智能排序和网盘类型分类。

[//]: # (MCP服务文档: MCP-SERVICE.md)

特性（详见系统设计文档）

  • 高性能搜索：并发执行多个TG频道及异步插件搜索，显著提升搜索速度；工作池设计，高效管理并发任务
  • 网盘类型分类：自动识别多种网盘链接，按类型归类展示
  • 智能排序：基于插件等级、时间新鲜度和优先*的度综合排序算法
  • 异步插件系统：支持通过插件扩展搜索来源，支持"尽快响应，持续处理"的异步搜索模式，解决了某些搜索源响应时间长的问题。详情参考插件开发指南
  • 二级缓存：分片内存+分片磁盘缓存机制，大幅提升重复查询速度和并发性能

MCP 服务

PanSou 还提供了一个基于 Model Context Protocol (MCP) 的服务，可以将搜索功能集成到 Claude Desktop 等支持 MCP 的应用中。详情请参阅 MCP 服务文档。

支持的网盘类型

百度网盘 (baidu)、阿里云盘 (aliyun)、夸克网盘 (quark)、天翼云盘 (tianyi)、UC网盘 (uc)、移动云盘 (mobile)、115网盘 (115)、PikPak (pikpak)、迅雷网盘 (xunlei)、123网盘 (123)、磁力链接 (magnet)、电驴链接 (ed2k)、其他 (others)

快速开始

在 Github 上先Fork me on GitHub
本项目，并点上 Star !!!

使用Docker部署

1、前后端集成版

直接使用Docker命令

一键启动，开箱即用

1
docker run -d --name pansou -p 80:80 -e ENABLED_PLUGINS="labi,zhizhen,shandian,duoduo,muou,wanou" ghcr.io/fish2018/pansou-web
使用Docker Compose（推荐）
1
2
3
4
5
6
7
8
# 下载配置文件
curl -o docker-compose.yml https://raw.githubusercontent.com/fish2018/pansou-web/refs/heads/main/docker-compose.yml
 
# 启动服务
docker-compose up -d
 
# 查看日志
docker-compose logs -f

2、纯后端API版

直接使用Docker命令
1
docker run -d --name pansou -p 8888:8888 -v pansou-cache:/app/cache -e CHANNELS="tgsearchers3,xxx" -e ENABLED_PLUGINS="labi,zhizhen,shandian,duoduo,muou,wanou" ghcr.io/fish2018/pansou:latest
使用Docker Compose（推荐）
1
2
3
4
5
6
7
8
# 下载配置文件
curl -o docker-compose.yml  https://raw.githubusercontent.com/fish2018/pansou/refs/heads/main/docker-compose.yml
 
# 启动服务
docker-compose up -d
 
# 访问服务
http://localhost:8888

从源码安装

环境要求

  • Go 1.18+
  • 可选：SOCKS5代理（用于访问受限地区的Telegram站点）
  1. 克隆仓库
1
2
git clone https://github.com/fish2018/pansou.git
cd pansou
  1. 配置环境变量（可选）

基础配置

环境变量 描述 默认值 说明
PORT 服务端口 8888 修改服务监听端口
PROXY SOCKS5代理 无 如：socks5://127.0.0.1:1080
CHANNELS 默认搜索的TG频道 tgsearchers3 多个频道用逗号分隔
ENABLED_PLUGINS 指定启用插件，多个插件用逗号分隔 无 必须显式指定
插件列表（请务必按需加载） 
export ENABLED_PLUGINS=hunhepan,jikepan,panwiki,pansearch,panta,qupansou,susu,thepiratebay,wanou,xuexizhinan,panyq,zhizhen,labi,muou,ouge,shandian,duoduo,huban,cyg,erxiao,miaoso,fox4k,pianku,clmao,wuji,cldi,xiaozhang,libvio,leijing,xb6v,xys,ddys,hdmoli,yuhuage,u3c3,javdb,clxiong,jutoushe,sdso,xiaoji,xdyh,haisou

高级配置（默认值即可）

点击展开高级配置选项（通常不需要修改）
环境变量 描述 默认值
CONCURRENCY 并发搜索数 自动计算
CACHE_TTL 缓存有效期（分钟） 60
CACHE_MAX_SIZE 最大缓存大小(MB) 100
PLUGIN_TIMEOUT 插件超时时间(秒) 30
ASYNC_RESPONSE_TIMEOUT 快速响应超时(秒) 4
ASYNC_LOG_ENABLED 异步插件详细日志 true
CACHE_PATH 缓存文件路径 ./cache
SHARD_COUNT 缓存分片数量 8
CACHE_WRITE_STRATEGY 缓存写入策略(immediate/hybrid) hybrid
ENABLE_COMPRESSION 是否启用压缩 false
MIN_SIZE_TO_COMPRESS 最小压缩阈值(字节) 1024
GC_PERCENT Go GC触发百分比 50
ASYNC_MAX_BACKGROUND_WORKERS 最大后台工作者数量 CPU核心数×5
ASYNC_MAX_BACKGROUND_TASKS 最大后台任务数量 工作者数×5
ASYNC_CACHE_TTL_HOURS 异步缓存有效期(小时) 1
ASYNC_PLUGIN_ENABLED 异步插件是否启用 true
HTTP_READ_TIMEOUT HTTP读取超时(秒) 自动计算
HTTP_WRITE_TIMEOUT HTTP写入超时(秒) 自动计算
HTTP_IDLE_TIMEOUT HTTP空闲超时(秒) 120
HTTP_MAX_CONNS HTTP最大连接数 自动计算
  1. 构建
1
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w -extldflags '-static'" -o pansou .
  1. 运行
1
./pansou

其他配置参考

点击展开 supervisor 配置参考 
1
2
3
4
5
6
7
8
9
10
11
12
[program:pansou]
environment=PORT=8888,CHANNELS="tgsearchers3,Aliyun_4K_Movies,bdbdndn11,yunpanx,bsbdbfjfjff,yp12**an,sbsbsns**,yunpanxunlei,tianyifc,BaiduCloudDisk,txtyzy,peccxinpd,gotopan,PanjClub,kkxlzy,bai***ZY,MCPH01,bdwpzhpd,ysxb48,jdjdn1111,yggpan,MCPH086,zaihuayun,Q66Share,Oscar_4Kmovies,ucwpzy,shareAliyun,alyp_1,dianyingshare,Quark_Movies,XiangxiuNBB,ydypzyfx,ucquark,xx12**an,yingshifenxiang123,zyfb123,tyypzhpd,tianyirigeng,cloudtianyi,hdhhd21,Lsp115,oneonefivewpfx,qixingzhenren,taoxgzy,Channel_Shares_115,tyysypzypd,vip115hot,wp123zy,yunpan139,yunpan189,yunpanuc,yydf_hzl,leoziyuan,pikpakpan,Q_dongman,yoyokuakeduanju",ENABLED_PLUGINS="labi,zhizhen,shandian,duoduo,muou"
command=/home/work/pansou/pansou
directory=/home/work/pansou
autostart=true
autorestart=true
startsecs=5
startretries=3
exitcodes=0
stopwaitsecs=10
stopasgroup=true
killasgroup=true
点击展开 nginx 配置参考 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
server {
    listen 80;
    server_name pansou.252035.xyz;
 
    # 将 HTTP 重定向到 HTTPS
    return 301 https://$host$request_uri;
}
 
limit_req_zone $binary_remote_addr zone=api_limit:10m rate=60r/m;
 
server {
    listen 443 ssl http2;
    server_name pansou.252035.xyz;
 
    access_log /home/work/logs/pansou.log;
 
    # 证书和密钥路径
    ssl_certificate /etc/letsencrypt/live/252035.xyz/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/252035.xyz/privkey.pem;
 
    # 增强 SSL 安全性
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH;
    ssl_prefer_server_ciphers on;
 
    # 后端代理，应用限流
    location / {
        # 应用限流规则
        limit_req zone=api_limit burst=10 nodelay;
        # 当超过限制时返回 429 状态码
        limit_req_status 429;
 
        proxy_pass http://127.0.0.1:8888;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

API文档

搜索API

搜索网盘资源。

接口地址：/api/search
请求方法：POST 或 GET
Content-Type：application/json（POST方法）

POST请求参数：

参数名 类型 必填 描述
kw string 是 搜索***
channels string[] 否 搜索的频道列表，不提供则使用默认配置
conc number 否 并发搜索数量，不提供则自动设置为频道数+插件数+10
refresh boolean 否 强制刷新，不使用缓存，便于调试和获取最新数据
res string 否 结果类型：all(返回所有结果)、results(仅返回results)、merge(仅返回merged_by_type)，默认为merge
src string 否 数据来源类型：all(默认，全部来源)、tg(仅Telegram)、plugin(仅插件)
plugins string[] 否 指定搜索的插件列表，不指定则搜索全部插件
cloud_types string[] 否 指定返回的网盘类型列表，支持：baidu、aliyun、quark、tianyi、uc、mobile、115、pikpak、xunlei、123、magnet、ed2k，不指定则返回所有类型
ext object 否 扩展参数，用于传递给插件的自定义参数，如{“title_en”:“English Title”, “is_all”:true}

GET请求参数：

参数名 类型 必填 描述
kw string 是 搜索***
channels string 否 搜索的频道列表，使用英文逗号分隔多个频道，不提供则使用默认配置
conc number 否 并发搜索数量，不提供则自动设置为频道数+插件数+10
refresh boolean 否 强制刷新，设置为"true"表示不使用缓存
res string 否 结果类型：all(返回所有结果)、results(仅返回results)、merge(仅返回merged_by_type)，默认为merge
src string 否 数据来源类型：all(默认，全部来源)、tg(仅Telegram)、plugin(仅插件)
plugins string 否 指定搜索的插件列表，使用英文逗号分隔多个插件名，不指定则搜索全部插件
cloud_types string 否 指定返回的网盘类型列表，使用英文逗号分隔多个类型，支持：baidu、aliyun、quark、tianyi、uc、mobile、115、pikpak、xunlei、123、magnet、ed2k，不指定则返回所有类型
ext string 否 JSON格式的扩展参数，用于传递给插件的自定义参数，如{“title_en”:“English Title”, “is_all”:true}

POST请求示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "kw": "速度与**",
  "channels": ["tgsearchers3", "xxx"],
  "conc": 2,
  "refresh": true,
  "res": "merge",
  "src": "all",
  "plugins": ["jikepan"],
  "cloud_types": ["baidu", "quark"],
  "ext": {
    "title_en": "Fast and Furious",
    "is_all": true
  }
}

GET请求示例：

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

成功响应：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
{
  "total": 15,
  "results": [
    {
      "message_id": "12345",
      "unique_id": "channel-12345",
      "channel": "tgsearchers3",
      "datetime": "2023-06-10T14:23:45Z",
      "title": "速度与**全集1-10",
      "content": "速度与**系列全集，1080P高清...",
      "links": [
        {
          "type": "baidu",
          "url": "https://pan.baidu.com/s/1abcdef",
          "password": "1234"
        }
      ],
      "tags": ["电影", "合集"],
      "images": [
        "https://cdn1.cdn-telegram.org/file/xxx.jpg"
      ]
    },
    // 更多结果...
  ],
  "merged_by_type": {
    "baidu": [
      {
        "url": "https://pan.baidu.com/s/1abcdef",
        "password": "1234",
        "note": "速度与**全集1-10",
        "datetime": "2023-06-10T14:23:45Z",
        "source": "tg:频道名称",
        "images": [
          "https://cdn1.cdn-telegram.org/file/xxx.jpg"
        ]
      },
      // 更多百度网盘链接...
    ],
    "quark": [
      {
        "url": "https://pan.quark.cn/s/xxxx",
        "password": "",
        "note": "凡人修仙传",
        "datetime": "2023-06-10T15:30:22Z",
        "source": "plugin:插件名",
        "images": []
      }
    ],
    "aliyun": [
      // 阿里云盘链接...
    ]
    // 更多网盘类型...
  }
}

字段说明：

  • source: 数据来源标识
    • tg:频道名称: 来自Telegram频道
    • plugin:插件名: 来自指定插件
    • unknown: 未知来源
  • images: TG消息中的图片链接数组（可选字段）
    • 仅在来源为Telegram频道且消息包含图片时出现

错误响应：

1
2
3
4
{
  "code": 400,
  "message": "***不能为空"
}

健康检查

检查API服务是否正常运行。

接口地址：/api/health
请求方法：GET

成功响应：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
  "channels_count": 1,
  "channels": [
    "tgsearchers3"
  ],
  "plugin_count": 16,
  "plugins": [
    "pansearch",
    "panta", 
    "qupansou",
    "hunhepan",
    "jikepan",
    "pan666",
    "panyq",
    "susu",
    "xuexizhinan",
    "hdr4k",
    "labi",
    "shandian",
    "duoduo",
    "muou",
    "wanou",
    "ouge",
    "zhizhen",
    "huban"
  ],
  "plugins_enabled": true,
  "status": "ok"
}

📄 许可证

本项目采用 MIT 许可证。详情请见 LICENSE 文件。

⭐ Star 历史

Star History Chart

免责声明 © 2025 - 虚宝阁

本站部分源码来源于网络，版权归属原开发者，用户仅获得使用权。依据《计算机软件保护条例》第十六条，禁止：

  • 逆向工程破解技术保护措施
  • 未经许可的分发行为
  • 去除源码中的原始版权标识

※ 本站源码仅用于学习和研究，禁止用于商业用途。如有侵权, 请及时联系我们进行处理。

侵权举报请提供： 侵权页面URL | 权属证明模板

响应时效：收到完整材料后48小时内处理

相关推荐

OpenIsle- 轻量级的Java开源社区系统

这是一个基于 Spring Boot 和 Vue3 构建的开源自由社区系统，定位为轻量级的 Discourse。它完全开源、可二次开发，支持白名单邀请、自定义标签、实时通知等功能。

393 2025-09-13

Claudable：基于 Next.js 框架的网站生成器

把你用自然语言描述的应用想法，直接变成可以运行的网站代码。Claudable 背后依赖强大的 AI 编程助手，主要是 Claude Code，也支持 Cursor CLI 来理解你的需求并生成代码。你不需要懂复杂的 API 设置、数据库配置或者部署流程：用简单的语言告诉 Claudable 你想要什么应用。

2525 2025-09-15

scira： AI 驱动搜索引擎

极简的 AI 驱动搜索引擎，支持引用来源

10827 2025-10-20

Trilium 开源个人知识库

这是一个专门为管理大量结构化笔记而设计的应用程序。 它的核心目标就是帮助你有效地收集、组织、链接和查找你积累的知识和信息。

31988 2025-09-15

Seelen-UI： 高度可定制的 Windows 桌面美化工具

一款免费开源的 Windows 桌面增强工具，专注于高度自定义和效率提升。它采用 Rust 语言开发，结合 Tauri 框架与 Web 技术，支持窗口平铺管理、应用启动器、Dock、任务栏、动态壁纸、插件扩展等功能。

13691 2025-10-04

ohmyzsh： 终端美化神器

Oh My Zsh是开源的Zsh配置管理器，装完终端瞬间变好看，还有自动补全、命令高亮、快捷别名，比如输“git st”就能代替“git status”，程序员敲命令快到飞起。 主要功能: 终端美化（支持几百个主题，比如经典的agnoster）；命令自动补全（输一半按Tab自动补全）；命令高亮（正确命令绿色，错误命令红色）；快捷别名（自定义命令缩写，比如“ll”代替“ls -l”）；插件扩展（比如git插件加很多git快捷命令）。

181910 2025-09-16

refine： 企业级React后台框架

这是一个专为构建 CRUD（增删改查）应用设计的 Web 框架，只需一行命令即可生成项目骨架，内置登录、列表、详情、编辑页面等功能。业务逻辑与 UI、路由完全解耦，可灵活集成 Ant Design、Material-UI 等设计系统，适用于快速开发管理后台、仪表盘、内部工具和 B2B 应用。

32865 2025-09-13

websocket-devtools： websocket调试浏览器插件

一款专业的 WebSocket 调试与流量控制浏览器插件，安装后会在 Chrome DevTools 面板中新增一个WebSocket DevTools标签页。支持 WebSocket 流量的实时监控、消息模拟和流量拦截等功能。

830 2025-10-02

markdown-it

markdown-it是一款快速且易扩展的Markdown解析器，遵循CommonMark规范并添加语法扩展。它配置灵活、速度快且安全，还有丰富的社区插件。

20415 2025-09-09

pyscript： 直接在浏览器中用 Python 创建应用程序

在 HTML 文件中直接使用 Python 编程语言，像 JavaScript 文件一样引入和执行 Python 代码，支持更小的 MicroPython、常见第三方库和操作页面元素等功能，适用于快速创建交互的数据可视化、网站原型和在线教育等 Web 应用场景。

18589 2025-10-04

热 榜

scira： AI 驱动搜索引擎

51018

image-compressor： 前端图片压缩库

21018

squish： 基于浏览器的图像压缩工具

9908

AirBattery： 隔空查看苹果设备电量的 Mac 工具

36031

Seelen-UI： 高度可定制的 Windows 桌面美化工具

17024

pyscript： 直接在浏览器中用 Python 创建应用程序

22267

pydoll： 无需 WebDriver 的浏览器自动化 Python 库

14772

pdfplumber： 轻松提取 PDF 文本和表格的 Python 库

24967

暂无数据

友情链接

Github-最大的开源仓库
Github
Gitee-国内开源仓库, github国内镜像仓库
Gitee