使用1Panel+DockerCompose一键部署PanSou网盘资源搜索引擎

PanSou 是一款高性能的网盘资源搜索工具，支持 TG 频道聚合 + 多插件并发搜索，几乎覆盖主流网盘（阿里、百度、夸克、115、天翼、UC、迅雷、PikPak 等）。前后端集成镜像 ghcr.io/fish2018/pansou-web:latest 开箱即用，结合 1Panel 的容器编排和反向代理功能，部署简单、安全、可扩展。

本文记录我在 1Panel 面板中使用 Docker Compose 部署 PanSou 的完整配置（含认证、数据持久化、自动重启），并通过反向代理实现域名 + HTTPS 访问。

部署目标

• 容器化运行 PanSou 前后端集成版
• 启用用户名/密码认证（防止陌生人访问）
• 数据持久化（缓存 + 日志）
• 使用 1Panel 反向代理 + Let’s Encrypt 证书，实现域名 HTTPS 访问（如 https://pan.xinhaojin.top）
• 添加 autoheal 容器，自动监控并重启异常的 pansou 容器

前置条件

• 已安装 1Panel 面板（推荐最新版）
• 服务器有公网 IP 或内网穿透（域名已解析）
• 1Panel 中已开放 80/443 端口（用于证书申请和 HTTPS）
• Docker 环境正常（1Panel 自带）

docker-compose.yaml 配置（完整版）

在 1Panel → 容器 → 容器编排 → 创建（或编辑）中，直接粘贴以下内容：

version: '3.8'
services:
  pansou:
    image: ghcr.io/fish2018/pansou-web:latest
    container_name: pansou-app
    labels:
      - "autoheal=true"  # 标记允许 autoheal 自动重启
    ports:
      - "3001:80"        # 只暴露 HTTP 端口，供 1Panel 反向代理使用
    environment:
      # 基础配置（后端监听地址，保持本地回环最安全）
      - PANSOU_PORT=8888
      - PANSOU_HOST=127.0.0.1

      # 数据目录（统一挂载）
      - CACHE_PATH=/app/data/cache
      - LOG_PATH=/app/data/logs

      # 插件列表（推荐全开，覆盖大部分来源）
      - ENABLED_PLUGINS=labi,zhizhen,shandian,duoduo,muou,wanou,hunhepan,jikepan,panwiki,pansearch,panta,qupansou,hdr4k,pan666,susu,thepiratebay,xuexizhinan,panyq,ouge,huban,cyg,erxiao,miaoso,fox4k,pianku,clmao,wuji,cldi,xiaozhang,libvio,leijing,xb6v,xys,ddys,hdmoli,yuhuage,u3c3,javdb,clxiong,jutoushe,sdso,xiaoji,xdyh,haisou,bixin,djgou,nyaa,xinjuc,aikanzy,qupanshe,xdpan,discourse,yunsou,ahhhhfs,nsgame,gying

      # TG 频道列表（默认推荐频道，覆盖热门分享源）
      - CHANNELS=tgsearchers3,Aliyun_4K_Movies,bdbdndn11,yunpanx,bsbdbfjfjff,yp123pan,sbsbsnsqq,yunpanxunlei,tianyifc,BaiduCloudDisk,txtyzy,peccxinpd,gotopan,PanjClub,kkxlzy,baicaoZY,MCPH01,bdwpzhpd,ysxb48,jdjdn1111,yggpan,MCPH086,zaihuayun,Q66Share,ucwpzy,shareAliyun,alyp_1,dianyingshare,Quark_Movies,XiangxiuNBB,ydypzyfx,ucquark,xx123pan,yingshifenxiang123,zyfb123,tyypzhpd,tianyirigeng,cloudtianyi,hdhhd21,Lsp115,oneonefivewpfx,qixingzhenren,taoxgzy,Channel_Shares_115,tyysypzypd,vip115hot,wp123zy,yunpan139,yunpan189,yunpanuc,yydf_hzl,leoziyuan,pikpakpan,Q_dongman,yoyokuakeduanju,TG654TG,WFYSFX02,QukanMovie,yeqingjie_GJG666,movielover8888_film3,Baidu_netdisk,D_wusun,FLMdongtianfudi,KaiPanshare,QQZYDAPP,rjyxfx

      # 健康检查（容器内部）
      - HEALTH_CHECK_INTERVAL=30
      - HEALTH_CHECK_TIMEOUT=10
      - HEALTH_CHECK_RETRIES=3

      # 认证（启用用户名密码登录）
      - AUTH_ENABLED=true
      - AUTH_USERS=admin:123456          # 用户名:密码，可加多个用逗号分隔
      - AUTH_TOKEN_EXPIRY=720               # Token 有效期 720 小时（30 天）

      # JWT 密钥（强烈建议自定义，防止重启后 Token 失效）
      # - AUTH_JWT_SECRET=your-very-long-random-secret-2026-change-this

    volumes:
      - pansou-data:/app/data               # 持久化缓存、日志等

    restart: unless-stopped
    healthcheck:
      test: ["CMD", "/app/healthcheck.sh"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

  autoheal:
    image: willfarrell/autoheal:latest
    container_name: pansou-autoheal
    restart: always
    environment:
      - AUTOHEAL_CONTAINER_LABEL=autoheal
      - AUTOHEAL_INTERVAL=30
      - AUTOHEAL_START_PERIOD=60
      - AUTOHEAL_DEFAULT_STOP_TIMEOUT=10
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

volumes:
  pansou-data:
    driver: local

关键说明：

• 不映射 443：HTTPS 交给 1Panel 反向代理处理，避免证书冲突。
• DOMAIN 未设置：推荐不设，使用相对路径，避免前端生成 localhost 链接导致白屏。
• AUTH_JWT_SECRET：建议手动设置一个长随机字符串（可用 openssl rand -base64 48 生成），否则重启容器后旧登录失效。
• 插件 & 频道：列表很全，基本覆盖主流来源；如需精简可自行删除部分。

1Panel 反向代理配置步骤

1. 容器编排部署成功 → 确认 pansou-app 运行正常。
2. 测试本地访问：http://服务器IP:3001（应看到登录页，用 guest / 999999999 登录）。
3. 1Panel → 网站 → 创建网站 → 选择 反向代理。
   • 主域名：pan.xinhaojin.top（DNS 已解析到服务器 IP）
   • 代理地址：http://127.0.0.1:3001（或 http://pansou-app:80，如果同网络）
   • 强制 HTTPS：开启（或先关掉测试，避免重定向循环）
   • SSL：Let’s Encrypt 一键申请（自动验证 + 续期）
4. 保存 → 等待证书申请成功。
5. 访问 https://pan.xinhaojin.top → 输入用户名/密码登录，即可使用。

常见问题 & 解决方案

• ERR_TOO_MANY_REDIRECTS：关闭 1Panel 站点的“强制 HTTPS” 再测试，或检查代理地址是否为 http 而非 https。
• 登录后白屏/资源 404：确认 DOMAIN 未设置（或设为你的域名），清浏览器缓存。
• 搜索结果少/慢：检查插件拼写、网络是否需 PROXY（被墙 TG 频道常见），或调高 MAX_CONCURRENCY。
• 证书申请失败：80 端口被占、DNS 未解析、Cloudflare 代理模式关掉（用 DNS only）。
• 资源链接失效：PanSou 只聚合，不负责验证；优先选最新结果，多试几个来源。

优化建议

• 加代理：如果 TG 频道访问慢，加 - PROXY=socks5://你的代理IP:端口
• 前端升级：官方 UI 简约，可替换为 pansou-ui（https://github.com/ZhjGo/pansou-ui）或 aipan-netdisk-search 等更美观的前端，通过 Vercel 部署并代理。
• 备份：定期备份 pansou-data 卷（缓存可丢，日志可留）。
• 监控：1Panel 自带容器日志 + autoheal 已够用。