一、项目简介

PanSou 是一个基于 Go 语言开发的高性能网盘资源搜索 API 服务，由 fish2018 开源维护。

项目核心能力是：

聚合多个数据源（TG频道 + 插件系统 + 外部搜索源），实现统一搜索接口。

官方项目地址：
https://github.com/fish2018/pansou

---

✨ 项目特点

• 🚀 高性能并发搜索（多源同时查询）
• 🔌 插件化扩展机制
• 📡 支持 Telegram 频道资源抓取
• ☁️ 支持主流网盘资源分类（百度 / 阿里 / 夸克 / 迅雷等）
• 🐳 Docker 一键部署
• 📊 自动排序 + 去重 + 缓存优化

---

二、PanSou 架构说明

PanSou 本质是一个资源聚合搜索系统：

用户请求
   ↓
API 服务（PanSou）
   ↓
并发调用多个数据源
   ↓
TG频道 / 插件 / 外部API
   ↓
结果聚合 + 排序 + 去重
   ↓
返回 JSON / Web结果

---

三、环境要求

在安装之前，请确保：

• Docker 20+
• Docker Compose（推荐）
• Linux / Windows / macOS
• 端口：8888（默认 API）或 80（Web版本）

---

四、Docker 一键安装（推荐）

1. 拉取镜像

docker pull ghcr.io/fish2018/pansou:latest

---

2. 启动 API 服务

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

---

3. 访问服务

浏览器打开：

http://localhost:8888

如果是服务器：

http://你的IP:8888

---

五、Web 前端版本部署（可选）

如果你需要“网页可视化搜索界面”，可以使用 Web 版本：

1. 运行 Web UI

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

---

2. 访问页面

http://localhost

👉 这就是完整的“网盘资源搜索网页端”

---

六、Docker Compose 部署（推荐生产）

创建 docker-compose.yml：

version: "3"

services:
  pansou:
    image: ghcr.io/fish2018/pansou:latest
    container_name: pansou
    ports:
      - "8888:8888"
    restart: unless-stopped

启动：

docker compose up -d

---

七、API 使用说明

1. 搜索接口

GET /api/search?q=关键词

示例：

http://localhost:8888/api/search?q=电影

---

2. 返回结果（示例）

{
  "code": 200,
  "data": [
    {
      "title": "资源名称",
      "link": "网盘链接",
      "source": "telegram"
    }
  ]
}

---

八、支持的网盘类型

PanSou 支持识别多种网盘资源：

• 百度网盘
• 阿里云盘
• 夸克网盘
• 迅雷网盘
• 天翼云盘
• UC网盘
• 115网盘
• PikPak
• 磁力链接
• ED2K链接

---

九、环境变量（进阶配置）

常见配置：

---

十、常见问题（FAQ）

Q1：访问不了 8888 端口？

检查：

• Docker 是否运行
• 防火墙是否开放端口
• 是否被占用

---

Q2：搜索没有结果？

可能原因：

• TG频道未配置
• 网络无法访问外部源
• 插件未启用

---

Q3：Web 版和 API 版区别？

---

十一、部署建议

如果用于生产环境：

推荐配置：

• VPS 2核4G+
• Nginx 反向代理
• HTTPS（SSL证书）
• Redis缓存（可选）

---

十二、总结

PanSou 是一个典型的：

🔥 “多源聚合 + 高并发 + 插件化”的资源搜索系统

非常适合：

• 网盘资源搜索站
• 私有资源聚合系统
• API服务二次开发
• 站群/工具站项目