一、环境前置要求
硬件最低配置
- CPU：2 核及以上
- 内存：≥4G（推荐 8G，知识库大文件 / 工作流建议 16G）
- 磁盘：≥20G（存放向量数据、文档、日志）
软件依赖
- Linux / MacOS / Windows WSL2
- Docker ≥ 20.10，Docker Compose V2
- 服务器开放端口：80（网页）、443（HTTPS）
二、一键部署流程
1. 拉取部署脚本
# 创建dify目录并进入 mkdir dify && cd dify # 下载官方docker-compose部署包 curl -O https://raw.githubusercontent.com/langgenius/dify/main/docker/docker-compose.yml curl -O https://raw.githubusercontent.com/langgenius/dify/main/docker/.env.example # 复制环境配置文件 cp .env.example .env
2. 配置环境变量（关键）
编辑 .env 文件：
vim .env
常用修改项：
SECRET_KEY：自定义随机字符串，用于会话加密（必须修改）API_KEY_PREFIX：自定义 API 密钥前缀APP_URL：服务器公网 IP / 域名（后续网页、嵌入 JS 依赖）- 向量库默认使用
chroma（轻量免额外部署）；大数据量改为milvus - 邮件、存储、数据库可保持默认（内置 PostgreSQL/Redis）
示例基础配置片段：
SECRET_KEY=abc123456randomstring789 APP_URL=http://192.168.1.100 VECTOR_STORE=chroma
3. 启动服务
# 后台启动全部容器 docker compose up -d # 查看运行状态 docker compose ps
启动包含服务：
- dify-web：前端页面
- dify-api：后端核心接口
- dify-worker：知识库文档异步解析
- postgres：业务数据库
- redis：缓存 / 消息队列
- chroma：轻量向量库
4. 初始化访问
- 浏览器打开：
http://服务器IP - 首次进入会跳转管理员注册页面，设置管理员账号密码
- 登录完成部署，即可创建应用、接入模型、上传知识库
三、基础初始化操作
1. 接入大模型
侧边栏「设置」→「模型供应商」 支持 OpenAI、通义千问、DeepSeek、Ollama 本地模型等，填入对应 API Key 即可全局启用。
2. 创建知识库
左侧「知识库」→「创建知识库」，支持批量上传 PDF/Word/Markdown，自动分段向量化。
3. 创建对话应用
左侧「应用」→「创建应用」：
- 基础对话：简单问答机器人
- 工作流：拖拽复杂业务流程
- Agent：带工具调用智能体
四、常用运维命令
# 查看实时日志 docker compose logs -f # 重启服务（修改.env后执行） docker compose down && docker compose up -d # 停止服务 docker compose down # 完全清理数据（谨慎执行，所有知识库、应用全部删除） docker compose down -v
五、端口 / 域名 & HTTPS 配置
1. 端口修改
编辑 docker-compose.yml，找到 ports: "80:80"，将前侧主机端口改为自定义，如 8080:80，访问地址变为 http://IP:8080
2. Nginx 反向代理 + HTTPS（生产推荐）
- 域名解析指向服务器 IP
- Nginx 配置反向代理到容器 80 端口
- SSL 证书配置后修改
.env中APP_URL=https://你的域名
六、常见问题处理
- 上传文档解析失败 查看 worker 日志：
docker compose logs dify-worker，多为内存不足，升级服务器内存。 - 外部无法访问页面 防火墙放行 80 端口：
# CentOS/RHEL firewall-cmd --add-port=80/tcp --permanent firewall-cmd --reload # Ubuntu ufw allow 80
3. 模型调用超时 检查 API Key 正确性、服务器是否能访问模型厂商接口，可配置代理写入.env。
七、数据持久化说明
docker-compose 默认使用 volume 持久化：
- Postgres 业务数据（账号、应用、对话记录）
- Chroma 向量库数据
- Redis 缓存 执行
docker compose down不会丢失数据；只有docker compose down -v会清空全部数据。
八、轻量化离线本地部署（Ollama+Dify）
如需完全离线不依赖外网 API：
- 服务器安装 Ollama，拉取 Qwen/Llama 等本地大模型
- Dify 模型供应商选择 Ollama，地址填
http://host.docker.internal:11434 - 关闭所有第三方在线模型配置，实现内网离线 AI 平台。