Docker
HTTP
Kubernetes
PostgreSQL
Posts
Python

Dify 应用发布和部署#

概述#

Dify 提供多种发布和部署方式，让你可以将创建的 AI 应用快速推向用户。本文将详细介绍如何将应用发布为 Web 站点、API 工具，以及如何进行私有化部署。

发布方式概览#

发布方式	复杂度	适用场景	特点
Web 应用	低	快速分享、用户体验	几分钟即可发布
API 工具	中	集成到现有系统	灵活的 API 接口
MCP 服务器	高	Claude Desktop 集成	新兴标准协议
私有化部署	高	企业级应用	数据隐私、完全控制

发布为 Web 应用#

快速发布#

步骤：

进入应用详情页
点击发布
选择 发布更新
等待发布完成

访问地址：

PRTCL // PLAINTEXT

1
https://cloud.dify.ai/chatbot/xxx

Web 应用设置#

基础设置：

PRTCL // YAML

1
Web 应用配置:
2
  enabled: true
3
  site_name: "我的应用"
4
  site_title: "AI 助手"
5
  description: "这是一个智能 AI 助手"
6
  icon: "https://example.com/icon.png"

主题配置：

PRTCL // YAML

1
主题配置:
2
  primary_color: "#007AFF"
3
  background_color: "#F5F5F5"
4
  text_color: "#333333"
5
  font_family: "Inter, sans-serif"
6
  border_radius: 8

高级设置：

PRTCL // YAML

1
高级配置:
2
  custom_domain: "app.example.com"
3
  ssl_enabled: true
4
  analytics:
5
    enabled: true
6
    provider: "google_analytics"
7
    tracking_id: "UA-XXXXXXXXX"

功能配置#

对话设置：

PRTCL // YAML

1
对话配置:
2
  opening_statement: "您好！有什么可以帮您的吗？"
3
  suggested_questions:
4
    - "如何使用产品？"
5
    - "产品有哪些功能？"
6
    - "常见问题有哪些？"
7
  voice_input:
8
    enabled: true
9
    language: "zh-CN"
10
  voice_output:
11
    enabled: true
12
    voice: "female"

显示设置：

PRTCL // YAML

1
显示配置:
2
  show_branding: false  # 隐藏 Dify 品牌信息
3
  show_footer: true
4
  show_header: true
5
  show_share_button: true

访问控制#

公开访问：

PRTCL // YAML

1
访问控制:
2
  type: "public"
3
  authentication: false

私有访问：

PRTCL // YAML

1
访问控制:
2
  type: "private"
3
  authentication: true
4
  allowed_users:
5
    - "user@example.com"
6
    - "user2@example.com"

密码保护：

PRTCL // YAML

1
访问控制:
2
  type: "password"
3
  password: "your_password"

API 集成#

生成 API 凭据#

步骤：

进入应用详情页
点击 API Access
点击 创建凭据
输入凭据名称
点击创建
保存 API Key

API 文档#

Dify 会自动生成完整的 API 文档，包括：

端点 URL
请求方法
请求参数
响应格式
示例代码

查看文档：

进入 API Access 页面
点击 查看文档
查看详细的 API 说明

文本生成 API#

端点：POST https://api.dify.ai/v1/completion-messages

请求示例：

PRTCL // BASH

1
curl --location --request POST 'https://api.dify.ai/v1/completion-messages' \
2
  --header 'Authorization: Bearer YOUR_API_KEY' \
3
  --header 'Content-Type: application/json' \
4
  --data-raw '{
5
    "inputs": {
6
      "text": "Hello, how are you?"
7
    },
8
    "response_mode": "streaming",
9
    "user": "abc-123"
10
  }'

Python 示例：

PRTCL // PYTHON

1
import requests
2
import json
3

4
url = "https://api.dify.ai/v1/completion-messages"
5
headers = {
6
    'Authorization': 'Bearer YOUR_API_KEY',
7
    'Content-Type': 'application/json',
8
}
9
data = {
10
    "inputs": {
11
        "text": "Hello, how are you?"
12
    },
13
    "response_mode": "streaming",
14
    "user": "abc-123"
15
}
16
response = requests.post(url, headers=headers, json=data)
17
print(response.text)

对话 API#

端点：POST https://api.dify.ai/v1/chat-messages

请求示例：

PRTCL // BASH

1
curl --location --request POST 'https://api.dify.ai/v1/chat-messages' \
2
  --header 'Authorization: Bearer YOUR_API_KEY' \
3
  --header 'Content-Type: application/json' \
4
  --data-raw '{
5
    "inputs": {},
6
    "query": "Hello",
7
    "response_mode": "streaming",
8
    "conversation_id": "",
9
    "user": "abc-123"
10
  }'

Python 示例：

PRTCL // PYTHON

1
import requests
2
import json
3

4
url = 'https://api.dify.ai/v1/chat-messages'
5
headers = {
6
    'Authorization': 'Bearer YOUR_API_KEY',
7
    'Content-Type': 'application/json',
8
}
9
data = {
10
    "inputs": {},
11
    "query": "Hello",
12
    "response_mode": "streaming",
13
    "conversation_id": "",
14
    "user": "abc-123"
15
}
16
response = requests.post(url, headers=headers, json=data)
17
print(response.text)

API 安全#

最佳实践：

PRTCL // YAML

1
安全配置:
2
  credentials:
3
    development:
4
      api_key: "${DIFY_DEV_API_KEY}"
5
    testing:
6
      api_key: "${DIFY_TEST_API_KEY}"
7
    production:
8
      api_key: "${DIFY_PROD_API_KEY}"
9

10
  security:
11
    rate_limit: 100  # 每小时 100 次
12
    ip_whitelist: true
13
    allowed_ips:
14
      - "192.168.1.0/24"
15
      - "10.0.0.0/8"

发布为 MCP 服务器#

什么是 MCP#

MCP（Model Context Protocol）是一种让 AI 工具之间相互通信的标准协议。通过 MCP，你可以将 Dify 应用集成到 Claude Desktop 等 AI 工具中。

发布步骤#

步骤：

进入应用详情页
点击发布
选择 发布为 MCP 服务器
配置 MCP 参数
点击发布

MCP 配置#

基础配置：

PRTCL // YAML

1
MCP 配置:
2
  enabled: true
3
  server_name: "my-dify-app"
4
  description: "我的 Dify 应用"
5
  version: "1.0.0"

工具配置：

PRTCL // YAML

1
工具配置:
2
  tools:
3
    - name: "generate_content"
4
      description: "生成内容"
5
      input_schema:
6
        type: "object"
7
        properties:
8
          topic:
9
            type: "string"
10
            description: "主题"
11
          style:
12
            type: "string"
13
            description: "风格"
14
        required:
15
          - "topic"

使用 MCP#

在 Claude Desktop 中使用：

打开 Claude Desktop
进入设置
添加 MCP 服务器
输入 Dify 提供的 MCP URL
开始使用

私有化部署#

部署方式#

Dify 支持多种私有化部署方式：

方式	复杂度	适用场景
Docker	低	小规模部署
Docker Compose	中	中等规模部署
Kubernetes	高	大规模部署
源码部署	高	自定义部署

Docker 部署#

步骤：

PRTCL // BASH

1
# 拉取镜像
2
docker pull langgenius/dify:latest
3

4
# 运行容器
5
docker run -d \
6
  --name dify \
7
  -p 80:80 \
8
  -e DATABASE_URL="postgresql://user:password@host:5432/dify" \
9
  -e REDIS_URL="redis://host:6379" \
10
  langgenius/dify:latest

Docker Compose 部署#

docker-compose.yml：

PRTCL // YAML

1
version: '3.8'
2

3
services:
4
  dify-web:
5
    image: langgenius/dify-web:latest
6
    ports:
7
      - "3000:3000"
8
    depends_on:
9
      - dify-api
10
    environment:
11
      - API_URL=http://dify-api:5001
12

13
  dify-api:
14
    image: langgenius/dify-api:latest
15
    ports:
16
      - "5001:5001"
17
    depends_on:
18
      - db
19
      - redis
20
    environment:
21
      - DATABASE_URL=postgresql://postgres:postgres@db:5432/dify
22
      - REDIS_URL=redis://redis:6379/0
23

24
  db:
25
    image: postgres:15-alpine
26
    volumes:
27
      - ./data/postgres:/var/lib/postgresql/data
28
    environment:
29
      - POSTGRES_DB=dify
30
      - POSTGRES_USER=postgres
31
      - POSTGRES_PASSWORD=postgres
32

33
  redis:
34
    image: redis:7-alpine
35
    volumes:
36
      - ./data/redis:/data

启动服务：

PRTCL // BASH

1
docker-compose up -d

Kubernetes 部署#

deployment.yaml：

PRTCL // YAML

1
apiVersion: apps/v1
2
kind: Deployment
3
metadata:
4
  name: dify-api
5
spec:
6
  replicas: 3
7
  selector:
8
    matchLabels:
9
      app: dify-api
10
  template:
11
    metadata:
12
      labels:
13
        app: dify-api
14
    spec:
15
      containers:
16
      - name: dify-api
17
        image: langgenius/dify-api:latest
18
        ports:
19
        - containerPort: 5001
20
        env:
21
        - name: DATABASE_URL
22
          value: "postgresql://postgres:postgres@db:5432/dify"
23
        - name: REDIS_URL
24
          value: "redis://redis:6379/0"

启动服务：

PRTCL // BASH

1
kubectl apply -f deployment.yaml

监控和维护#

监控指标#

关键指标：

PRTCL // YAML

1
监控指标:
2
  - name: "API 响应时间"
3
    target: "< 1s"
4
  - name: "成功率"
5
    target: "> 99%"
6
  - name: "并发用户数"
7
    target: "< 1000"
8
  - name: "错误率"
9
    target: "< 1%"

日志管理#

日志配置：

PRTCL // YAML

1
日志配置:
2
  level: "info"  # debug, info, warn, error
3
  format: "json"
4
  outputs:
5
    - type: "console"
6
      enabled: true
7
    - type: "file"
8
      enabled: true
9
      path: "/var/log/dify"
10
      max_size: "100M"
11
      max_files: 10

备份策略#

备份配置：

PRTCL // YAML

1
备份配置:
2
  enabled: true
3
  schedule: "0 2 * * *"  # 每天 2:00
4
  retention:
5
    daily: 7
6
    weekly: 4
7
    monthly: 12
8
  storage:
9
    type: "s3"
10
    bucket: "dify-backups"
11
    region: "us-east-1"

安全配置#

认证和授权#

认证配置：

PRTCL // YAML

1
认证配置:
2
  enabled: true
3
  method: "jwt"  # jwt, oauth2, saml
4
  jwt:
5
    secret: "${JWT_SECRET}"
6
    expiration: "24h"
7
    refresh_expiration: "7d"

授权配置：

PRTCL // YAML

1
授权配置:
2
  enabled: true
3
  strategy: "rbac"  # rbac, abac
4
  roles:
5
    - name: "admin"
6
      permissions:
7
        - "app:*"
8
        - "user:*"
9
    - name: "user"
10
      permissions:
11
        - "app:read"
12
        - "app:execute"

数据加密#

加密配置：

PRTCL // YAML

1
加密配置:
2
  enabled: true
3
  at_rest:
4
    algorithm: "AES-256"
5
    key_source: "env"
6
  in_transit:
7
    tls:
8
      enabled: true
9
      min_version: "1.2"

访问控制#

IP 白名单：

PRTCL // YAML

1
IP 白名单:
2
  enabled: true
3
  allowed_ips:
4
    - "192.168.1.0/24"
5
    - "10.0.0.0/8"

性能优化#

缓存策略#

缓存配置：

PRTCL // YAML

1
缓存配置:
2
  enabled: true
3
  provider: "redis"  # redis, memory
4
  ttl: 3600  # 1 小时
5
  max_size: 10000

负载均衡#

负载均衡配置：

PRTCL // YAML

1
负载均衡:
2
  enabled: true
3
  strategy: "round_robin"  # round_robin, least_connections
4
  health_check:
5
    enabled: true
6
    interval: 30
7
    timeout: 10

数据库优化#

数据库配置：

PRTCL // YAML

1
数据库配置:
2
  pool:
3
    min: 5
4
    max: 20
5
    idle_timeout: 300
6
  query_cache:
7
    enabled: true
8
    size: 1000

故障排查#

常见问题#

发布失败：

PRTCL // BASH

1
# 检查日志
2
docker logs dify-api
3

4
# 检查配置
5
docker exec dify-api env | grep DATABASE_URL

API 调用失败：

PRTCL // BASH

1
# 测试连接
2
curl -I https://api.dify.ai/v1
3

4
# 检查 API 密钥
5
echo $DIFY_API_KEY

性能问题：

PRTCL // BASH

1
# 检查资源使用
2
docker stats dify-api
3

4
# 检查数据库连接
5
docker exec dify-api pg_isready

调试工具#

日志查看：

PRTCL // BASH

1
# 查看应用日志
2
docker logs -f dify-api
3

4
# 查看错误日志
5
docker logs dify-api | grep ERROR

性能分析：

PRTCL // BASH

1
# 分析 API 响应时间
2
curl -w "@curl-format.txt" -o /dev/null -s "https://api.dify.ai/v1/completion-messages"

最佳实践#

发布建议#

分阶段发布：先发布到测试环境，再发布到生产环境
版本控制：使用版本号管理发布
灰度发布：逐步放量，监控效果
回滚准备：准备回滚方案

安全建议#

保护密钥：使用环境变量存储密钥
定期轮换：定期更换 API 密钥
监控异常：监控异常访问和行为
权限最小化：最小权限原则

性能建议#

使用缓存：合理使用缓存减少请求
优化数据库：优化查询和索引
负载均衡：使用负载均衡分散流量
监控指标：持续监控性能指标

资源链接#

发布文档: https://docs.dify.ai/zh/use-dify/publish
部署文档: https://docs.dify.ai/zh/use-dify/deploy
MCP 文档: https://docs.dify.ai/zh/use-dify/publish/mcp

最后更新: 2026-03-12 作者: EchoHaoRan

Dify 应用发布和部署#

概述#

发布方式概览#

发布为 Web 应用#

快速发布#

Web 应用设置#

功能配置#

访问控制#

API 集成#

生成 API 凭据#

API 文档#

文本生成 API#

对话 API#

API 安全#

发布为 MCP 服务器#

什么是 MCP#

发布步骤#

MCP 配置#

使用 MCP#

私有化部署#

部署方式#

Docker 部署#

Docker Compose 部署#

Kubernetes 部署#

监控和维护#

监控指标#

日志管理#

备份策略#

安全配置#

认证和授权#

数据加密#

访问控制#

性能优化#

缓存策略#

负载均衡#

数据库优化#

故障排查#

常见问题#

调试工具#

最佳实践#

发布建议#

安全建议#

性能建议#

资源链接#

Dify应用发布和部署

Dify应用类型详解

ClaudeCode如何部署？如何使用第三方模型？

在飞牛OS-(FnOS)-上使用-Docker-部署-Tailscale

Dify工作流详解

评论