PanSou 网盘搜索API

特性(详见系统设计文档)

MCP 服务

支持的网盘类型

快速开始

使用Docker部署

1、前后端集成版

直接使用Docker命令

docker run -d --name pansou -p 80:80 ghcr.io/fish2018/pansou-web

使用Docker Compose(推荐)

# 下载配置文件
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命令

docker run -d --name pansou -p 8888:8888 ghcr.io/fish2018/pansou:latest

使用Docker Compose(推荐)

# 下载配置文件
curl -o docker-compose.yml https://raw.githubusercontent.com/fish2018/pansou/refs/heads/main/docker-compose.yml
# 启动服务
docker-compose up -d
# 访问服务
http://localhost:8888

从源码安装

环境要求

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

基础配置

认证配置(可选)

# 启用认证并配置单个用户
docker run -d --name pansou -p 8888:8888 \
 -e AUTH_ENABLED=true \
 -e AUTH_USERS=admin:admin123 \
 -e AUTH_TOKEN_EXPIRY=24 \
 ghcr.io/fish2018/pansou:latest
# 配置多个用户
docker run -d --name pansou -p 8888:8888 \
 -e AUTH_ENABLED=true \
 -e AUTH_USERS=admin:pass123,user1:pass456,user2:pass789 \
 ghcr.io/fish2018/pansou:latest

# 1. 登录获取Token
curl -X POST http://localhost:8888/api/auth/login \
 -H "Content-Type: application/json" \
 -d '{"username":"admin","password":"admin123"}'
# 响应:{"token":"eyJhbGc...","expires_at":1234567890,"username":"admin"}
# 2. 使用Token调用搜索API
curl -X POST http://localhost:8888/api/search \
 -H "Authorization: Bearer eyJhbGc..." \
 -H "Content-Type: application/json" \
 -d '{"kw":"速度与激情"}'

高级配置(默认值即可)

CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w -extldflags '-static'" -o pansou .

./pansou

其他配置参考

API文档

认证说明

Authorization: Bearer <your-jwt-token>

# 未启用认证时
curl -X POST http://localhost:8888/api/search \
 -H "Content-Type: application/json" \
 -d '{"kw":"速度与激情"}'
# 启用认证时
curl -X POST http://localhost:8888/api/search \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer eyJhbGc..." \
 -d '{"kw":"速度与激情"}'

认证API

用户登录

curl -X POST http://localhost:8888/api/auth/login \
 -H "Content-Type: application/json" \
 -d '{"username":"admin","password":"admin123"}'

{
 "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
 "expires_at": 1234567890,
 "username": "admin"
}

{
 "error": "用户名或密码错误"
}

验证Token

curl -X POST http://localhost:8888/api/auth/verify \
 -H "Authorization: Bearer eyJhbGc..."

{
 "valid": true,
 "username": "admin"
}

退出登录

curl -X POST http://localhost:8888/api/auth/logout

{
 "message": "退出成功"
}

搜索API

# 未启用认证
curl -X POST http://localhost:8888/api/search \
 -H "Content-Type: application/json" \
 -d '{
 "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
 }
 }'
# 启用认证时(需要添加Authorization头)
curl -X POST http://localhost:8888/api/search \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
 -d '{
 "kw": "速度与激情",
 "res": "merge"
 }'
# 使用过滤器(只返回包含"合集"或"全集",且不包含"预告"或"花絮"的结果)
curl -X POST http://localhost:8888/api/search \
 -H "Content-Type: application/json" \
 -d '{
 "kw": "唐朝诡事录",
 "filter": {
 "include": ["合集", "全集"],
 "exclude": ["预告", "花絮"]
 }
 }'

# 未启用认证
curl "http://localhost:8888/api/search?kw=速度与激情&res=merge&src=tg"
# 启用认证时(需要添加Authorization头)
curl "http://localhost:8888/api/search?kw=速度与激情&res=merge" \
 -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
# 使用过滤器(GET方式需要URL编码JSON)
curl "http://localhost:8888/api/search?kw=唐朝诡事录&filter=%7B%22include%22%3A%5B%22合集%22%2C%22全集%22%5D%2C%22exclude%22%3A%5B%22预告%22%5D%7D"

{
 "total": 15,
 "results": [
 {
 "message_id": "12345",
 "unique_id": "channel-12345",
 "channel": "tgsearchers3",
 "datetime": "2023年06月10日T14:23:45Z",
 "title": "速度与激情全集1-10",
 "content": "速度与激情系列全集,1080P高清...",
 "links": [
 {
 "type": "baidu",
 "url": "https://pan.baidu.com/s/1abcdef",
 "password": "1234",
 "datetime": "2023年06月10日T14:23:45Z",
 "work_title": "速度与激情全集1-10"
 }
 ],
 "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月10日T14: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月10日T15:30:22Z",
 "source": "plugin:插件名",
 "images": []
 }
 ],
 "aliyun": [
 // 阿里云盘链接...
 ]
 // 更多网盘类型...
 }
}

// 参数错误
{
 "code": 400,
 "message": "关键词不能为空"
}
// 未授权(启用认证但未提供Token)
{
 "error": "未授权:缺少认证令牌",
 "code": "AUTH_TOKEN_MISSING"
}
// Token无效或过期
{
 "error": "未授权:令牌无效或已过期",
 "code": "AUTH_TOKEN_INVALID"
}

健康检查

curl http://localhost:8888/api/health

{
 "status": "ok",
 "auth_enabled": true,
 "plugins_enabled": true,
 "plugin_count": 16,
 "plugins": [
 "pansearch",
 "panta", 
 "qupansou",
 "hunhepan",
 "jikepan",
 "pan666",
 "panyq",
 "susu",
 "xuexizhinan",
 "hdr4k",
 "labi",
 "shandian",
 "duoduo",
 "muou",
 "wanou",
 "ouge",
 "zhizhen",
 "huban"
 ],
 "channels_count": 1,
 "channels": [
 "tgsearchers3"
 ]
}

📄 许可证

⭐ Star 历史