### [打造私有全能网盘搜索引擎 高性能开源项目 PanSou 深度部署教程](https://www.qiqiwa.com/article/517)

**Published:** 2026-03-13T08:56:34

**Author:** Hello

**Excerpt:** 在资源极其碎片化的今天，寻找一份网盘文件往往需要在百度网盘、阿里云盘、夸克、迅雷等多个平台间反复横跳，效率极低。虽然市面上有很多网盘搜索工具，但大多充满广告，且搜索源不可控。 PanSou 是一款专为极客打造的高性能网盘资源搜索 API 服

在资源极其碎片化的今天，寻找一份网盘文件往往需要在百度网盘、阿里云盘、夸克、迅雷等多个平台间反复横跳，效率极低。虽然市面上有很多网盘搜索工具，但大多充满广告，且搜索源不可控。

**PanSou** 是一款专为极客打造的高性能网盘资源搜索 API 服务。它不仅支持通过自定义插件抓取网页资源，还能直接通过 ✈️ 频道获取第一手的影视、软件与书籍。通过并发搜索技术，PanSou 能在几秒钟内聚合全网主流网盘的结果，并进行智能去重与排序。对于想要搭建属于自己的搜索站点或 API 服务的开发者来说，这无疑是目前最顶级的开源方案。

* * *

## 简介

**PanSou** (盘搜) 核心定位是一个“搜索引擎聚合器”。它解决了传统网盘搜索工具更新慢、来源单一、容易被封禁的痛点。

该项目采用 **Go 语言** 编写，通过异步插件系统和 ✈️ 爬虫机制，实现了秒级响应。其最大的特色在于集成了 **MCP (Model Context Protocol)** 协议，这意味着你可以直接将它接入 Claude 或 ChatGPT 等 AI 助手，让 AI 帮你找资源。

## 核心功能

-   **多源并发搜索**：同时检索数十个 ✈️ 频道及自定义插件源，速度快如闪电。 ⚡
-   **智能排序算法**：基于资源新鲜度、插件等级、关键词匹配度进行多维度权重排序。 🧠
-   **全平台网盘覆盖**：自动识别并分类百度、阿里、夸克、天翼、115、迅雷等 10+ 种网盘。 📂
-   **二级缓存机制**：内存 + 磁盘分片缓存，大幅降低重复请求，提升高并发下的稳定性。 🚀
-   **开箱即用**：提供 Docker 前后端集成镜像，一键启动完整搜索门户。 🐳
-   **安全认证**：可选的 JWT 认证系统，支持多用户管理，保护你的私有 API 不被滥用。 🔐

## 支持的网盘类型

| **类型名称** | **标识符** | **支持状态** |
| --- | --- | --- |
| **百度网盘** | `baidu` | ✅ 已支持 |
| **阿里云盘** | `aliyun` | ✅ 已支持 |
| **夸克网盘** | `quark` | ✅ 已支持 |
| **迅雷网盘** | `xunlei` | ✅ 已支持 |
| **115网盘** | `115` | ✅ 已支持 |
| **磁力/电驴** | `magnet / ed2k` | ✅ 已支持 |
| **其他 (移动/UC等)** | `mobile / uc / 123` | ✅ 已支持 |

* * *

## 准备工作

在开始部署之前，请确保你的服务器环境满足以下条件：

1.  **操作系统**：主流 Linux 发行版（Ubuntu/CentOS/Debian）。
2.  **基础环境**：已安装 **Docker** 和 **Docker Compose**。
3.  **网络环境**：
    -   若需搜索 ✈️ 频道资源，服务器需能访问 ✈️ 服务器（或配置 SOCKS5 代理）。 🌐
4.  **硬件要求**：最低 1 核 1G 内存（Go 语言极其节省资源）。

* * *

## 部署步骤

PanSou 提供了三种灵活的部署方案，建议根据你的需求选择。

### 方案一：前后端集成版 (推荐) 🌟

此方案包含美观的前端界面和强大的后端 API，适合直接搭建搜索门户。

#### 1\. 使用 Docker Compose 一键启动

创建 `docker-compose.yml` 文件：

```
curl -o docker-compose.yml https://raw.githubusercontent.com/fish2018/pansou-web/main/docker-compose.yml
```

启动服务：

```
docker-compose up -d
```

启动后，访问服务器 `http://IP` 即可看到搜索界面。

* * *

### 方案二：纯后端 API 版 🛠️

如果你只需要后端数据接口，用于自己的应用或小程序，请使用此方案。

#### 1\. 快速启动命令

```
docker run -d --name pansou-api \
  -p 8888:8888 \
  -e PORT=8888 \
  ghcr.io/fish2018/pansou:latest
```

#### 2\. 配置 SOCKS5 代理 (抓取 TG 必备)

如果你的服务器在国内，需要配置代理才能正常抓取 ✈️ 的数据：

```
docker run -d --name pansou-api \
  -p 8888:8888 \
  -e PROXY=socks5://127.0.0.1:1080 \
  -e ENABLED_PLUGINS="labi,zhizhen,shandian" \
  ghcr.io/fish2018/pansou:latest
```

* * *

### 方案三：源码编译安装 💻

适合开发者进行二次开发。

#### 1\. 环境要求

-   Go 1.18+

#### 2\. 克隆与编译

```
git clone https://github.com/fish2018/pansou.git
cd pansou
# 编译
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o pansou .
# 运行
./pansou
```

* * *

### 进阶：配置安全认证 (JWT)

为了防止 API 被盗刷，你可以启用认证功能：

修改环境变量或在 Docker 启动时加入：

-   `AUTH_ENABLED=true`
-   `AUTH_USERS=admin:password123` (格式为：用户名:密码)

启用后，所有 API 请求需在 Header 中携带 `Authorization: Bearer <token>`。

* * *

## 总结评价

**优点**：

-   **性能极佳**：Go 语言的并发优势在多源搜索中体现得淋漓尽致，几乎没有延迟感。 🚄
-   **数据源丰富**：TG 频道+插件模式保证了资源的覆盖面，尤其在影视资源上非常强势。 🎬
-   **架构优雅**：支持 MCP 协议和异步处理模式，扩展性极强。 🏗️

**缺点**：

-   **网络门槛**：✈️ 爬虫功能依赖代理，对于部分小白用户有一定的网络配置成本。 📶
-   **前端局限**：集成的 Web 端虽简洁，但自定义样式略显繁琐。 🎨

**适用建议**：

如果你想建立一个私人的资源库，或者为你的社群提供资源搜索服务，PanSou 是目前性能最优、配置最灵活的开源方案。

* * *

## 项目地址

| **资源名称** | **链接地址** |
| --- | --- |
| **GitHub 主仓库** | [fish2018/pansou](https://github.com/fish2018/pansou) |
| **演示地址** | [so.252035.xyz](https://so.252035.xyz/) |

**Tags:** 开源项目

**Categories:** 图床程序

---