一键部署PanSou：打造私有网盘资源搜索引擎的Docker全攻略

December 1, 2025

认识PanSou：高性能网盘搜索利器

PanSou是一款专注于性能与可扩展性的网盘资源搜索API服务。它不仅支持Telegram频道搜索，还拥有插件扩展能力。其核心设计理念在于实现多频道、多插件的并发搜索，并对搜索结果进行智能排序与网盘类型分类。通过Docker容器技术，项目集成了完整的前后端，旨在实现一键启动、开箱即用的便捷体验。

简而言之，你可以通过Docker将其部署在NAS设备上，随后通过网页访问服务，轻松搜索并转存所需的各类网盘资源。

项目的原始仓库可在GitHub上搜索 fish2018/pansou-web 找到。

广泛兼容的网盘类型

PanSou支持自动识别并分类展示多种主流网盘及下载协议的链接，具体包括：

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

核心功能特性详解

高性能并发搜索：系统采用工作池设计，能够并发执行多个Telegram频道及异步插件的搜索任务，从而显著提升整体搜索速度与效率。
智能网盘类型识别：自动解析并归类搜索结果中的链接，按照不同网盘类型清晰展示，方便用户筛选。
多维度的智能排序算法：排序机制综合考虑插件优先级、资源发布时间的新鲜度以及用户设定的关键词优先级，力求呈现最相关、最优质的搜索结果。
灵活的异步插件系统：支持通过插件扩展搜索源。该系统采用“尽快响应，持续处理”的异步模式，有效解决了某些外部搜索源响应延迟的问题，具体开发规范可参考项目插件指南。
高效的二级缓存机制：结合了分片内存缓存与分片磁盘缓存，极大提升了重复查询的响应速度，并增强了服务在高并发场景下的性能表现。

详细部署流程指南

本文将以威联通（QNAP）NAS为例，演示如何使用Docker Compose部署PanSou的简约版本。

部署所需的核心Docker Compose配置代码如下，你可以根据自身环境进行调整：

services:
  pansou:
    image: ghcr.io/fish2018/pansou-web:latest
    container_name: pansou-app
    ports:
      - "17080:80" # 左侧主机端口可按需修改
    environment:
      - DOMAIN=localhost # 若配置反向代理，请替换为您的域名
      - PANSOU_PORT=8888 # 后端API服务端口
      - PANSOU_HOST=127.0.0.1 # 后端API服务地址
    volumes:
      - /share/Container/pansou/data:/app/data # 数据持久化目录
      - /share/Container/pansou/logs:/app/logs # 日志持久化目录
    restart: always

请注意，项目中还有更多高级配置选项，建议访问项目页面以获取完整信息。

在威联通的Container Station管理工具中，创建一个新的应用程序，将上述代码粘贴至编辑框内，根据实际情况修改路径或端口后，启动部署并等待容器安装完成。

此外，也附上直接使用 docker run 命令的部署方式，相关环境变量请按需修改：

docker run -d \
  --name pansou \
  -p 17080:80 \
  -e DOMAIN=localhost \
  -e PANSOU_PORT=8888 \
  -e PANSOU_HOST=127.0.0.1 \
  -v /share/Container/pansou/data:/app/data \
  -v /share/Container/pansou/logs:/app/logs \
  --restart unless-stopped \
  ghcr.io/fish2018/pansou-web:latest