Docker-Windows本地Docker部署Firecrawl

Docker-Windows本地Docker部署Firecrawl

文章借鉴自：https://blog.csdn.net/javatrip01/article/details/147040768

一、克隆Firecrawl项目仓库

在开始之前，请确保已安装 Git 工具。然后，在终端（Windows 下可使用 Git Bash 或 PowerShell）中执行以下命令，将 Firecrawl 源代码克隆到本地

git clone https://github.com/mendableai/firecrawl.git

克隆完成后，会生成一个名为 firecrawl 的目录。请进入该目录，准备进行后续配置和部署步骤。

二、安装并启动 Docker Desktop

确保本机已安装 Docker Desktop（Windows 版）。如果尚未安装，可从 Docker 官方网站下载并按照指引安装 Windows安装Docker Desktop
安装完成后，启动 Docker Desktop，并确保其后台的 Docker 守护进程已经运行。

三、配置环境变量 (.env 文件)

3.1、找到项目目录下的 apps/api/.env.example 文件。将该文件复制到 项目根目录 并重命名为 .env

cd firecrawl/apps/api
# 将 .env.example 复制到上两级目录（项目根目录）并命名为 .env
cp .env.example ../../.env

3.2、打开项目根目录下新生成的 .env 文件，确认和调整以下内容：

必需参数： 设置基本的服务参数。例如：

PORT=3002
HOST=0.0.0.0
USE_DB_AUTHENTICATION=false
NUM_WORKERS_PER_QUEUE=8
BULL_AUTH_KEY=CHANGEME

四、使用 Docker Compose 构建并启动容器

4.1、在项目根目录下，通过 Docker Compose 来构建和启动 Firecrawl 所需的所有容器服务。

首先，（可选）构建镜像：运行以下命令让 Docker 根据仓库内容构建应用镜像（首次运行会自动下载所需基础镜像，耗时可能较长）

docker compose build

4.2、报错

报错信息

ERROR [api go-base 3/3] RUN cd /app/sharedLibs/go-html-to-md && go mod tidy && go build -o html-to-m 21.6s...

4.2.1、这个错误表明在构建 Go 项目时，Docker 容器无法访问 proxy.golang.org（Google 的 Go 模块代理服务器），导致依赖下载失败。以下是解决方案

4.2.2、修改 firecrawl/apps/api/Dockerfile文件

在 go-base 阶段显式设置 GOPROXY，使用国内镜像源（如七牛云或阿里云）：

修改后的 Dockerfile（关键部分）

# Install Go
FROM golang:1.24 AS go-base
COPY sharedLibs/go-html-to-md /app/sharedLibs/go-html-to-md

# 设置国内 Go 模块代理并构建
RUN go env -w GOPROXY=https://goproxy.cn,direct && \
	cd /app/sharedLibs/go-html-to-md && \
	go mod tidy && \
	go build -o html-to-markdown.so -buildmode=c-shared html-to-markdown.go && \
	chmod +x html-to-markdown.so

4.3、清理缓存并重新构建

docker compose build --no-cache

4.4、启动容器

docker compose up -d

五、验证容器状态与访问服务

5.1、进入 Containers / Apps 面板查看名为 firecrawl 的应用组下的各个容器是否都处于运行（Running）状态