Dify 自托管部署指南

Dify 自托管部署指南Dify 是一个开源的 LLM 应用开发平台提供直观的界面和强大的 API帮助开发者快速构建、部署和管理基于大语言模型的应用。一、功能特性对话应用创建聊天机器人、客服系统等对话式应用工作流可视化编排复杂的 AI 工作流程知识库管理和检索文档、数据等知识资源模型管理支持多种大语言模型GPT、Claude、文心一言等API 接口提供 RESTful API方便集成到其他系统用户管理支持多租户、角色权限管理二、系统要求资源最低要求推荐配置CPU2 核4 核及以上内存4GB8GB 或 16GB处理大规模文档时磁盘20GB50GB SSDDocker≥ 20.10≥ 24.0三、快速部署1. 安装依赖确保已安装以下工具DockerWindows/macOS 下载 Docker DesktopLinux 使用系统包管理器安装Git确保 Git 已安装2. 克隆源码gitclone https://github.com/langgenius/dify.gitcddify/docker3. 复制配置文件cp.env.example .env4. 启动容器dockercompose up-d首次运行会自动拉取镜像耗时约 5~20 分钟取决于网络速度。5. 访问页面浏览器打开http://localhost或你修改的端口首次进入需设置管理员账号。四、配置说明环境变量.env变量名说明默认值EXPOSE_NGINX_PORTNginx 暴露端口80POSTGRES_PASSWORDPostgreSQL 密码随机生成REDIS_PASSWORDRedis 密码随机生成SECRET_KEY应用密钥随机生成修改端口如果 80 端口被占用修改.env文件EXPOSE_NGINX_PORT8088修改数据存储路径默认 Docker 数据存放在系统盘通常是 C 盘建议修改到其他容量更大的磁盘Docker DesktopSettings → Resources → Advanced → 修改数据存储路径Linux修改 Docker daemon 配置/etc/docker/daemon.json五、国内环境优化配置镜像加速在 Docker Desktop 设置中添加国内镜像源{registry-mirrors:[https://docker.mirrors.ustc.edu.cn,https://hub-mirror.c.163.com,https://mirror.baidubce.com]}插件安装安装大模型插件时网络要求较高建议开启代理等待插件日志显示Running后再关闭。六、架构概述Dify 包含以下核心组件组件说明api后端 API 服务处理业务逻辑worker异步任务处理器处理文档解析、模型调用等frontend前端页面提供用户交互界面postgres关系型数据库存储应用数据redis缓存和消息队列nginx反向代理统一入口七、常见问题排查容器启动失败查看容器日志dockercompose logscontainer_name端口冲突确认端口被哪个进程占用# Linux/macOSlsof-i:80# Windowsnetstat-ano|findstr:80数据库连接失败检查.env文件中的数据库配置确保POSTGRES_PASSWORD和REDIS_PASSWORD正确。插件安装超时开启网络代理后重试或手动下载插件镜像。八、Langfuse 集成Dify 支持与 Langfuse 集成实现调用追踪和性能分析部署 Langfuse 并获取 API Key在 Dify 工作流中点击「监测」→ 选择「Langfuse」配置public_key、secret_key、host验证连接成功后所有工作流调用将被追踪到 Langfuse详情参考 Langfuse 说明文档。九、参考链接Dify 官方文档Dify GitHubLangfuse 集成指南