前提条件

• 操作系统：Windows 10/11、macOS 10.14 或更高版本、Linux（推荐 Ubuntu 20.04 或更高版本）
• 硬件规格：CPU 2核或以上、RAM 4GB或以上、磁盘空间 20GB或以上
• 工具：Docker Desktop（支持所有操作系统）、Git（命令行工具）

1. 安装 Docker

Windows 系统

1. 下载 Docker Desktop：

   • 从 Docker 官方网站 下载 “Docker Desktop for Windows”。
   • 运行安装程序，并按照屏幕上的指示进行安装。
   • 重要：建议启用 WSL 2。在安装过程中选择 “Use WSL 2 instead of Hyper-V”。

2. 启动确认：

   • 从开始菜单启动 “Docker Desktop”。如果系统托盘中出现 Docker 图标，则表示成功。
   • 在命令提示符中运行 docker --version。如果显示版本信息，则表示OK。

macOS 系统

1. 下载 Docker Desktop：

   • 从 Docker 官方网站 下载 “Docker Desktop for Mac”。
   • 打开 DMG 文件，将 Docker 图标拖到“应用程序”文件夹中。

2. 启动确认：

   • 从应用程序文件夹启动 Docker Desktop。如果系统托盘中出现 Docker 图标，则表示成功。
   • 在终端中运行 docker --version。如果显示版本信息，则表示OK。

Linux 系统（以 Ubuntu 为例）

1. 安装 Docker：

   sudo apt update
   sudo apt install docker.io -y
   sudo systemctl enable --now docker
   sudo usermod -aG docker $USER

2. 启动确认：

   • 在终端中运行 docker --version。如果显示版本信息，则表示OK。
   • 注销并重新登录，以确保用户已添加到 docker 组。

2. 安装 Dify

步骤

1. 安装 Git（如果尚未安装）：

   • Windows/macOS：从 Git 官方网站 下载并运行安装程序。
   • Linux：在终端中运行 sudo apt install git -y。

2. 获取 Dify 源代码：

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

3. 配置环境变量（可选）：

   cp .env.example .env
   nano .env  # 使用文本编辑器编辑环境变量

4. 使用 Docker Compose 启动 Dify：

   docker compose up -d

   • 注意：如果使用 Docker Compose v2，请运行 docker compose；如果使用 v1，请运行 docker-compose。

5. 运行确认：

   • 在浏览器中访问 http://localhost。如果出现 Dify 初始化界面，则表示成功。
   • 在初始化界面创建管理员账户（设置电子邮件地址、用户名、密码）。

3. 常见问题与解决方法

1. 找不到 Docker Compose

• 原因：可能尚未安装 Docker Compose。
• 解决方法：
  • Windows/macOS：重新安装 Docker Desktop，并确保已启用 “Docker Compose”。
  • Linux：在终端中运行以下命令：

    sudo curl -L "https://github.com/docker/compose/releases/download/v2.18.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
    sudo chmod +x /usr/local/bin/docker-compose

2. 端口冲突

• 原因：Dify 使用的端口（例如 80、443、5001）可能已被其他服务占用。
• 解决方法：
  • 修改 .env 文件中的 NGINX_HTTP_PORT 和 NGINX_HTTPS_PORT 为其他端口（例如：8080 → 8081）。
  • 修改后，运行 docker compose down 然后运行 docker compose up -d。

3. 数据无法保存

• 原因：Docker 数据卷可能未正确配置。
• 解决方法：
  • 使用 docker compose down 停止服务。
  • 使用 docker volume ls 检查数据卷，并使用 docker volume rm <volume_name> 删除不需要的数据卷。
  • 使用 docker compose up -d 重新启动。

4. 补充信息

1. Docker Compose 基本命令

• 启动服务：docker compose up -d
• 停止服务：docker compose down
• 查看容器状态：docker compose ps
• 查看日志：docker compose logs -f

2. 如何添加模型

1. 登录 Dify 管理后台。
2. 从左侧菜单中选择 “Model Providers”。
3. 点击 “Add Model” 按钮，然后输入您要使用的模型（例如 OpenAI、Google Gemini）的 API 密钥。

3. 支持与更新

• 官方文档：Dify 官方网站
• 社区：GitHub、Discord
• 更新方法：在源代码目录中运行 git pull，然后使用 docker compose up -d 重新启动。

以上是 Dify 的安装方法。如果步骤中遇到任何问题，请咨询社区或官方支持。即使是初次使用 Docker 的用户，只要仔细按照步骤操作，应该也能顺利运行。