> 目标：本地Dify 独立运行，复用已有 PostgreSQL、Redis、Nginx、Qdrant这些都用得到的中间件，不一起部署。  
> 适合本地/测试学习环境。本文只保留“要怎么配、哪里改、出错怎么处理”，此过程系统环境是mac，别的环境可能不适用需要注意。
---
## 1. 最终架构
 
```text
浏览器
  ↓
Nginx :8088
  ├─ /                 → Dify Web :3000
  └─ /console/api 等   → Dify API :5001
 
Dify
  ├─ PostgreSQL → host.docker.internal:5432
  ├─ Redis      → host.docker.internal:6379
  └─ Qdrant     → host.docker.internal:6333
```
 
Dify Compose 保留这些服务：
 
```text
init_permissions
api
worker
worker_beat
web
plugin_daemon
agent_backend
sandbox
local_sandbox
```
 
---
 
## 2. PostgreSQL
 
先创建两个数据库：
 
```sql
CREATE DATABASE dify;
CREATE DATABASE dify_plugin;
```
 
---
 
## 3. Qdrant 单独部署
 
单独建一个 `docker-compose.yaml`：
 
```yaml
services:
  qdrant:
    image: langgenius/qdrant:v1.8.3
    container_name: qdrant
    restart: unless-stopped
    ports:
      - "6333:6333"
      - "6334:6334"
    environment:
      QDRANT__SERVICE__API_KEY: ${QDRANT_API_KEY}
    volumes:
      - ./data:/qdrant/storage
```
 
同目录 `.env`：
 
```env
QDRANT_API_KEY=your-qdrant-api-key
```
 
启动：
 
```bash
docker compose up -d
```
 
---
 
## 4. Dify `.env` 关键配置
 
Dify 目录下创建 `.env`：
 
```env
# ---------- Dify ----------
SECRET_KEY=<随机值>
DEPLOY_ENV=PRODUCTION
MIGRATION_ENABLED=true
DIFY_BIND_ADDRESS=0.0.0.0
DIFY_PORT=5001
 
# ---------- PostgreSQL ----------
DB_TYPE=postgresql
DB_HOST=host.docker.internal
DB_PORT=5432
DB_USERNAME=postgres
DB_PASSWORD=<数据库密码>
DB_DATABASE=dify
DB_PLUGIN_DATABASE=dify_plugin
 
# ---------- Redis：本次无密码 ----------
REDIS_HOST=host.docker.internal
REDIS_PORT=6379
REDIS_USERNAME=
REDIS_PASSWORD=
REDIS_DB=0
 
CELERY_BROKER_URL=redis://host.docker.internal:6379/1
CELERY_BACKEND=redis
DIFY_AGENT_REDIS_URL=redis://host.docker.internal:6379/2
 
# ---------- Qdrant ----------
VECTOR_STORE=qdrant
QDRANT_URL=http://host.docker.internal:6333
QDRANT_API_KEY=<Qdrant API Key>
QDRANT_GRPC_ENABLED=false
 
# ---------- Sandbox ----------
CODE_EXECUTION_ENDPOINT=http://sandbox:8194
SANDBOX_API_KEY=<随机值>
CODE_EXECUTION_API_KEY=<与 SANDBOX_API_KEY 相同>
 
# ---------- Plugin / Agent ----------
PLUGIN_DAEMON_KEY=<随机值>
PLUGIN_DIFY_INNER_API_KEY=<随机值>
DIFY_AGENT_API_TOKEN=<随机值>
DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN=<随机值>
DIFY_AGENT_SERVER_SECRET_KEY=<32 bytes unpadded base64url>
 
# ---------- 浏览器同源访问 ----------
CONSOLE_API_URL=
APP_API_URL=
CONSOLE_WEB_URL=
APP_WEB_URL=
```
 
生成 `DIFY_AGENT_SERVER_SECRET_KEY`：
 
```bash
python3 -c 'import secrets; print(secrets.token_urlsafe(32))'
```
 
不要直接用普通 Base64 且保留结尾 `=` 的值。该变量要求：
 
```text
unpadded base64url
```
 
---
 
## 5. Dify Compose 关键配置
 
### 5.1 `api` 服务
 
在 `docker-compose.yaml` 的：
 
```yaml
services:
  api:
```
 
下面配置：
 
```yaml
api:
  image: langgenius/dify-api:1.17.0
  restart: unless-stopped
  env_file: .env
 
  environment:
    MODE: api
 
    # API → Plugin Daemon
    PLUGIN_DAEMON_URL: http://plugin_daemon:5002
 
    # API → Agent Backend
    AGENT_BACKEND_BASE_URL: http://agent_backend:5050
    AGENT_BACKEND_API_TOKEN: ${DIFY_AGENT_API_TOKEN}
 
    # Plugin Daemon → Dify API 内部鉴权
    INNER_API_KEY_FOR_PLUGIN: ${PLUGIN_DIFY_INNER_API_KEY}
 
  ports:
    - "5001:5001"
 
  volumes:
    - ./volumes/app/storage:/app/api/storage
 
  extra_hosts:
    - "host.docker.internal:host-gateway"
```
 
---
 
### 5.2 `worker` 服务
 
在：
 
```yaml
services:
  worker:
```
 
下面配置：
 
```yaml
worker:
  image: langgenius/dify-api:1.17.0
  restart: unless-stopped
  env_file: .env
 
  environment:
    MODE: worker
 
    # Worker → Plugin Daemon
    PLUGIN_DAEMON_URL: http://plugin_daemon:5002
 
    AGENT_BACKEND_BASE_URL: http://agent_backend:5050
    AGENT_BACKEND_API_TOKEN: ${DIFY_AGENT_API_TOKEN}
    INNER_API_KEY_FOR_PLUGIN: ${PLUGIN_DIFY_INNER_API_KEY}
 
  volumes:
    - ./volumes/app/storage:/app/api/storage
 
  extra_hosts:
    - "host.docker.internal:host-gateway"
```
 
---
 
### 5.3 `plugin_daemon` 服务
 
在：
 
```yaml
services:
  plugin_daemon:
```
 
下面配置：
 
```yaml
plugin_daemon:
  image: langgenius/dify-plugin-daemon:0.6.10-local
  restart: unless-stopped
  env_file: .env
 
  environment:
    DB_DATABASE: ${DB_PLUGIN_DATABASE}
    DB_SSL_MODE: disable
 
    SERVER_PORT: 5002
    SERVER_KEY: ${PLUGIN_DAEMON_KEY}
 
    # Plugin Daemon → Dify API
    DIFY_INNER_API_URL: http://api:5001
    DIFY_INNER_API_KEY: ${PLUGIN_DIFY_INNER_API_KEY}
 
    # Plugin Daemon 必填
    PLUGIN_REMOTE_INSTALLING_HOST: 0.0.0.0
    PLUGIN_REMOTE_INSTALLING_PORT: 5003
    PLUGIN_WORKING_PATH: /app/cwd
 
    PLUGIN_STORAGE_TYPE: local
    PLUGIN_STORAGE_LOCAL_ROOT: /app/storage
 
  volumes:
    - ./volumes/plugin_daemon:/app/storage
    - ./volumes/plugin_daemon/cwd:/app/cwd
 
  extra_hosts:
    - "host.docker.internal:host-gateway"
```
 
---
 
### 5.4 `sandbox` 服务
 
在：
 
```yaml
services:
  sandbox:
```
 
下面配置：
 
```yaml
sandbox:
  image: langgenius/dify-sandbox:0.2.15
  restart: unless-stopped
  env_file: .env
 
  environment:
    API_KEY: ${SANDBOX_API_KEY}
    GIN_MODE: release
    WORKER_TIMEOUT: 15
    ENABLE_NETWORK: "true"
    SANDBOX_PORT: 8194
 
  volumes:
    - ./volumes/sandbox/dependencies:/dependencies
```
 
不要这样挂：
 
```yaml
sandbox:
  volumes:
    - ./volumes/sandbox/conf:/conf
```
 
如果宿主机 `./volumes/sandbox/conf` 是空目录，会覆盖镜像中的 `/conf`，导致：
 
```text
open conf/config.yaml: no such file or directory
```
 
---
 
### 5.5 `web` 服务
 
```yaml
web:
  image: langgenius/dify-web:1.17.0
  restart: unless-stopped
  env_file: .env
 
  environment:
    SERVER_CONSOLE_API_URL: http://api:5001
 
  ports:
    - "3000:3000"
```
 
这里：
 
```text
http://api:5001
```
 
是 Docker Compose 内部通信地址，不要改成 Nginx 的 `8088`。

总compose
```yaml
services:
  init_permissions:
    image: busybox:latest
    command: ["sh", "-c", "chown -R 1001:1001 /app/api/storage"]
    restart: "no"
    volumes:
      - ./volumes/app/storage:/app/api/storage

  api:
    image: langgenius/dify-api:1.17.0
    restart: unless-stopped
    env_file: .env
    environment:
      MODE: api
      PLUGIN_DAEMON_URL: http://plugin_daemon:5002
      INNER_API_KEY_FOR_PLUGIN: ${PLUGIN_DIFY_INNER_API_KEY}
      AGENT_BACKEND_BASE_URL: http://agent_backend:5050
      AGENT_BACKEND_API_TOKEN: ${DIFY_AGENT_API_TOKEN}
    ports:
      - "5001:5001"
    volumes:
      - ./volumes/app/storage:/app/api/storage
    extra_hosts:
      - "host.docker.internal:host-gateway"
    depends_on:
      init_permissions:
        condition: service_completed_successfully
      plugin_daemon:
        condition: service_started
      agent_backend:
        condition: service_started

  worker:
    image: langgenius/dify-api:1.17.0
    restart: unless-stopped
    env_file: .env
    environment:
      MODE: worker
      PLUGIN_DAEMON_URL: http://plugin_daemon:5002
      INNER_API_KEY_FOR_PLUGIN: ${PLUGIN_DIFY_INNER_API_KEY}
      AGENT_BACKEND_BASE_URL: http://agent_backend:5050
      AGENT_BACKEND_API_TOKEN: ${DIFY_AGENT_API_TOKEN}
    volumes:
      - ./volumes/app/storage:/app/api/storage
    extra_hosts:
      - "host.docker.internal:host-gateway"
    depends_on:
      init_permissions:
        condition: service_completed_successfully
      plugin_daemon:
        condition: service_started
      agent_backend:
        condition: service_started

  web:
    image: langgenius/dify-web:1.17.0
    restart: unless-stopped
    env_file: .env
    environment:
      SERVER_CONSOLE_API_URL: http://api:5001
    ports:
      - "3000:3000"
    depends_on:
      - api

  sandbox:
    image: langgenius/dify-sandbox:0.2.15
    restart: unless-stopped
    env_file: .env
    environment:
      API_KEY: ${SANDBOX_API_KEY}
      GIN_MODE: release
      WORKER_TIMEOUT: 15
      ENABLE_NETWORK: "true"
      SANDBOX_PORT: 8194
    volumes:
      - ./volumes/sandbox/dependencies:/dependencies

  plugin_daemon:
    image: langgenius/dify-plugin-daemon:0.6.10-local
    restart: unless-stopped
    env_file: .env
    environment:
      DB_DATABASE: ${DB_PLUGIN_DATABASE}
      DB_SSL_MODE: disable
      SERVER_PORT: 5002
      SERVER_KEY: ${PLUGIN_DAEMON_KEY}
      DIFY_INNER_API_URL: http://api:5001
      DIFY_INNER_API_KEY: ${PLUGIN_DIFY_INNER_API_KEY}
      PLUGIN_REMOTE_INSTALLING_HOST: 0.0.0.0
      PLUGIN_REMOTE_INSTALLING_PORT: 5003
      PLUGIN_WORKING_PATH: /app/cwd
      PLUGIN_STORAGE_TYPE: local
      PLUGIN_STORAGE_LOCAL_ROOT: /app/storage
    volumes:
      - ./volumes/plugin_daemon:/app/storage
      - ./volumes/plugin_daemon/cwd:/app/cwd
    ports:
      - "5002:5002"
    extra_hosts:
      - "host.docker.internal:host-gateway"

  agent_backend:
    image: langgenius/dify-agent-backend:1.17.0
    restart: unless-stopped
    env_file: .env
    environment:
      DIFY_AGENT_RUNTIME_BACKEND: local
      DIFY_AGENT_REDIS_URL: ${DIFY_AGENT_REDIS_URL}
      DIFY_AGENT_PLUGIN_DAEMON_URL: http://plugin_daemon:5002
      DIFY_AGENT_PLUGIN_DAEMON_API_KEY: ${PLUGIN_DAEMON_KEY}
      DIFY_AGENT_INNER_API_URL: http://api:5001
      DIFY_AGENT_INNER_API_KEY: ${PLUGIN_DIFY_INNER_API_KEY}
      DIFY_AGENT_LOCAL_SANDBOX_ENDPOINT: http://local_sandbox:5004
      DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN: ${DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN}
      DIFY_AGENT_SANDBOX_FILES_BASE_URL: http://api:5001
      DIFY_AGENT_SERVER_SECRET_KEY: ${DIFY_AGENT_SERVER_SECRET_KEY}
      DIFY_AGENT_API_TOKEN: ${DIFY_AGENT_API_TOKEN}
    extra_hosts:
      - "host.docker.internal:host-gateway"
    depends_on:
      - plugin_daemon
      - local_sandbox

  local_sandbox:
    image: langgenius/dify-agent-local-sandbox:1.17.0
    restart: unless-stopped
    environment:
      SHELLCTL_AUTH_TOKEN: ${DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN}
```

 | 服务 | 作用 | 不启动的影响 |
  |---|---|---|
  | `api` | Dify 后端主服务：登录、应用、知识库、模型配置、接口 | 核心不可用 |
  | `web` | Dify 前端控制台与应用页面 | 浏览器访问会 502；API 仍可被程序调用 |
  | `worker` | 异步任务：文档解析、向量化、工作流后台执行、邮件等 | 上传知识库、索引、部分工作流会一直等待或失败 |
  | `plugin_daemon` | 插件运行和管理：模型供应商、工具、Marketplace 插件 | 插件、模型提供商和工具调用不可用 |
  | `sandbox` | 普通代码节点的隔离执行环境 | Workflow 中的“代码执行”节点不可用 |
  | `agent_backend` | 1.17 的 Agent 运行后端，处理 Agent 会话、工具运行和状态 | Agent 类应用或 Agent 节点不可用 |
  | `local_sandbox` | 给 `agent_backend` 提供本地 Shell 工作区 | Agent 的 Shell、文件工作区及相关工具不可用 |

---
 
## 6. Nginx 配置
 
已有 Nginx 容器继续使用 `80`，Dify 单独增加 `8088`。
 
Nginx 的 Compose：
 
```yaml
ports:
  - "80:80"
  - "8088:8088"
```
 
Nginx 配置新增一个 `server`：
 
```nginx
server {
    listen 8088;
    server_name _;
 
    client_max_body_size 100M;
 
    proxy_connect_timeout 60s;
    proxy_send_timeout 3600s;
    proxy_read_timeout 3600s;
 
    location /console/api/ {
        proxy_pass http://host.docker.internal:5001;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;
    }
 
    location /api/ {
        proxy_pass http://host.docker.internal:5001;
    }
 
    location /v1/ {
        proxy_pass http://host.docker.internal:5001;
    }
 
    location /files/ {
        proxy_pass http://host.docker.internal:5001;
    }
 
    location / {
        proxy_pass http://host.docker.internal:3000;
    }
}
```
 
注意：
 
```nginx
proxy_pass http://host.docker.internal:5001;
```
 
末尾不要加 `/`，避免 `/console/api/...` 被错误改写。
 
浏览器最终访问：
 
```text
http://127.0.0.1:8088
```
 
---
 
## 7. 启动
 
```bash
docker compose up -d
```
 
查看状态：
 
```bash
docker compose ps
```
 
服务不要出现反复：
 
```text
Exited
Restarting
```
 
---
 
## 8. 启动后快速验证
 
先验证 API：
 
```bash
curl -i http://127.0.0.1:5001/console/api/ping
```
 
正常：
 
```json
{"result":"pong"}
```
 
再验证初始化状态：
 
```bash
curl -i http://127.0.0.1:5001/console/api/setup
```
 
首次安装正常会返回：
 
```json
{"step":"not_started","setup_at":null}
```
 
然后浏览器访问：
 
```text
http://127.0.0.1:8088
```
 
完成管理员初始化。
 
---
 
# 9. 本次实际遇到的问题
 
## 9.1 `DIFY_AGENT_SERVER_SECRET_KEY` 格式错误
 
报错：
 
```text
DIFY_AGENT_SERVER_SECRET_KEY must decode to exactly 32 decoded bytes
```
 
或者：
 
```text
DIFY_AGENT_SERVER_SECRET_KEY must be valid unpadded base64url text
```
 
### 修改位置
 
Dify `.env`：
 
```env
DIFY_AGENT_SERVER_SECRET_KEY=<正确值>
```
 
生成：
 
```bash
python3 -c 'import secrets; print(secrets.token_urlsafe(32))'
```
 
---
 
## 9.2 Sandbox 找不到 `conf/config.yaml`
 
报错：
 
```text
failed to init config
open conf/config.yaml: no such file or directory
```
 
### 原因
 
`docker-compose.yaml` 的：
 
```yaml
services:
  sandbox:
    volumes:
      - ./volumes/sandbox/conf:/conf
```
 
把宿主机空目录挂到了容器 `/conf`。
 
### 解决
 
从：
 
```yaml
services:
  sandbox:
    volumes:
```
 
中删除：
 
```yaml
- ./volumes/sandbox/conf:/conf
```
 
最终只保留：
 
```yaml
sandbox:
  volumes:
    - ./volumes/sandbox/dependencies:/dependencies
```
 
---
 
## 9.3 Plugin Daemon：`remote installing host is empty`
 
报错：
 
```text
invalid configuration: plugin remote installing host is empty
```
 
### 修改位置
 
`docker-compose.yaml`：
 
```yaml
services:
  plugin_daemon:
    environment:
```
 
增加：
 
```yaml
PLUGIN_REMOTE_INSTALLING_HOST: 0.0.0.0
PLUGIN_REMOTE_INSTALLING_PORT: 5003
```
 
即：
 
```yaml
plugin_daemon:
  environment:
    PLUGIN_REMOTE_INSTALLING_HOST: 0.0.0.0
    PLUGIN_REMOTE_INSTALLING_PORT: 5003
```
 
---
 
## 9.4 Plugin Daemon：`plugin working path is empty`
 
报错：
 
```text
invalid configuration: plugin working path is empty
```
 
### 修改位置 1：`plugin_daemon.environment`
 
增加：
 
```yaml
plugin_daemon:
  environment:
    PLUGIN_WORKING_PATH: /app/cwd
```
 
### 修改位置 2：`plugin_daemon.volumes`
 
增加：
 
```yaml
plugin_daemon:
  volumes:
    - ./volumes/plugin_daemon/cwd:/app/cwd
```
 
 
---
 
## 9.5 Web 启动时 `ECONNREFUSED api:5001`
 
日志：
 
```text
connect ECONNREFUSED 172.x.x.x:5001
```
 
通常是 Web 比 API 更早启动。
 
如果稍后：
 
```bash
curl http://127.0.0.1:5001/console/api/ping
```
 
能够正常返回：
 
```json
{"result":"pong"}
```
 
并且错误不再持续出现，可以忽略。
 
---
 
## 9.6 `/console/api/setup` 返回 404，但 API 容器内部正常
 
宿主机：
 
```bash
curl http://127.0.0.1:5001/console/api/setup
```
 
返回：
 
```text
404
Server: Werkzeug/...
```
 
但 API 容器内部：
 
```bash
docker compose exec -T api python - <<'PY'
import urllib.request
 
print(
    urllib.request.urlopen(
        "http://127.0.0.1:5001/console/api/setup"
    ).read().decode()
)
PY
```
 
却返回：
 
```json
{"step":"not_started","setup_at":null}
```
 
### 原因
 
宿主机 `5001` 被另一个 Python/Flask 进程占用了。
 
Mac 检查：
 
```bash
lsof -nP -iTCP:5001 -sTCP:LISTEN
```
 
本次实际看到两个监听：
 
```text
Docker   IPv6 :5001
Python   IPv4 :5001
```
 
访问：
 
```text
127.0.0.1:5001
```
 
是 IPv4，所以请求打到了旧 Python 服务。
 
### 解决
 
停止冲突进程。
 
或者修改 `docker-compose.yaml`：
 
```yaml
services:
  api:
    ports:
      - "15001:5001"
```
 
然后 Nginx 改为：
 
```nginx
proxy_pass http://host.docker.internal:15001;
```
 
注意：Dify 容器内部仍然使用：
 
```text
api:5001
```
 
不要改成 `api:15001`。
 
---
 
## 9.7 模型供应商页面 400
 
接口：
 
```text
/console/api/workspaces/current/models/model-types/llm
/console/api/workspaces/current/model-providers/summary
```
 
报错：
 
```text
Failed to request plugin daemon
```
 
### 原因
 
`api` / `worker` 没有配置 Plugin Daemon 地址。
 
### 修改位置 1：`api.environment`
 
```yaml
services:
  api:
    environment:
      PLUGIN_DAEMON_URL: http://plugin_daemon:5002
```
 
### 修改位置 2：`worker.environment`
 
```yaml
services:
  worker:
    environment:
      PLUGIN_DAEMON_URL: http://plugin_daemon:5002
```
 
修改后：
 
```bash
docker compose up -d --force-recreate api worker
```
 
确认：
 
```bash
docker compose exec -T api env | grep PLUGIN_DAEMON
```
 
应该能看到：
 
```text
PLUGIN_DAEMON_URL=http://plugin_daemon:5002
```
 
注意：
 
```text
DIFY_AGENT_PLUGIN_DAEMON_URL
```
 
是：
 
```text
agent_backend → plugin_daemon
```
 
使用的。
 
而：
 
```text
PLUGIN_DAEMON_URL
```
 
是：
 
```text
api / worker → plugin_daemon
```
 
使用的。
 
不是同一个变量。
 
---
 
# 10. 推荐排错顺序
 
按这个顺序排，不要一开始就乱改配置。
 
### 第一步：看容器状态
 
```bash
docker compose ps
```
 
### 第二步：看具体服务日志
 
```bash
docker compose logs --tail=100 api
docker compose logs --tail=100 plugin_daemon
docker compose logs --tail=100 sandbox
```
 
### 第三步：直接测试 API
 
```bash
curl http://127.0.0.1:5001/console/api/ping
```
 
### 第四步：宿主机异常时，测试容器内部
 
```bash
docker compose exec -T api python - <<'PY'
import urllib.request
print(
    urllib.request.urlopen(
        "http://127.0.0.1:5001/console/api/ping"
    ).read().decode()
)
PY
```
 
如果：
 
```text
容器内正常
宿主机异常
```
 
优先检查端口冲突。
 
### 第五步：检查宿主机端口
 
Mac：
 
```bash
lsof -nP -iTCP:5001 -sTCP:LISTEN
```
 
Linux：
 
```bash
ss -lntp | grep ':5001'
```
 
### 第六步：模型/插件异常
 
检查：
 
```bash
docker compose exec -T api env | grep PLUGIN_DAEMON
```
 
确认存在：
 
```text
PLUGIN_DAEMON_URL=http://plugin_daemon:5002
```
 
### 第七步：最后再查 Nginx
 
只有 API 自己正常后，再检查：
 
```text
8088 → Nginx → 5001 / 3000
```
 
---
 
# 11. 记住一个原则
 
## 同一个 Dify Compose 内
 
直接用 Docker 服务名：
 
```text
api:5001
plugin_daemon:5002
agent_backend:5050
sandbox:8194
```
 
例如：
 
```yaml
PLUGIN_DAEMON_URL: http://plugin_daemon:5002
```
 
## 访问其他 Compose 或宿主机已有服务
 
使用：
 
```text
host.docker.internal:<宿主机端口>
```
 
例如：
 
```text
host.docker.internal:5432
host.docker.internal:6379
host.docker.internal:6333
```
 
Linux Docker 如果解析不到 `host.docker.internal`，对应 service 增加：
 
```yaml
extra_hosts:
  - "host.docker.internal:host-gateway"
```

目标：本地Dify 独立运行，复用已有 PostgreSQL、Redis、Nginx、Qdrant这些都用得到的中间件，不一起部署。

Dify 1.17 新手精简部署以及问题排查指南

精简版本地Dify 独立运行，默认 PostgreSQL、Redis、Nginx、Qdrant这些都用得到的中间件 开发人员自己有。

人工智能

本地部署Dify时复用已有PostgreSQL、Redis、Nginx、Qdrant，需在docker-compose中配置api、worker、plugin_daemon等7个服务，通过host.docker.internal连接外部中间件，并确保各服务间通过Docker内部网络通信。关键配置包括API密钥生成、Sandbox卷挂载路径修正、PluginDaemon参数设置及Nginx反向代理8088端口。排查故障需按容器状态、日志、API测试、端口冲突、插件配置的顺序进行。

代码解释

PostgreSQL

中间件

数据库

Docker

容器

Python

Redis

Linux

Nginx

Agent

JSON

2026上云采购 | AI焕新·智启新局

lexiang

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

本地部署Dify时复用已有PostgreSQL、Redis、Nginx、Qdrant，需在docker-compose中配置api、worker、plugin_daemon等7个服务，通过host.docker.internal连接外部中间件，并确保各服务间通过Docker内部网络通信。关键配置包括API密钥生成、Sa...

Dify 1.17 新手精简部署以及问题排查指南-腾讯云开发者社区-腾讯云

Dify 1.17 新手精简部署以及问题排查指南

Dify 1.17 新手精简部署以及问题排查指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐