1、官网地址
Dify - 构建生产级 AI 应用
2、安装、部署
文档:部署 Dify - Dify Docs
前置要求
- 服务器:≥2 核 4G 内存,推荐 4 核 8G,磁盘预留≥20G
- 软件:Docker + Docker Compose
下载
wget https://github.com/langgenius/dify/archive/refs/tags/1.17.0.tar.gz解压
tar zxvf 1.17.0.tar.gz配置 Dify
# 进入 Dify 源代码中的 docker 目录: cd dify-1.17.0/docker/ # 复制必要的环境配置文件: cp .env.example .env如果服务器 80 端口被 Nginx/Apache 占用,修改.env或宿主机端口映射
EXPOSE_NGINX_PORT=8081启动
docker-compose up -d3、国内加速器
[]# docker-compose up -d [+] Running 16/16 ✘ api_websocket Error Get "[https://registry-1.docker.io/v2/](https://registry-1.docker.io/v2/)": net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers) 15.8s ✘ agent_ssrf_proxy Error context canceled 15.8s ✘ ssrf_proxy Error context canceled 15.8s ✘ local_sandbox Error context canceled 15.8s ✘ init_permissions Error context canceled 15.8s ✘ weaviate Error context canceled 15.8s ✘ agent_backend Error context canceled 15.8s ✘ db_postgres Error context canceled 15.8s ✘ sandbox Error context canceled 15.8s ✘ nginx Error context canceled 15.8s ✘ web Error context canceled 15.8s ✘ worker Error context canceled 15.8s ✘ redis Error context canceled 15.8s ✘ worker_beat Error context canceled 15.8s ✘ plugin_daemon Error context canceled 15.8s ✘ api Error context canceledDocker 拉取官方镜像registry-1.docker.io(Docker Hub)超时,后面一堆context canceled是连锁失败,不是本身容器故障。 服务器无法连通 Docker Hub,国内服务器非常常见。这时需要配置国内加速器。
修改配置
vi /etc/docker/daemon.json{ "registry-mirrors": [ "https://docker.xuanyuan.me", "https://docker.1ms.run", "https://docker.m.daocloud.io" ], "max-concurrent-downloads": 3, "max-download-attempts": 5 }max‑concurrent‑downloads:3:限制并发下载数,避免一次性同时拉 16 个镜像全部超时,这就是你最开始报错的根源!!!原来 compose 默认并发拉取大量镜像,网络差直接全部超时报 context canceled。
保存重启 docker
systemctl daemon-reload systemctl restart docker #验证 docker info | grep -A 10 "Registry Mirrors"4、初始化 Dify
浏览器访问:http://你的服务器IP/install
- 创建管理员账号密码
- 完成初始化
- 登录控制台,在【模型供应商】中添加大模型(OpenAI / Ollama / 通义千问 / DeepSeek 等)
访问地址:
http://服务器IP,nginx 默认监听 80 端口。
5、常用运维命令
# 查看日志(排查启动失败) docker compose logs -f # 停止服务 docker compose down # 停止并删除数据卷(⚠️会清空数据库、知识库,谨慎!) docker compose down -v # 升级Dify cd dify/docker git pull # 重新拉镜像并重启 docker compose pull && docker compose up -d6、架构简要说明
nginx:入口反向代理,对外暴露 80 端口web:前端页面api:主后端服务worker:异步任务(文档解析、知识库向量化)db:PostgreSQL 主数据库redis:缓存与消息队列weaviate:向量数据库(RAG 知识库)minio:文件对象存储(上传文档、图片)sandbox:代码沙箱,执行代码节点ssrf_proxy:安全代理,防止 SSRF 攻击
7、适用场景
Dify 是开源私有化部署的 LLM 低代码平台,核心能力:RAG 知识库问答、可视化 Workflow 工作流、Agent 智能体、模型网关、对外输出 API / 前端页面,支持对接 OpenAI、DeepSeek、通义千问、Ollama 本地模型等几乎所有兼容 OpenAI 协议的大模型Dify。
7.1 RAG 私有知识库问答(Dify 最强场景)
上传 PDF、Word、Markdown、PPT、TXT 等内部文档,做检索增强问答,减少大模型幻觉稀土掘金。
1)企业内部知识库助手 员工查询制度、技术手册、运维文档、项目资料;不用翻大量共享盘,自然语言提问直接返回答案 + 文档来源。
适合 IT 运维、制造、研发部门,内网私有化部署,文档不会泄露外网。
2)对外智能客服 产品手册、FAQ、售后政策上传知识库;搭建网页客服机器人,嵌入官网、企业微信。客户咨询产品、售后自动回答,减轻客服压力人人都是产...。
3)垂直行业知识库
- 法律:合同文档、法条库,做合同解读、风险提示
- 制造业:设备手册、运维故障手册,车间 / 运维故障问答
- 教育:教材、题库,做答疑助手
特点:所有文档数据保存在自己服务器,不需要上传第三方 SaaS 平台。
7.2 可视化工作流 Workflow(复杂多步骤 AI 业务)
拖拽编排,串联大模型、HTTP 接口、条件分支、变量、知识库检索、代码节点,实现复杂业务自动化Dify。
- 文档处理流水线:上传 PDF → 摘要提取 → 信息抽取 → 输出结构化表格;
- 工单处理:用户提问 →知识库检索 →调用业务 API 生成工单;
- 内容生产:输入简单参数,自动生成报告、周报、邮件、商品文案;
- 审核流程:多轮 AI 校验,文本内容合规审查。
7.3 Agent 智能体(工具调用)
AI 自主思考,调用外部工具:搜索、数据库查询、调用内部业务接口、执行代码沙箱完成复杂任务。
- 企业调研助手:查询内部资料同时调用外部接口获取数据,综合输出报告;
- 业务辅助 Agent:查询业务数据,做数据分析、统计。
7.4 私有化 AI 中台 / 模型网关
- 统一管理多种大模型(云端 API + Ollama 本地私有化模型),统一鉴权、调用日志、限流、成本统计;
- 把搭建好的问答 / 工作流应用输出 API,给业务系统、小程序、内部系统调用,业务系统不用自己对接大模型。
7.5 快速原型验证
产品、开发快速做 AI 应用 POC 验证,不用从零写 LangChain 代码;原型跑通后再做深度二次开发。