1. PanSou项目简介PanSou是一款开源的网盘搜索引擎项目它能够聚合多个主流网盘资源提供高效的搜索服务。这个项目最大的特点就是采用了前后端一体化设计通过Docker容器化技术实现一键部署真正做到开箱即用。我第一次接触PanSou是在搭建家庭NAS时当时正为如何快速查找分散在各个网盘的资源而头疼。传统的做法需要逐个登录不同网盘进行搜索效率极低。而PanSou完美解决了这个问题它支持包括百度网盘、阿里云盘、夸克网盘等13种主流网盘资源的统一搜索。这个项目采用Go语言开发性能非常出色。实测在4核CPU、8GB内存的服务器上单节点就能轻松应对每秒数百次的搜索请求。项目作者还设计了智能缓存机制对热门搜索关键词的结果进行缓存大幅提升了重复查询的响应速度。2. 环境准备与安装2.1 硬件要求PanSou对硬件要求并不高以下是推荐配置CPU至少2核4核以上更佳内存4GB起步8GB可更好应对高并发存储20GB可用空间主要用于存放Docker镜像和缓存数据我自己的测试环境是一台树莓派4B4核ARM Cortex-A728GB内存运行起来完全没问题。如果你有闲置的NAS设备完全可以利用起来部署PanSou。2.2 软件依赖安装前需要确保系统已安装以下组件Docker Engine 20.10.0或更高版本Docker Compose 1.29.0或更高版本可选在Ubuntu系统上可以通过以下命令一键安装Dockercurl -fsSL https://get.docker.com | sh sudo usermod -aG docker $USER安装完成后记得注销重新登录使docker用户组权限生效。3. 使用Docker快速部署3.1 基础部署方式最简单的部署方式是直接使用docker run命令docker run -d \ --name pansou \ -p 80:80 \ -v pansou-data:/app/data \ ghcr.io/fish2018/pansou-web:latest这个命令会从GitHub容器仓库拉取最新镜像创建名为pansou的容器将容器80端口映射到主机80端口创建持久化数据卷pansou-data部署完成后在浏览器访问http://你的服务器IP 就能看到PanSou的Web界面了。3.2 使用Docker Compose部署对于生产环境我推荐使用Docker Compose方式部署便于管理。首先创建docker-compose.yml文件version: 3.8 services: pansou: image: ghcr.io/fish2018/pansou-web:latest container_name: pansou restart: unless-stopped ports: - 80:80 volumes: - pansou-data:/app/data - ./logs:/app/logs environment: - CACHE_TTL60 - CACHE_MAX_SIZE100 volumes: pansou-data:然后执行以下命令启动服务docker-compose up -d这种方式的优势在于配置文件可版本控制方便调整环境变量参数日志文件直接挂载到主机目录支持一键更新和回滚4. 高级配置与优化4.1 性能调优参数PanSou提供了丰富的高级配置选项可以通过环境变量进行调整docker run -d \ --name pansou \ -p 80:80 \ -e CONCURRENCY8 \ -e CACHE_TTL120 \ -e CACHE_MAX_SIZE200 \ -e PLUGIN_TIMEOUT30 \ ghcr.io/fish2018/pansou-web关键参数说明CONCURRENCY并发搜索线程数建议设置为CPU核心数的1.5-2倍CACHE_TTL缓存有效期分钟热门资源可适当延长CACHE_MAX_SIZE最大缓存大小MBPLUGIN_TIMEOUT插件超时时间秒4.2 自定义搜索频道PanSou支持自定义Telegram搜索频道配置方法如下docker run -d \ --name pansou \ -p 80:80 \ -e CHANNELStgsearchers2,yunpanxunlei \ ghcr.io/fish2018/pansou-web多个频道用英文逗号分隔。建议开始时使用项目默认频道熟悉后再根据需要添加。5. 实际使用体验5.1 Web界面操作PanSou的Web界面非常简洁直观顶部是搜索框输入关键词即可搜索左侧可以按网盘类型筛选结果右侧显示搜索结果包含文件大小、分享时间等信息我测试搜索速度与激情时不到2秒就返回了来自百度网盘、阿里云盘等平台的数十条结果。每个结果都清晰标注了来源平台点击可直接跳转到对应网盘页面。5.2 API接口调用对于开发者PanSou还提供了完善的RESTful APIcurl -X GET http://localhost/api/search?kw速度与激情resmergeAPI返回的JSON数据结构规范包含以下关键字段total总结果数results原始结果列表merged_by_type按网盘类型分组的结果6. 常见问题解决6.1 容器启动失败如果容器启动失败首先检查日志docker logs pansou常见问题及解决方法端口冲突修改主机端口映射如-p 8080:80权限问题确保/app/data目录可写内存不足增加Docker内存分配或调整缓存参数6.2 搜索速度慢遇到搜索速度变慢时可以尝试增加CONCURRENCY值提升并发数检查网络连接特别是到Telegram服务器的延迟适当增加PLUGIN_TIMEOUT避免超时7. 安全注意事项建议不要将服务直接暴露在公网可以通过Nginx添加基础认证定期备份/app/data目录下的重要数据关注项目GitHub页面的安全更新对于敏感搜索内容可以设置CACHE_TTL0禁用缓存我在实际使用中发现配合Cloudflare的CDN和防火墙规则可以很好地保护服务安全。同时建议设置容器资源限制避免被恶意请求耗尽资源。
PanSou：打造私有化网盘搜索引擎的Docker实战指南
1. PanSou项目简介PanSou是一款开源的网盘搜索引擎项目它能够聚合多个主流网盘资源提供高效的搜索服务。这个项目最大的特点就是采用了前后端一体化设计通过Docker容器化技术实现一键部署真正做到开箱即用。我第一次接触PanSou是在搭建家庭NAS时当时正为如何快速查找分散在各个网盘的资源而头疼。传统的做法需要逐个登录不同网盘进行搜索效率极低。而PanSou完美解决了这个问题它支持包括百度网盘、阿里云盘、夸克网盘等13种主流网盘资源的统一搜索。这个项目采用Go语言开发性能非常出色。实测在4核CPU、8GB内存的服务器上单节点就能轻松应对每秒数百次的搜索请求。项目作者还设计了智能缓存机制对热门搜索关键词的结果进行缓存大幅提升了重复查询的响应速度。2. 环境准备与安装2.1 硬件要求PanSou对硬件要求并不高以下是推荐配置CPU至少2核4核以上更佳内存4GB起步8GB可更好应对高并发存储20GB可用空间主要用于存放Docker镜像和缓存数据我自己的测试环境是一台树莓派4B4核ARM Cortex-A728GB内存运行起来完全没问题。如果你有闲置的NAS设备完全可以利用起来部署PanSou。2.2 软件依赖安装前需要确保系统已安装以下组件Docker Engine 20.10.0或更高版本Docker Compose 1.29.0或更高版本可选在Ubuntu系统上可以通过以下命令一键安装Dockercurl -fsSL https://get.docker.com | sh sudo usermod -aG docker $USER安装完成后记得注销重新登录使docker用户组权限生效。3. 使用Docker快速部署3.1 基础部署方式最简单的部署方式是直接使用docker run命令docker run -d \ --name pansou \ -p 80:80 \ -v pansou-data:/app/data \ ghcr.io/fish2018/pansou-web:latest这个命令会从GitHub容器仓库拉取最新镜像创建名为pansou的容器将容器80端口映射到主机80端口创建持久化数据卷pansou-data部署完成后在浏览器访问http://你的服务器IP 就能看到PanSou的Web界面了。3.2 使用Docker Compose部署对于生产环境我推荐使用Docker Compose方式部署便于管理。首先创建docker-compose.yml文件version: 3.8 services: pansou: image: ghcr.io/fish2018/pansou-web:latest container_name: pansou restart: unless-stopped ports: - 80:80 volumes: - pansou-data:/app/data - ./logs:/app/logs environment: - CACHE_TTL60 - CACHE_MAX_SIZE100 volumes: pansou-data:然后执行以下命令启动服务docker-compose up -d这种方式的优势在于配置文件可版本控制方便调整环境变量参数日志文件直接挂载到主机目录支持一键更新和回滚4. 高级配置与优化4.1 性能调优参数PanSou提供了丰富的高级配置选项可以通过环境变量进行调整docker run -d \ --name pansou \ -p 80:80 \ -e CONCURRENCY8 \ -e CACHE_TTL120 \ -e CACHE_MAX_SIZE200 \ -e PLUGIN_TIMEOUT30 \ ghcr.io/fish2018/pansou-web关键参数说明CONCURRENCY并发搜索线程数建议设置为CPU核心数的1.5-2倍CACHE_TTL缓存有效期分钟热门资源可适当延长CACHE_MAX_SIZE最大缓存大小MBPLUGIN_TIMEOUT插件超时时间秒4.2 自定义搜索频道PanSou支持自定义Telegram搜索频道配置方法如下docker run -d \ --name pansou \ -p 80:80 \ -e CHANNELStgsearchers2,yunpanxunlei \ ghcr.io/fish2018/pansou-web多个频道用英文逗号分隔。建议开始时使用项目默认频道熟悉后再根据需要添加。5. 实际使用体验5.1 Web界面操作PanSou的Web界面非常简洁直观顶部是搜索框输入关键词即可搜索左侧可以按网盘类型筛选结果右侧显示搜索结果包含文件大小、分享时间等信息我测试搜索速度与激情时不到2秒就返回了来自百度网盘、阿里云盘等平台的数十条结果。每个结果都清晰标注了来源平台点击可直接跳转到对应网盘页面。5.2 API接口调用对于开发者PanSou还提供了完善的RESTful APIcurl -X GET http://localhost/api/search?kw速度与激情resmergeAPI返回的JSON数据结构规范包含以下关键字段total总结果数results原始结果列表merged_by_type按网盘类型分组的结果6. 常见问题解决6.1 容器启动失败如果容器启动失败首先检查日志docker logs pansou常见问题及解决方法端口冲突修改主机端口映射如-p 8080:80权限问题确保/app/data目录可写内存不足增加Docker内存分配或调整缓存参数6.2 搜索速度慢遇到搜索速度变慢时可以尝试增加CONCURRENCY值提升并发数检查网络连接特别是到Telegram服务器的延迟适当增加PLUGIN_TIMEOUT避免超时7. 安全注意事项建议不要将服务直接暴露在公网可以通过Nginx添加基础认证定期备份/app/data目录下的重要数据关注项目GitHub页面的安全更新对于敏感搜索内容可以设置CACHE_TTL0禁用缓存我在实际使用中发现配合Cloudflare的CDN和防火墙规则可以很好地保护服务安全。同时建议设置容器资源限制避免被恶意请求耗尽资源。
