Skip to content
/ pansou2 Public
forked from fish2018/pansou

PanSou（GoComicMosaic的独立子项目）是一款高性能的网盘资源搜索API服务，支持TG频道和插件搜索。系统设计以性能和可扩展性为核心，支持多频道多插件并发搜索、结果智能排序和网盘类型分类。https://so.252035.xyz/

pansou.252035.xyz/api/search?kw=凡人修仙传
0 stars 705 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

fishforks/pansou2

BranchesTags
 
 

Repository files navigation

PanSou 网盘搜索API

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

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

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

支持的网盘类型

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

快速开始

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

环境要求

  • Go 1.18+
  • 可选：SOCKS5代理（用于访问受限地区的Telegram站点）

使用Docker部署

方法1：使用Docker Compose（推荐）

  1. 下载docker-compose.yml文件
wget https://raw.githubusercontent.com/fish2018/pansou/main/docker-compose.yml
  1. 启动服务
docker-compose up -d
  1. 访问服务
http://localhost:8888

方法2：直接使用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

从源码安装

  1. 克隆仓库
git clone https://github.com/fish2018/pansou.git
cd pansou
  1. 配置环境变量（可选）
环境变量 描述 默认值
CHANNELS 默认搜索频道列表（逗号分隔） tgsearchers2
CONCURRENCY 默认并发数 频道数+插件数+10
PORT 服务端口 8888
PROXY SOCKS5代理 -
CACHE_ENABLED 是否启用缓存 true
CACHE_PATH 缓存文件路径 ./cache
CACHE_MAX_SIZE 最大缓存大小(MB) 100
CACHE_TTL 缓存生存时间(分钟) 60
SHARD_COUNT 缓存分片数量 8
SERIALIZER_TYPE 序列化器类型(gob/json) gob
CACHE_WRITE_STRATEGY 缓存写入策略(immediate/hybrid) hybrid
ENABLE_COMPRESSION 是否启用压缩 false
MIN_SIZE_TO_COMPRESS 最小压缩阈值(字节) 1024
GC_PERCENT GC触发百分比 100
OPTIMIZE_MEMORY 是否优化内存 true
PLUGIN_TIMEOUT 插件执行超时时间(秒) 30
ASYNC_PLUGIN_ENABLED 是否启用异步插件 true
ASYNC_RESPONSE_TIMEOUT 异步响应超时时间(秒) 4
ASYNC_MAX_BACKGROUND_WORKERS 最大后台工作者数量 CPU核心数×5，最小20
ASYNC_MAX_BACKGROUND_TASKS 最大后台任务数量 工作者数量×5，最小100
ASYNC_CACHE_TTL_HOURS 异步缓存有效期(小时) 1
HTTP_READ_TIMEOUT HTTP读取超时时间(秒) 自动计算，最小30
HTTP_WRITE_TIMEOUT HTTP写入超时时间(秒) 自动计算，最小60
HTTP_IDLE_TIMEOUT HTTP空闲连接超时时间(秒) 120
HTTP_MAX_CONNS HTTP最大并发连接数 CPU核心数×25，最小100，最大500
ASYNC_LOG_ENABLED 异步插件详细日志开关 true

🔧 性能优化配置

为不同环境提供的优化配置方案：

macOS/笔记本电脑配置 (推荐)

# 针对macOS系统线程限制优化的配置
export HTTP_MAX_CONNS=200                   # 降低连接数
export ASYNC_MAX_BACKGROUND_WORKERS=15     # 减少工作者数量  
export ASYNC_MAX_BACKGROUND_TASKS=75       # 减少任务队列
export CONCURRENCY=30                      # 适中的并发数
export ASYNC_LOG_ENABLED=false             # 关闭详细日志

服务器/云环境配置

# 高性能服务器配置
export HTTP_MAX_CONNS=500                   # 更高的连接数
export ASYNC_MAX_BACKGROUND_WORKERS=40     # 更多工作者
export ASYNC_MAX_BACKGROUND_TASKS=200      # 更大任务队列
export CONCURRENCY=50                      # 高并发数
export CACHE_MAX_SIZE=500                  # 更大缓存
export ASYNC_LOG_ENABLED=false             # 关闭详细日志

资源受限环境配置

# 低配置服务器或容器环境
export HTTP_MAX_CONNS=100                   # 最低连接数
export ASYNC_MAX_BACKGROUND_WORKERS=8      # 最少工作者
export ASYNC_MAX_BACKGROUND_TASKS=40       # 最小任务队列
export CONCURRENCY=15                      # 低并发数
export CACHE_MAX_SIZE=50                   # 较小缓存
  1. 构建
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w -extldflags '-static'" -o pansou .
  1. 运行
./pansou

其他配置参考

supervisor配置参考

[program:pansou]
environment=PORT=8888,CHANNELS="tgsearchers2,yunpanxunlei,tianyifc,BaiduCloudDisk,txtyzy,peccxinpd,gotopan,xingqiump4,yunpanqk,PanjClub,kkxlzy,baicaoZY,MCPH01,share_aliyun,bdwpzhpd,ysxb48,jdjdn1111,yggpan,MCPH086,zaihuayun,Q66Share,NewAliPan,ypquark,Oscar_4Kmovies,ucwpzy,alyp_TV,alyp_4K_Movies,shareAliyun,alyp_1,dianyingshare,Quark_Movies,XiangxiuNBB,NewQuark,ydypzyfx,kuakeyun,ucquark,xx123pan,yingshifenxiang123,zyfb123,tyypzhpd,tianyirigeng,cloudtianyi,hdhhd21,Lsp115,oneonefivewpfx,Maidanglaocom,qixingzhenren,taoxgzy,tgsearchers115,Channel_Shares_115,tyysypzypd,vip115hot,wp123zy,yunpan139,yunpan189,yunpanuc,yydf_hzl,alyp_Animation,alyp_JLP,leoziyuan"
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配置参考

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请求示例：

{
  "kw": "速度与激情",
  "channels": ["tgsearchers2", "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请求示例：

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

成功响应：

{
  "total": 15,
  "results": [
    {
      "message_id": "12345",
      "unique_id": "channel-12345",
      "channel": "tgsearchers2",
      "datetime": "2023-06-10T14:23:45Z",
      "title": "速度与激情全集1-10",
      "content": "速度与激情系列全集，1080P高清...",
      "links": [
        {
          "type": "baidu",
          "url": "https://pan.baidu.com/s/1abcdef",
          "password": "1234"
        }
      ],
      "tags": ["电影", "合集"]
    },
    // 更多结果...
  ],
  "merged_by_type": {
    "baidu": [
      {
        "url": "https://pan.baidu.com/s/1abcdef",
        "password": "1234",
        "note": "速度与激情全集1-10",
        "datetime": "2023-06-10T14:23:45Z",
        "source": "tg:频道名称"
      },
      // 更多百度网盘链接...
    ],
    "quark": [
      {
        "url": "https://pan.quark.cn/s/xxxx",
        "password": "",
        "note": "凡人修仙传",
        "datetime": "2023-06-10T15:30:22Z",
        "source": "plugin:插件名"
      }
    ],
    "aliyun": [
      // 阿里云盘链接...
    ]
    // 更多网盘类型...
  }
}

字段说明：

  • source: 数据来源标识
    • tg:频道名称: 来自Telegram频道
    • plugin:插件名: 来自指定插件
    • unknown: 未知来源

错误响应：

{
  "code": 400,
  "message": "关键词不能为空"
}

健康检查

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

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

成功响应：

{
  "channels": [
    "tgsearchers2"
  ],
  "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"
}

⭐ Star 历史

Star History Chart

About

PanSou（GoComicMosaic的独立子项目）是一款高性能的网盘资源搜索API服务，支持TG频道和插件搜索。系统设计以性能和可扩展性为核心，支持多频道多插件并发搜索、结果智能排序和网盘类型分类。https://so.252035.xyz/

pansou.252035.xyz/api/search?kw=凡人修仙传

Resources

Readme
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages

  • Go 99.6%
  • Dockerfile 0.4%