### 3.1 前后端分离部署下的 API 配置 在将 Dify 连接到 Python 后端项目时，首要任务是确保前端能够通过 HTTP 请求访问后端服务。Dify 的前端项目通常基于 React 或 Vue 构建，可以通过配置 `.env` 文件来指定后端 API 的地址。例如，在 Vue 项目中，可以设置如下环境变量： ```env VUE_APP_API_SERVER=http://your-python-backend:5000 ``` 此配置项决定了前端请求的目标服务器地址和端口，从而实现与后端服务的通信[^2]。 ### 3.2 使用 Flask 框架构建后端服务 Dify 的 API 后端基于 Flask 构建，并采用模块化设计，使得路由、业务逻辑与数据访问层相互解耦。开发者可以在已有的 Python 项目中引入 Flask 来创建 RESTful API，以便与 Dify 前端集成。以下是一个简单的 Flask API 示例： ```python from flask import Flask, jsonify app = Flask(__name__) @app.route('/api/data', methods=['GET']) def get_data(): return jsonify({"message": "Hello from Python backend!"}) if __name__ == '__main__': app.run(host='0.0.0.0', port=5000) ``` 该服务监听 `/api/data` 路由并返回 JSON 数据，Dify 前端可通过 `fetch` 或 `axios` 等方式调用该接口获取数据[^1]。 ### 3.3 异步任务处理与 Celery 集成 对于需要执行长时间任务（如文件处理、模型推理等）的场景，Dify 后端使用 Celery 来处理后台任务。Python 项目中可以引入 Celery 并连接 Redis 或 RabbitMQ 作为消息中间件。以下是 Celery 的基本配置示例： ```python from celery import Celery celery_app = Celery('tasks', broker='redis://localhost:6379/0') @celery_app.task def background_task(data): # 执行耗时操作 return f"Processed: {data}" ``` 启动 Celery Worker 的命令如下（适用于 Linux / MacOS）： ```bash celery -A your_module.celery_app worker -P gevent -c 1 -Q default --loglevel INFO ``` 这样，前端可提交异步任务并通过轮询或 WebSocket 获取执行结果，提升用户体验[^1]。 ### 3.4 容器化部署与网络配置 为了简化部署流程，Dify 推荐使用 Docker 容器化部署，并结合 Nginx 实现反向代理。在 `docker-compose.yml` 中定义前后端服务，并配置网络互通，确保前端容器可以访问后端 API： ```yaml version: '3' services: frontend: image: dify-frontend ports: - "3000:3000" environment: - VUE_APP_API_SERVER=http://backend:5000 depends_on: - backend backend: image: python-backend ports: - "5000:5000" command: flask run --host=0.0.0.0 ``` 上述配置中，前端容器通过 `http://backend:5000` 访问后端服务，而无需关心具体的 IP 地址，便于服务发现和维护。 ### 3.5 安全性与认证机制 Dify 支持 OAuth 2.0 认证、RBAC 权限控制，并兼容企业级 SSO 方案。Python 后端项目应集成相应的安全机制，例如使用 `Flask-JWT` 或 `Authlib` 实现 Token 认证。以下是一个 JWT 认证的基本示例： ```python from flask_jwt_extended import create_access_token, jwt_required @app.route('/login', methods=['POST']) def login(): username = request.json.get('username') password = request.json.get('password') if valid_credentials(username, password): access_token = create_access_token(identity=username) return jsonify(access_token=access_token), 200 else: return jsonify({"msg": "Invalid credentials"}), 401 @app.route('/protected', methods=['GET']) @jwt_required() def protected(): return jsonify(logged_in_as=current_user) ``` 前端在调用受保护的 API 时需携带 `Authorization` 头，格式为 `Bearer <token>`，以确保安全性[^4]。 ---