deerflow 2.0 国内镜像加速设置

发表于 2026-09-07 分类于 deerflow 阅读次数： Changyan：

本博客针对 DeerFlow 2.0 相关的文章不会长篇大论的进行介绍，DeerFlow 的 GitHub 主页上文档非常的详细，此处的全部相关文章全部以解决实际痛点和特定场景问题为主。

在国内网络受限的情况下，deerflow需要在不同的位置设置替换国内镜像加速源来加速服务的构建和启动。

镜像加速分析

下表列出了 DeerFlow 2.0 （以下简称“deerflow”）主要服务以及需要设置国内镜像加速的位置：

服务	说明	是否需要镜像加速	镜像分类	环境变量
NGINX	统一反向代理	否	/
FRONTEND	基于 Next.js 的前端 WEB UI	是	npm	`NPM_REGISTRY`
GATEWAY	基于 FastAPI 的网关服务	是	uv	`UV_INDEX_URL`

此外，如果 deerflow 以容器化的方式启动的话，服务镜像在构建过程中会安装软件依赖。如有必要，此处也要进行国内镜像源的设置，关键的环境变量是 APT_MIRROR。

参考来源：

https://github.com/bytedance/deer-flow/blob/d1f1c49dcd872aeb7aec6114ca36f6ee6760fed6/backend/Dockerfile#L22-L26

在启动 deerflow 前设置以下环境变量：

1
2
3

export NPM_REGISTRY=https://registry.npmmirror.com
export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
export APT_MIRROR=mirrors.aliyun.com

之后需要重新生成 uv 的锁文件（重要！）：

1 2	cd backend uv lock