2月前体验链接🎉
简介
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 的界面，则表示部署成功。
资源非常的多！！！
配置说明
核心配置项解释
端口映射说明
配置中的 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