一、云服务部署：3 分钟极速开箱
适合人群：快速验证原型 · 中小企业轻量化使用
核心优势：零运维、免费用量额度、自动升级
操作步骤：
1. 注册登录 👉 访问 Dify 官网 → 点击「免费开始」→ 用邮箱/GitHub 账号注册
国内用户推荐选择 亚太节点（新加坡/东京），延迟更低
2. 创建应用
3. 配置模型
免费额度：新用户赠送 $1 的 GPT-3.5 调用额度
- 进入「模型供应商」→ 选择 OpenAI/Claude/通义千问
- 填入 API Key（云服务自动代理请求，无需暴露 Key 给客户端）
4. 立即体验
# 通过 API 测试
curl -X POST "https://api.dify.ai/v1/chat-messages" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"inputs": {}, "query": "你好"}'
进入应用 → 点击「发布」→ 通过 Web/API 接入
💡 云服务优缺点：
二、本地 Docker 部署：5 分钟构建私有环境
- 适合人群：金融/医疗等强合规场景 · 需要连接内网系统
核心优势：数据 100% 私有化 · 自定义 GPU 加速
操作步骤：
1. 环境准备
最低配置：Linux/MacOS/Windows WSL2 · 4核 CPU · 8GB 内存 · 20GB 磁盘
安装 Docker 及 Docker Compose
2. 一键启动
# 下载官方 compose 文件
curl -O https://raw.githubusercontent.com/langgenius/dify/main/docker/docker-compose.yaml
# 启动服务（首次启动自动拉镜像）
docker-compose up -d
# 查看日志（出现 Listening at http://0.0.0.0:80 即成功）
docker-compose logs -f
3. 访问控制台
- 浏览器打开 http://localhost（默认账号：admin@dify.ai，密码：difyai.com）
- 立即修改密码！ → 进入「系统设置」重置
4. 配置本地模型（关键步骤）
# 编辑 docker-compose.yaml，添加 Ollama 本地模型服务
services:
ollama:
image:ollama/ollama
ports:
-"11434:11434"
volumes:
-ollama:/root/.ollama
# 启动 Llama3 中文优化版
docker exec -it dify-ollama ollama run qwen:4b-chat
# Dify 控制台添加模型
模型类型：OpenAI 兼容
端点：http://ollama:11434/v1
模型名称：qwen:4b-chat
🔧 私有化部署调优技巧
三、方案对比：按需选择最优解
实测数据：本地部署运行 Qwen-4B 模型，单条查询响应 <2s（RTX 3060 GPU）
四、避坑指南：高频问题解决方案
镜像拉取失败
# 替换国内镜像源
sed -i 's/ghcr.io/mirror.ghcr.io/g' docker-compose.yaml
端口冲突（本地 80 端口被占）
# 修改 compose 文件端口映射
services:
dify-web:
ports:
- "8080:80" # 改为 8080 端口
知识库上传失败
- 检查文件：仅支持 PDF/TXT/Markdown/Word
- 内存不足：增加 Docker 内存限制 docker-compose.yml → mem_limit: 4096m
五、总结：两条路径，同一目标
云服务是快速验证的“轻骑兵”，适合敏捷迭代；
本地 Docker 是数据自主的“堡垒机”，满足合规刚需。
无论选择哪种方式，Dify 都大幅降低了 AI 应用的门槛。
