PanSou网盘资源在线搜索神器（基于Docker部署）

体验链接🎉

https://so.8dui.com

简介

PanSou 是一款实用的搜索工具，本教程将指导你通过 Docker 快速部署 PanSou 服务，采用官方最新镜像，配置简单且支持数据持久化。

官方GitHub：https://github.com/fish2018/pansou

准备工作

环境要求

已安装 Docker 环境（Docker Engine 20.10+）
具备至少 1GB 可用内存
网络连接正常（用于拉取镜像）

检查 Docker 环境

# 检查 Docker 是否安装成功
docker --version

# 检查 Docker 服务是否运行
systemctl status docker

部署步骤「以绿联NAS为例」

1. 创建部署目录

首先创建一个专门的目录用于存放 PanSou 的配置和数据文件：

# 创建主目录
mkdir -p /volume2/docker/PanSou

# 进入目录
cd /volume2/docker/PanSou

2. 创建 Docker Compose 配置文件

在上述目录中创建 docker-compose.yml 文件：

PanSou Docker Compose 配置文件

services:
  pansou:
    # 使用官方镜像
    image: ghcr.io/fish2018/pansou-web
    # 容器名称，便于管理
    container_name: PanSou
    # 端口映射：宿主机8880端口映射到容器80端口
    ports:
      - 8880:80
    # 环境变量配置
    environment:
      # 基础配置
      - DOMAIN=localhost               # 访问域名，本地部署用localhost
      - PANSOU_PORT=8888               # 应用内部端口
      - PANSOU_HOST=127.0.0.1          # 应用绑定地址
      # 代理配置（可选，根据需要启用）
      # - SOCKS5_PROXY=socks5://10.10.1.2:7893  # SOCKS5代理地址
      # - HTTP_PROXY=http://10.10.1.2:7893      # HTTP代理地址

    # 数据持久化配置
    volumes:
      - /volume2/docker/PanSou/data:/app/data   # 修改为实际应用数据存储目录
      - /volume2/docker/PanSou/log:/app/logs    # 修改为实际日志文件存储目录

    # 重启策略：除非手动停止，否则总是重启
    restart: unless-stopped
    # 健康检查配置
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost/api/health"]  # 健康检查命令
      interval: 30s       # 检查间隔
      timeout: 10s        # 超时时间
      retries: 3          # 重试次数
      start_period: 40s   # 启动等待时间

3. 启动服务

在配置文件所在目录执行以下命令启动 PanSou：

# 启动服务（后台运行）
docker-compose up -d

# 查看容器运行状态
docker-compose ps

4. 验证部署

打开浏览器访问以下地址验证服务是否正常启动：

http://NAS-IP:8880

如果看到 PanSou 的界面，则表示部署成功。

资源非常的多！！！

配置说明

核心配置项解释

配置项	说明	建议值
DOMAIN	访问域名	本地使用localhost，服务器使用实际域名或 IP
PANSOU_PORT	应用内部端口	保持默认 8888 即可
PANSOU_HOST	应用绑定地址	保持默认 127.0.0.1 即可
SOCKS5_PROXY	SOCKS5 代理（可选）	需要时填写实际代理地址
HTTP_PROXY	HTTP 代理（可选）	需要时填写实际代理地

端口映射说明

配置中的 8880:80 表示将宿主机的 8880 端口映射到容器内的 80 端口，

如果你需要使用其他端口（例如 18080 端口），可以修改为 18080:80。

日常管理

查看日志

# 查看实时日志
docker-compose logs -f pansou

# 查看最近100行日志
docker-compose logs --tail=100 pansou

停止服务

docker-compose down

重启服务

docker-compose restart

更新服务

# 拉取最新镜像
docker-compose pull

# 重启服务以应用更新
docker-compose up -d

数据备份与恢复

备份数据

PanSou 的所有数据都存储在 /volume2/docker/PanSou/data 目录，只需备份该目录即可：

# 创建备份
tar -zcvf pansou_backup_$(date +%Y%m%d).tar.gz /volume2/docker/PanSou/data

恢复数据

将备份文件解压到数据目录即可恢复：

# 解压备份到数据目录
tar -zxvf pansou_backup_20231001.tar.gz -C /volume2/docker/PanSou/

常见问题

无法访问服务
- 检查容器是否正常运行：docker-compose ps
- 检查防火墙是否开放了 8880 端口
- 检查宿主机 IP 是否正确
服务启动后自动退出
- 查看日志排查错误：docker-compose logs pansou
- 检查目录权限是否正确：chmod -R 775 /volume2/docker/PanSou
需要修改配置
- 编辑 docker-compose.yml 文件
- 重启服务使配置生效：docker-compose restart