02-安装与部署

Dify 安装与部署适用版本Dify Community Editionv1.16.0面向读者零基础第一次在本地 / 服务器安装 Dify阅读时长约 20 分钟操作约 10–20 分钟前置条件一台能联网的电脑Windows / macOS / Linux 均可或一台云服务器。0. 先选一种安装方式方式适合谁难度说明A. Docker Compose 本地部署推荐绝大多数人⭐一条命令拉起全套最省心B. Dify Cloud 云端免安装只想先体验⭐注册即用但数据在云端C. 源码本地运行想改代码 / 开发者⭐⭐⭐需 Node/Python 环境本篇重点讲方式 ADocker Compose这是学员自部署最常用、最稳的方案。方式 B 在最后简要说明。1. 方式 ADocker Compose 部署7 步搞定第 1 步安装 DockerDify 用 Docker 把数据库、后端、前端打包成「容器」你不用自己装一堆依赖。Windows / macOS下载安装Docker Desktop官网https://www.docker.com/products/docker-desktop/Linux如 Ubuntu安装docker和docker-compose-plugin安装完成后打开终端验证docker--versiondockercompose version能看到版本号如Docker version 27.x、Docker Compose v2.x就说明成功。⚠️Windows 用户注意请使用PowerShell 或 Git Bash并确保 Docker Desktop 已启动任务栏有鲸鱼图标。WSL2 后端推荐开启。第 2 步下载 Dify 代码gitclone https://github.com/langgenius/dify.gitcddify/docker如果没装 git也可以去 https://github.com/langgenius/dify 点Code → Download ZIP解压后进入dify-master/docker目录。第 3 步准备配置文件进入docker目录后复制一份环境配置模板# Linux / macOScp.env.example .env# Windows (PowerShell)copy .env.example .env.env文件里是各种参数端口、密钥、存储等。新手先不改用默认值就能跑起来。第 4 步启动 Difydockercompose up-d-d表示「后台运行」。首次运行会下载多个镜像约几百 MB 到 1GB请保持联网耐心等待 3–10 分钟。看到类似下面的输出说明成功[] Running 11/11 ✔ Container docker-web-1 Started ✔ Container docker-api-1 Started ✔ Container docker-db-1 Started ... 想看实时日志docker compose logs -f。想停止docker compose down。第 5 步确认服务起来了检查容器状态dockercomposepsSTATE列应显示running或Up。常见容器有web、api、worker、db、redis、weaviate或 sandbox 等。第 6 步打开安装页面创建管理员浏览器访问http://localhost/install如果是云服务器把localhost换成服务器公网 IP例如http://你的服务器IP/install。同时确保服务器安全组 / 防火墙放开了80端口HTTP。首次打开会让你设置管理员账号邮箱 密码。填好提交即可。第 7 步登录控制台设置完管理员后自动跳转到登录页。用刚才的账号登录就进入了 Dify控制台首页。✅到此Dify 已经成功运行下一步去 03-界面介绍.md 认识界面或 04-核心概念与基础使用.md 立刻建第一个应用。2..env关键配置进阶可改新手可跳过打开docker/.env文件常用项如下改完需重启docker compose up -d配置项作用新手建议CONSOLE_API_URL/APP_API_URL前端访问后端的地址本机默认即可服务器填域名/IPSERVICE_API_KEY服务 API 密钥保持自动生成POSTGRES_PASSWORD数据库密码生产环境务必改成强密码REDIS_PASSWORDRedis 密码生产环境务必改成强密码FILES_URL文件访问地址多域名部署时需正确配置v1.16 修复过相关 bugCELERY_QUEUESCelery 队列必须包含workflow_based_app_executionv1.15 起否则工作流预览卡住⚠️重要v1.16.0 特别注意从 v1.15 起工作流执行改到 Celery 队列。如果你升级后工作流 / 对话流预览一直转圈多半是.env里CELERY_QUEUES没包含workflow_based_app_execution补上后重启即可参考 v1.9.3 发布说明的同类修复。3. 接入模型的准备为 04 篇铺垫Dify 本身不「自带」脑子大模型你需要准备至少一个模型的 API Key。本系列以国内可访问模型为主任选其一模型获取 Key 地址备注通义千问Qwenhttps://dashscope.console.aliyun.com阿里云百炼需开通模型服务DeepSeekhttps://platform.deepseek.com官方也可用硅基流动 https://siliconflow.cnOllama本地本机安装无需 Key隐私最好但需较好电脑详细配置步骤见 04-核心概念与基础使用.md 第 2 节。4. 方式 BDify Cloud 云端免安装30 秒上手如果你只是想先体验、不想折腾服务器打开 https://dify.ai → 点Get Started / 免费使用。用 GitHub 或邮箱注册登录。直接创建应用即可无需安装、无需配置服务器。缺点数据在 Dify 云端免费额度有限企业敏感资料建议走自部署方式 A。5. 升级与备份生产环境必看备份升级前必做# 备份 PostgreSQL 数据dockercomposeexecdb pg_dump-Upostgres postgresdify_backup_$(date%Y%m%d).sql# 备份向量库数据Weaviate 的 docker volumedockercompose down升级到新版本cddify/dockergitpull# 拉取最新代码dockercompose downdockercompose pull# 拉取新镜像dockercompose up-d# 重新启动⚠️ 升级前务必先备份数据库跨大版本升级请看官方 Release Notes 的迁移说明。v1.16.0 的发布说明在 https://github.com/langgenius/dify/releases。6. 常见安装问题排查现象可能原因解决办法访问localhost打不开Docker 没启动 / 端口被占用确认 Docker Desktop 运行中检查 80 端口是否被占用docker compose up -d卡在拉镜像网络慢国内常见配置 Docker 镜像加速器如阿里云、DaoCloud 加速器页面能开但登录后空白前端/后端地址配置错检查.env中CONSOLE_API_URL等是否指向正确地址工作流预览一直转圈Celery 队列缺workflow_based_app_execution在.env补上该队列并重启上传文件失败存储路径权限 / 磁盘满检查磁盘空间与docker volume权限Ollama 模型连不上Docker 网络隔离用http://host.docker.internal:11434作为 Ollama 地址Windows/MacLinux 用宿主机真实 IP国内拉镜像慢的终极办法给 Docker 配置国内镜像源。Docker Desktop → Settings → Docker Engine在配置里加入 registry-mirrors如https://你的ID.mirror.aliyuncs.comApply 后重启。7. 动手练习用自己的电脑按第 1–7 步把 Dify 跑起来。打开http://localhost/install创建管理员并登录。选做在「设置 → 模型供应商」里先随便看一眼有哪些模型可选先别急着装下一篇细讲。完成后进入 03-界面介绍.md 认识控制台。下一步03-界面介绍.md —— 我把控制台每个区域都标给你看。