背景
在前后端分离的开发模式下,有时候我们只需要专注后端逻辑,不想每次都完整构建整个项目。这时,单独启动 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 都能验证服务是否就绪。


