Dify 离线部署全攻略:从环境准备到成功启动

📅 2026/7/15 6:14:36
Dify 离线部署全攻略:从环境准备到成功启动
Dify 介绍与离线部署指南1. Dify 简介Dify 是当前 AI 领域热门的开源项目之一旨在帮助开发者快速构建和部署基于大语言模型LLM的应用。平台采用模块化设计集成了 RAG 引擎、可视化 AI 工作流编排以及 Agent 构建等核心能力原生支持 PDF、PPT 等多种格式文档的解析与向量数据库对接并可借助阿里云 ACK 等服务实现生产级高可用部署。用户可以通过 Dify 的图形化界面轻松编排复杂的 AI 流程并将应用快速推向生产环境。2. 环境要求在开始部署前请确保服务器满足以下最低配置CPU≥ 2 核心内存≥ 4 GiBDocker≥ 19.0.3Docker Compose≥ 2.24.0本文将以离线环境为例基于Dify 1.13.0版本进行部署。3. 获取 Dify 源码从 GitHub 克隆指定版本的 Dify 仓库gitclone-b1.13.0 https://github.com/langgenius/dify.git如果网络受限也可以直接下载 1.13.0 的源码压缩包解压后进入项目目录cd dify/docker后文中所有操作默认都在 dify/docker 目录下执行。4. 修改 Dify 配置4.1 修改环境变量文件 .env假设我们希望 Dify 通过本机的10070端口访问且本机 IP 为192.168.1.100请替换为实际 IP需要编辑.env文件修改以下变量# 控制台 API 地址 CONSOLE_API_URLhttp://192.168.1.100:10070 # 控制台 Web 地址 CONSOLE_WEB_URLhttp://192.168.1.100:10070 # 服务 API 地址 SERVICE_API_URLhttp://192.168.1.100:10070 # 触发器地址 TRIGGER_URLhttp://192.168.1.100:10070 # 应用 Web 地址 APP_WEB_URLhttp://192.168.1.100:10070 # Nginx 监听端口 NGINX_PORT10070 # 上传文件大小限制根据模型上下文长度设定例如 Qwen3.5-9B-GPTQ-4bit 建议 128KB NGINX_CLIENT_MAX_BODY_SIZE128k4.2 修改 docker-compose.yaml找到 nginx 服务的 ports 映射改为- 10070:10070确保所有与 nginx 相关的端口配置一致避免内外端口错乱。五、组件清单离线镜像列表Dify 1.13.0 依赖以下组件本文基于离线包部署组件名版本dify-api1.13.0 / 1.13.3dify-plugin-daemon0.5.3 / 0.5.8dify-sandbox0.2.12dify-web1.13.0 / 1.13.3nginx1.30postgres15.12redis6.2.19squidlatestweaviate1.27.0docker二进制29.4.3插件千问适配langgenius-openai_api_compatible_0.0.49-offline.difypkg六、离线安装 Docker若已安装可跳过6.1 下载 Docker 二进制包wgethttps://download.docker.com/linux/static/stable/x86_64/docker-29.4.3.tgz6.2 解压并移动tar-zxvfdocker-29.4.3.tgzcp-rdocker/* /usr/bin6.3 注册为 Systemd 服务创建 /usr/lib/systemd/system/docker.service写入以下内容[Unit] DescriptionDocker Application Container Engine Documentationhttp://docs.docker.com Afternetwork.target docker.socket [Service] Typenotify EnvironmentFile/run/flannel/docker WorkingDirectory/usr/local/bin ExecStart/usr/bin/dockerd \ -H tcp://0.0.0.0:4243 \ -H unix:///var/run/docker.sock \ --selinux-enabledfalse \ --log-opt max-size1g ExecReload/bin/kill -s HUP $MAINPID LimitNOFILEinfinity LimitNPROCinfinity LimitCOREinfinity TimeoutStartSec0 Delegateyes KillModeprocess Restarton-failure [Install] WantedBymulti-user.target6.4 启动并设置开机自启systemctl daemon-reload systemctl startdockersystemctlenabledocker6.5 验证安装dockerinfodockerps无报错即表示 Docker 安装成功。七、配置 Docker Compose将 docker-compose 二进制文件拷贝到系统 PATHcp/path/to/docker-compose /usr/local/bin/chmodx /usr/local/bin/docker-compose八、加载所有依赖镜像dockerload-idify-api-1.13.0.tardockerload-idify-api-1.13.3.tardockerload-idify-plugin-daemon.tardockerload-idify-plugin-daemon-0.5.3.tardockerload-idify-plugin-daemon-0.5.8.tardockerload-idify-sandbox-0.2.12.tardockerload-idify-web-1.13.0.tardockerload-idify-web-1.13.3.tardockerload-inginx-1.30.tardockerload-ipostgres-15.12.tardockerload-iredis-6.2.19.tardockerload-isquid.tardockerload-iweaviate-1.27.0.tar加载完成后可通过 docker images 检查是否所有镜像已就位。九、启动 Dify 服务docker-composeup-d查看运行状态docker-composeps如需停止服务docker-composedown至此Dify 1.13.0 的离线部署全部完成。 你可以即刻开始体验可视化编排大模型应用的乐趣。