在Windows的WSL环境中本地安装watercrawl和Python3.13

itomcoil 2025-08-01 17:49 2 浏览

这段时间在折腾Dify环境调用网络爬虫工具去自动化抓取网页信息的功能，就希望在本地Windows 11的WSL环境中docker方式部署watercrawl，但每次都报错如下：

用命令

pip --version

查了一下WSL环境中的Python版本，发现是3.12，于是就打算升级为3.13版本。Docker Desktop本身并不依赖Python环境。Docker Engine和Docker CLI都是用Go语言编写的，不依赖Python。

还是在WSL环境中使用如下命令行：

sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.13

设置Python 3.13为默认版本（可选），最终我还是使用3.13版本为自动模式，没有启用手动模式；

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.13 1
sudo update-alternatives --config python3

再次在本地WSL环境中使用docker compose方式安装watercrawl，仍然报错“ERROR[app internal]load metadata for
docker.io/library/python:3.13”。

考虑直接在WSL环境中拉取Python3.13的docker镜像：

sudo docker pull python:3.13

拉取Python3.13镜像成功。再次执行watercrawl的容器安装步骤，如下：

至此，watercrawl就采用docker本地化安装成功了。我们再来逐步看看容器化安装watercrawl的每一个步骤吧：

WaterCrawl的官方安装指南（
https://docs.watercrawl.dev/self-hosted/installation ）

首先克隆watercrawl的代码仓库到本地：

sudo git clone https://github.com/watercrawl/watercrawl.git
cd watercrawl/docker
ls -a

对watercrawl的环境变量进行编辑：

sudo cp .env.example .env
sudo vi .env

按“i”进入编辑状态，修改Nginx的端口为未被占用的自定义端口，比如：1xx80；而且因为是部署在本机，其他设置保持默认即可。按“Esc”，输入“:x”保存退出。

sudo docker compose up -d

开启watercrawl服务。

最后创建watercrawl的超级管理员账户：

sudo docker compose exec app python manage.py createsuperuser

超级管理员创建成功。这时可以使用链接“http://localhost:1xx80”来访问watercrawl服务啦。

相关推荐