
网盘搜索神器,开源项目Pansou部署记录
网盘搜索神器,开源项目Pansou部署记录
初步探索:官方文档与理想的部署方案
在开始之前,我查阅了 Pansou
后端API项目 1 和其前端项目 2 的 README
文档。文档中提供了详尽的说明,包括一个极具吸引力的“前后端集成版”部署方案。
根据文档描述,最推荐的方式是使用 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
文件无法获取,但 Pansou
的 README
中还提到了另一个直接使用 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 搜索界面成功呈现在眼前。
总结
通过这次实践,我成功地在本地电脑上部署了 Pansou
项目。尽管官方推荐的 Docker Compose 部署方式因项目仓库的变动而失效,但通过使用基础的 docker run
命令,并结合个人习惯对端口进行调整,最终还是轻松地完成了部署。
这次经历也再次证明了开源项目的灵活性。对于希望在本地体验 Pansou
的朋友来说,其实无需复杂的配置,只需要确保你的电脑已经安装了 Docker Desktop,然后执行下面这一条命令,即可成功运行:
docker run -d --name pansou -p 8067:80 ghcr.io/fish2018/pansou-web
(注:你可以将 8067
替换为你自己喜欢的任何未被占用的端口。)