Windows 11 安装 Dify 完整指南 非docker环境

# 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 镜像：
     ```bash
     npm config set registry https://registry.npmmirror.com
     ```

3. **PostgreSQL 14**
   - 从 https://www.postgresql.org/download/windows/ 下载
   - 记住设置的超级用户密码
   - 默认端口 5432

4. **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=dify

OLLAMA_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

验证安装

1. 访问 http://localhost:3000
2. 默认管理员账号：[email protected]
3. 默认密码：12345678

常见问题解决

1. 虚拟环境问题

   # 检查 Python 路径
   where python
   # 应显示: C:\path\to\dify\api\venv\Scripts\python.exe

2. 依赖安装失败

   # 使用预编译包
   pip install 包名 --only-binary :all:

3. 服务启动检查

   • PostgreSQL 服务是否运行
   • Redis 服务是否运行
   • 虚拟环境是否激活
   • .env 配置是否正确

4. 日志查看

   • 后端日志：api/logs/
   • 使用 debug 模式：flask run --debug

维护建议

1. 定期备份数据库

2. 保持依赖包更新

3. 监控日志文件大小

4. 定期检查服务状态

   这个文档整理了完整的安装流程，包括：

   1. 所有必要软件的安装
   2. 详细的配置步骤
   3. 常见问题的解决方案
   4. 维护建议

   建议按照顺序逐步执行，确保每一步都成功完成后再继续下一步。