好的，Dify 是一款强大的 LLM 应用开发平台，安装部署非常灵活。这里为你提供最主流的几种安装方式，并详细说明步骤。

核心安装方式概览

1. Docker Compose（推荐）： 最简单、最快速，适合绝大多数用户和开发环境。
2. 手动部署： 适合对 Docker 不熟悉，或有特殊定制需求的用户。
3. 云服务一键部署： 使用 Sealos、Zeabur 等平台，无需自己管理服务器。

---

方式一：Docker Compose 安装（最推荐）

这是官方建议的首选方式，能自动处理所有依赖。

前提条件

• 一台 Linux / macOS 服务器或虚拟机（Windows 可用 Docker Desktop）。
• 已安装 Docker 和 Docker Compose。
• 服务器配置建议：至少 4GB 内存，CPU 2核以上，硬盘 20GB 以上。

安装步骤

1. 获取安装脚本
   在终端中执行以下命令，下载最新版的 docker-compose.yml 配置文件。

   cd /opt  # 可以切换到你想安装的目录
   curl -Lo docker-compose.yml https://raw.githubusercontent.com/langgenius/dify/main/docker/docker-compose.yaml
   

2. 启动 Dify 服务
   在 docker-compose.yml 文件所在目录，运行：

   sudo docker compose up -d
   

   首次运行会自动拉取镜像（包括前端、后端、数据库等），可能需要几分钟。

3. 访问应用
   等待所有容器启动完成后，在浏览器中访问：

   • http://你的服务器IP:3000 (如果在本机，可以是 http://localhost:3000)
   • 你将看到 Dify 的初始化页面。

4. 完成初始化
   按照网页提示：

   • 设置管理员账号和密码。
   • 配置初始的 AI 模型供应商（如 OpenAI、Azure OpenAI、 Anthropic、本地部署的 Ollama 等）。这一步也可以在安装后于设置中配置。

常见 Docker 管理命令

• 查看日志： sudo docker compose logs -f （-f 为实时跟踪）
• 停止服务： sudo docker compose down
• 重启服务： sudo docker compose restart
• 更新 Dify：

  sudo docker compose pull
  sudo docker compose up -d
  

---

方式二：手动部署

适合希望更精细控制组件或环境限制无法使用 Docker 的用户。

前提条件

• 已安装 Python 3.10+, Node.js 18+, PostgreSQL (>= 15), Redis (>= 7)。
• 熟悉基本的命令行操作。

安装步骤

1. 克隆仓库

   git clone https://github.com/langgenius/dify.git
   cd dify
   

2. 后端 API 服务设置

   cd api
   # 复制环境变量示例文件并编辑
   cp .env.example .env
   # 使用 vim 或 nano 编辑 .env 文件，主要配置数据库连接、Redis连接和密钥
   vim .env
   

   在 .env 中确保正确设置：

   DATABASE_URL=postgresql://postgres:your_password@localhost:5432/dify
   REDIS_HOST=localhost
   REDIS_PORT=6379
   SECRET_KEY=your_secret_key_here
   

3. 初始化数据库和启动后端

   # 安装依赖
   pip install -r requirements.txt
   # 初始化数据库
   flask db upgrade
   # 启动服务（开发模式）
   python -m flask run --host=0.0.0.0 --port=5001
   # 生产环境建议使用 Gunicorn
   # gunicorn -w 4 -b 0.0.0.0:5001 --timeout 120 app:app
   

4. 前端 Web 服务设置

   cd ../web  # 从 api 目录返回 dify 主目录，再进入 web
   # 复制环境变量示例文件并编辑
   cp .env.example .env.local
   # 编辑 .env.local，将 API 地址指向后端服务
   vim .env.local
   

   在 .env.local 中设置：

   NEXT_PUBLIC_API_BASE_URL=http://localhost:5001
   

5. 启动前端

   # 安装依赖并构建
   npm install
   npm run build
   # 启动服务
   npm run start
   # 或直接以开发模式运行
   npm run dev
   

6. 访问应用
   访问 http://localhost:3000 即可。

---

方式三：云平台一键部署

适合不想管理服务器的用户，几分钟内即可获得一个可用的在线服务。

1. 使用 Sealos

Sealos 提供图形化的一键部署。

• 访问 Sealos Dify 模板页面。
• 使用 Sealos 账户登录。
• 点击“部署应用”，根据提示配置（CPU、内存等）。
• 部署完成后，会提供一个可访问的域名。

2. 使用 Zeabur

Zeabur 同样支持极简部署。

• 将 Dify 的 GitHub 仓库 Fork 到你自己的账户。
• 在 Zeabur 中创建新项目，选择“从模板部署”。
• 选择你 Fork 的 Dify 仓库。
• 配置环境变量（如 OPENAI_API_KEY）后，Zeabur 会自动构建并分配域名。

安装后的关键配置

无论哪种方式安装成功，首次登录后都需要进行核心配置：

1. 模型供应商设置： 进入“设置” -> “模型供应商”，添加你需要的 AI 模型。
   • OpenAI： 需要 API Key 和 Base URL（如果用第三方代理）。
   • Azure OpenAI： 需要 API Key、Endpoint 和 Deployment Name。
   • 本地模型（如通过 Ollama）： 需要将 Ollama 的本地 API 地址（如 http://host.docker.internal:11434）填入 Base URL。
2. 邮箱服务器设置： 如果需要用户注册、找回密码等功能，需在“设置”->“工作区设置”中配置 SMTP。
3. 文件上传限制： 在“设置”->“文件上传设置”中调整允许的格式和大小。

故障排查

• 无法访问 3000 端口： 检查服务器安全组/防火墙是否放行了 3000 端口。
• Docker 启动失败： 运行 docker compose logs -f 查看具体哪个服务报错。常见问题包括端口冲突、内存不足、镜像拉取失败。
• 初始化页面卡住： 检查后端 API (默认 5001 端口) 是否正常运行，前端 .env.local 中的 API_BASE_URL 配置是否正确。
• 数据库连接错误： 手动部署时，检查 PostgreSQL 和 Redis 服务是否已启动，且 .env 文件中的连接字符串正确。

最权威的指南永远是官方文档： 安装前建议快速浏览 Dify GitHub 仓库的 README 和 官方部署文档，以获取最新的版本信息和细节。

希望这份指南能帮助你顺利安装 Dify！