Dify 前后端分离：独立启动前端 Docker 容器指南

背景

在前后端分离的开发模式下，有时候我们只需要专注后端逻辑，不想每次都完整构建整个项目。这时，单独启动 Dify 的前端 Docker 容器是个高效的选择。下面分享两种常用方案：直接使用官方镜像，或者基于源码本地构建。

方案一：使用官方镜像

这是最快的方式。不需要本地编译前端代码，直接拉取镜像即可。

启动容器

默认拉取最新版，确保端口映射正确，并设置后端 API 地址：

docker run -it -p 3000:3000 \
  -e CONSOLE_API_URL=http://127.0.0.1:5001 \
  -e APP_API_URL=http://127.0.0.1:5001 \
  langgenius/dify-web:latest

如果需要特定版本，可以去 Docker Hub 搜索 langgenius/dify-web 标签页获取版本号，例如 1.4.3：

docker run -it -p 3000:3000 \
  -e CONSOLE_API_URL=http://127.0.0.1:5001 \
  -e APP_API_URL=http://127.0.0.1:5001 \
  langgenius/dify-web:1.4.3

访问验证

启动成功后，浏览器访问 http://127.0.0.1:3000 即可看到登录页面。

方案二：源码构建镜像

如果你需要修改前端代码或有特殊定制需求，可以先在本地构建镜像。

构建步骤

进入前端源码目录执行构建命令：

cd web && docker build . -t dify-web

运行容器

构建完成后，运行方式与方案一类似：

docker run -it -p 3000:3000 \
  -e CONSOLE_API_URL=http://127.0.0.1:5001 \
  -e APP_API_URL=http://127.0.0.1:5001 \
  dify-web

域名配置说明

注意，如果控制台的访问域名和 Web APP 的域名不一致，可以通过 CONSOLE_URL 和 APP_URL 变量分别指定。不过通常本地调试时，API 地址（CONSOLE_API_URL）更为关键。

小结

两种方法都将容器端口映射到主机的 3000 端口。方案一胜在便捷，适合标准开发；方案二胜在灵活，适合定制开发。无论哪种，启动后访问 http://127.0.0.1:3000 都能验证服务是否就绪。