网盘搜索神器,开源项目Pansou部署记录

wechat_2025-08-09_000535_816.png

初步探索:官方文档与理想的部署方案

在开始之前,我查阅了 Pansou 后端API项目 1 和其前端项目 2README 文档。文档中提供了详尽的说明,包括一个极具吸引力的“前后端集成版”部署方案。

根据文档描述,最推荐的方式是使用 Docker Compose,通过一条 curl 命令下载 docker-compose.yml 配置文件,然后一键启动服务:

# 官方文档推荐的理想步骤
curl -o docker-compose.yml https://raw.githubusercontent.com/fish2018/pansou-web/main/docker-compose.yml
docker-compose up -d

这个方案理论上可以将前端和后端打包在一起,开箱即用,对于希望快速体验的用户来说无疑是最佳选择。

实践中的插曲:404 Not Found

然而,当我在本地的 Windows PowerShell 环境中执行 curl 命令时,却遇到了预料之外的 404: Not Found 错误。

PS D:\docker_projects\pansou> curl -o docker-compose.yml https://raw.githubusercontent.com/fish2018/pansou-web/main/docker-compose.yml
curl : 404: Not Found

经过排查发现,pansou-web 这个集成了前端和后端的项目仓库似乎已经被作者归档或删除,导致其 docker-compose.yml 文件的原始链接已失效。这意味着通过 Docker Compose 进行集成部署的路径已经走不通了。

柳暗花明:回归 Docker Run 命令

虽然推荐的 docker-compose.yml 文件无法获取,但 PansouREADME 中还提到了另一个直接使用 Docker 命令的部署方式。这让我看到了新的希望。

文档中给出的命令是:
docker run -d --name pansou -p 80:80 ghcr.io/fish2018/pansou-web

幸运的是,虽然 pansou-web 的 GitHub 仓库不见了,但其 Docker 镜像依然保留在 ghcr.io 上,可以正常拉取。

考虑到个人使用习惯,我不太喜欢将容器直接映射到本地的 80 端口。这不仅是一种个人偏好,也是为了避免与本地可能运行的其他 Web 服务(如 IIS、Apache 等)产生端口冲突。因此,我决定将本地端口修改为 8067,这是一个相对空闲且易于记忆的端口。

最终,我执行的命令如下:

docker run -d --name pansou -p 8067:80 ghcr.io/fish2018/pansou-web

命令执行后,Docker Desktop 顺利地下载了镜像并启动了容器。打开浏览器,访问 http://localhost:8067,期待已久的 Pansou 搜索界面成功呈现在眼前。

wechat_2025-08-09_000618_386.png

总结

通过这次实践,我成功地在本地电脑上部署了 Pansou 项目。尽管官方推荐的 Docker Compose 部署方式因项目仓库的变动而失效,但通过使用基础的 docker run 命令,并结合个人习惯对端口进行调整,最终还是轻松地完成了部署。

这次经历也再次证明了开源项目的灵活性。对于希望在本地体验 Pansou 的朋友来说,其实无需复杂的配置,只需要确保你的电脑已经安装了 Docker Desktop,然后执行下面这一条命令,即可成功运行:

docker run -d --name pansou -p 8067:80 ghcr.io/fish2018/pansou-web

(注:你可以将 8067 替换为你自己喜欢的任何未被占用的端口。)