# Windows 11 安装 Dify 完整指南## 前置要求- Python 3.11
- Node.js 18+
- PostgreSQL 14+
- Redis for Windows
- Git
- Ollama (可选,用于本地模型)## 详细安装步骤### 1. 安装必要软件1. **Python 3.11**- 从 https://www.python.org/downloads/release/python-3110/ 下载安装- 安装时勾选 "Add Python to PATH"2. **Node.js 18**- 从 https://nodejs.org/ 下载 18.x LTS 版本- 设置 npm 镜像:```bashnpm config set registry https://registry.npmmirror.com```3. **PostgreSQL 14**- 从 https://www.postgresql.org/download/windows/ 下载- 记住设置的超级用户密码- 默认端口 54324. **Redis**- 从 https://github.com/microsoftarchive/redis/releases 下载- 安装 Redis-x64-3.0.504.msi### 2. 下载并配置 Dify````bash
# 克隆项目
git clone https://gitee.com/dify_ai/dify.git
cd dify# 创建并激活虚拟环境
cd api
python -m venv venv
.\venv\Scripts\activate# 更新 pip
python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple# 安装基础依赖
pip install wheel setuptools -i https://pypi.tuna.tsinghua.edu.cn/simple# 安装项目依赖
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple# 安装 PyTorch 和 AI 相关依赖
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install transformers accelerate optimum -i https://pypi.tuna.tsinghua.edu.cn/simple
3. 配置环境
# 复制环境配置文件
copy .env.example .env
修改 .env
文件中的关键配置:
DB_USERNAME=postgres
DB_PASSWORD=你的PostgreSQL密码
DB_HOST=localhost
DB_PORT=5432
DB_DATABASE=difyOLLAMA_API_BASE_URL=http://localhost:11434
OLLAMA_PROXY_API_KEY=your_key_here
4. 初始化数据库
# 创建数据库
psql -U postgres
CREATE DATABASE dify;
\q# 初始化数据库架构
flask db upgrade
flask init
5. 安装前端依赖
# 切换到前端目录
cd ..\web# 安装依赖
npm install# 复制前端环境配置
copy .env.example .env.local
6. 启动服务
# 终端 1 - 启动后端 (在 api 目录下)
# 确保激活了虚拟环境 (venv)
flask run --debug --host 0.0.0.0 --port 5001# 终端 2 - 启动前端 (在 web 目录下)
npm run dev
验证安装
- 访问 http://localhost:3000
- 默认管理员账号:admin@foo.bar
- 默认密码:12345678
常见问题解决
-
虚拟环境问题
# 检查 Python 路径 where python # 应显示: C:\path\to\dify\api\venv\Scripts\python.exe
-
依赖安装失败
# 使用预编译包 pip install 包名 --only-binary :all:
-
服务启动检查
- PostgreSQL 服务是否运行
- Redis 服务是否运行
- 虚拟环境是否激活
.env
配置是否正确
-
日志查看
- 后端日志:
api/logs/
- 使用 debug 模式:
flask run --debug
- 后端日志:
维护建议
- 定期备份数据库
- 保持依赖包更新
- 监控日志文件大小
- 定期检查服务状态
这个文档整理了完整的安装流程,包括:
1. 所有必要软件的安装
2. 详细的配置步骤
3. 常见问题的解决方案
4. 维护建议建议按照顺序逐步执行,确保每一步都成功完成后再继续下一步。