Windows 11 安装 Dify 完整指南
前置要求
- Python 3.11
- Node.js 18+
- PostgreSQL 14+
- Redis for Windows
- Git
- Ollama (可选,用于本地模子)
具体安装步骤
1. 安装必要软件
- Python 3.11
- 从 https://www.python.org/downloads/release/python-3110/ 下载安装
- 安装时勾选 “Add Python to PATH”
- Node.js 18
- 从 https://nodejs.org/ 下载 18.x LTS 版本
- 设置 npm 镜像:
- npm config set registry https://registry.npmmirror.com
复制代码
- PostgreSQL 14
- 从 https://www.postgresql.org/download/windows/ 下载
- 记住设置的超级用户暗码
- 默认端口 5432
- Redis
- 从 https://github.com/microsoftarchive/redis/releases 下载
- 安装 Redis-x64-3.0.504.msi
requirements.txt
- # requirements.txt
- anthropic==0.23.1
- authlib==1.3.1
- azure-ai-inference==1.0.0b8
- azure-ai-ml==1.20.0
- azure-identity==1.16.1
- beautifulsoup4==4.12.2
- boto3==1.36.12
- bs4==0.0.1
- cachetools==5.3.0
- celery==5.4.0
- chardet==5.1.0
- cohere==5.2.4
- dashscope[tokenizer]==1.17.0
- fal-client==0.5.6
- flask==3.1.0
- flask-compress==1.17
- flask-cors==4.0.0
- flask-login==0.6.3
- flask-migrate==4.0.7
- flask-restful==0.3.10
- flask-sqlalchemy==3.1.1
- gevent==24.11.1
- gmpy2==2.2.1
- google-ai-generativelanguage==0.6.9
- google-api-core==2.18.0
- google-api-python-client==2.90.0
- google-auth==2.29.0
- google-auth-httplib2==0.2.0
- google-cloud-aiplatform==1.49.0
- google-generativeai==0.8.1
- googleapis-common-protos==1.63.0
- gunicorn==23.0.0
- httpx[socks]==0.27.0
- huggingface-hub==0.16.4
- jieba==0.42.1
- langfuse==2.51.3
- langsmith==0.1.77
- mailchimp-transactional==1.0.50
- markdown==3.5.1
- nomic==3.1.2
- novita-client==0.5.7
- numpy==1.26.4
- oci==2.135.1
- openai==1.61.0
- openpyxl==3.1.5
- opik==1.3.4
- pandas[performance,excel]==2.2.2
- pandas-stubs==2.2.3.241009
- psycogreen==1.0.2
- psycopg2-binary==2.9.6
- pycryptodome==3.19.1
- pydantic==2.9.2
- pydantic-settings==2.6.0
- pydantic_extra_types==2.9.0
- pyjwt==2.8.0
- pypdfium2==4.30.0
- python-docx==1.1.0
- python-dotenv==1.0.1
- pyyaml==6.0.1
- readabilipy==0.2.0
- redis[hiredis]==5.0.3
- replicate==0.22.0
- resend==0.7.0
- sagemaker==2.231.0
- scikit-learn==1.5.1
- sentry-sdk[flask]==1.44.1
- sqlalchemy==2.0.29
- starlette==0.41.0
- tencentcloud-sdk-python-hunyuan==3.0.1294
- tiktoken==0.8.0
- tokenizers==0.15.0
- transformers==4.35.0
- unstructured[docx,epub,md,msg,ppt,pptx]==0.16.1
- validators==0.21.0
- volcengine-python-sdk[ark]==1.0.98
- websocket-client==1.7.0
- xinference-client==0.15.2
- yarl==1.18.3
- youtube-transcript-api==0.6.2
- zhipuai==2.1.5
- # Indirect Dependencies
- kaleido==0.2.1
- rank-bm25==0.2.2
- safetensors==0.4.3
- # Tools Dependencies
- arxiv==2.1.0
- cloudscraper==1.2.71
- duckduckgo-search==6.3.0
- jsonpath-ng==1.6.1
- matplotlib==3.8.2
- mplfonts==0.0.8
- newspaper3k==0.2.8
- nltk==3.9.1
- numexpr==2.9.0
- pydub==0.25.1
- qrcode==7.4.2
- twilio==9.0.4
- vanna[postgres,mysql,clickhouse,duckdb,oracle]==0.7.5
- wikipedia==1.4.0
- yfinance==0.2.40
- # Storage Dependencies
- azure-storage-blob==12.13.0
- bce-python-sdk==0.9.23
- cos-python-sdk-v5==1.9.30
- esdk-obs-python==3.24.6.1
- google-cloud-storage==2.16.0
- opendal==0.45.12
- oss2==2.18.5
- supabase==2.8.1
- tos==2.7.1
- # Vector Database Dependencies
- alibabacloud_gpdb20160503==3.8.0
- alibabacloud_tea_openapi==0.3.9
- chromadb==0.5.20
- clickhouse-connect==0.7.16
- couchbase==4.3.0
- elasticsearch==8.14.0
- opensearch-py==2.4.0
- oracledb==2.2.1
- pgvecto-rs[sqlalchemy]==0.2.1
- pgvector==0.2.5
- pymilvus==2.5.0
- pymochow==1.3.1
- pyobvector==0.1.6
- qdrant-client==1.7.3
- tcvectordb==1.3.2
- tidb-vector==0.0.9
- upstash-vector==0.6.0
- volcengine-compat==1.0.156
- weaviate-client==3.21.0
- # Development Dependencies
- coverage==7.2.4
- faker==32.1.0
- mypy==1.13.0
- pytest==8.3.2
- pytest-benchmark==4.0.0
- pytest-env==1.1.3
- pytest-mock==3.14.0
- types-beautifulsoup4==4.12.0.20241020
- types-flask-cors==5.0.0.20240902
- types-flask-migrate==4.1.0.20250112
- types-html5lib==1.1.11.20241018
- types-openpyxl==3.1.5.20241225
- types-protobuf==5.29.1.20241207
- types-psutil==6.1.0.20241221
- types-psycopg2==2.9.21.20250121
- types-python-dateutil==2.9.0.20241206
- types-pytz==2024.2.0.20241221
- types-pyyaml==6.0.12.20241230
- types-regex==2024.11.6.20241221
- types-requests==2.32.0.20241016
- types-six==1.17.0.20241205
- types-tqdm==4.67.0.20241221
- # Linting Dependencies
- dotenv-linter==0.5.0
- ruff==0.9.2
复制代码 2. 下载并配置 Dify
- # 克隆项目
- 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
复制代码 验证安装
- 访问 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
注意要进入目次api
Dify Backend API 安装与运行
Poetry 安装
- # 安装 Poetry
- pip install poetry
- # 安装 Poetry shell 插件
- poetry self add poetry-plugin-shell
复制代码 Dify 依赖安装
- # 指定 Python 版本
- poetry env use 3.12
- # 安装项目依赖
- poetry install
复制代码 数据库迁移
- poetry run python -m flask db upgrade
复制代码 启动后端服务
- # 启动后端服务
- poetry run python -m flask run --host 0.0.0.0 --port=5001 --debug
复制代码 启动异步使命
- poetry run python -m celery -A app.celery worker \
- -P gevent -c 1 \
- --loglevel INFO \
- -Q dataset,generation,mail,ops_trace,app_deletion
复制代码 免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。 |