现象
用户在FastGPT部署流程中，执行配置下载后，运行docker compose --profile prepull pull opensandbox-agent-sandbox-image opensandbox-execd-image opensandbox-egress-image命令拉取镜像时，出现报错：service "fastgpt-milvus-minio" refers to undefined network vector: invalid compose project。此前配置下载流程正常，已更新S3、MCP访问地址，确认Docker socket路径无误。
可能原因
该报错提示配置中的服务引用了未定义的名为vector的网络，可能的原因是docker-compose.yml配置中存在对未创建或未定义的vector网络的引用，或配置文件中的网络配置存在错误。
排查步骤
- 打开当前部署目录下的docker-compose.yml文件，搜索关键词
vector，确认其中是否存在对名为vector的网络的引用配置。 - 检查docker-compose.yml中的
networks配置块，确认是否定义了名为vector的网络。 - 确认部署环境中是否提前创建了该自定义网络，或配置文件中的网络名称与实际创建的网络名称一致。
- 核对此前更新的配置项，确认是否在配置下载后未正确保留或修改了网络相关配置。
解决与验证
若docker-compose.yml中未定义vector网络，可在配置文件的networks块中添加该网络的基础定义，例如添加vector: {}。若部署环境中未创建该网络，可执行docker network create vector命令创建自定义网络。完成配置修改或网络创建后，重新执行拉取镜像的命令：docker compose --profile prepull pull opensandbox-agent-sandbox-image opensandbox-execd-image opensandbox-egress-image，确认报错消失。验证：拉取镜像成功后，执行docker compose up -d启动服务，确认无网络相关报错即可。