Dify的本地安装主要通过Docker部署实现，以下是详细步骤及注意事项：

一、前置准备

1. 系统要求：支持Windows 10/11（需WSL）、Linux（Ubuntu/CentOS等）或macOS，建议CPU≥2核、内存≥4G。
2. 安装Docker：
   • Windows：安装Docker Desktop并配置镜像加速源（如清华源）以提高下载速度
   • Linux：执行命令 sudo apt install docker.io docker-compose
3. 其他工具：确保已安装Git用于代码拉取

二、安装流程

1. 获取Dify源码：

   git clone https://github.com/langgenius/dify.git
   cd dify/docker  # 进入docker配置目录
   

   或从GitHub直接下载ZIP包解压（适合无Git环境）

2. 配置环境变量：

   • 复制模板文件：cp .env.example .env
   • 修改关键参数：数据库密码（POSTGRES_PASSWORD）、Redis密码（REDIS_PASSWORD）等
   • 国内用户需额外设置：
     • 修改docker-compose.yaml中的镜像源（如替换ghcr.io为ghcr.mirrorify.net）
     • 添加清华pip镜像源加速插件安装：pip_mirror_url=https://pypi.tuna.tsinghua.edu.cn/simple

3. 启动服务：

   docker compose up -d  # 自动创建PostgreSQL、Redis、Nginx等容器
   

三、访问与初始化

1. 浏览器访问：输入 http://127.0.0.1（Windows/Localhost）或服务器IP+端口（默认80/3000）
2. 账号注册：首次访问需创建管理员账户（邮箱+密码）
3. 模型配置：
   • 进入「设置」→「模型供应商」绑定API Key（如DeepSeek）
   • 免费API获取：部分平台提供测试用Key（需参考具体教程）

四、常见问题解决

1. 镜像拉取失败：
   • 更换Docker镜像源（如阿里云、中科大源）
   • 手动下载镜像后导入：docker load -i image.tar
2. 端口冲突：
   • 修改.env中的expose_nginx_port为1024以上端口
3. 插件安装超时：
   • 检查dify-plugin-daemon容器日志：docker logs -f 容器ID
   • 延长超时时间：python_env_init_timeout=300（单位：秒）