在 Ubuntu 22.04 上搭建 Dify 应用的完备指南

Dify 是一款开源的 AI 应用开发平台，支持快速构建基于大语言模型（如 GPT-3、ChatGLM 等）的应用。本教程将具体演示如何在 Ubuntu 22.04 体系上部署 Dify。

---

一、环境准备

1. 体系要求

• Ubuntu 22.04 LTS
  
• 最低配置：2核 CPU / 4GB 内存 / 20GB 硬盘
  
• 推荐配置：4核 CPU / 8GB 内存 / 40GB 硬盘
  

2. 更新体系

1. sudo apt update && sudo apt upgrade -y
2. sudo apt install -y curl git docker.io docker-compose

复制代码

3. 安装 Docker

1. # 启动 Docker 服务
2. sudo systemctl enable --now docker
4. # 验证安装
5. docker --version
6. docker-compose --version

复制代码

---

二、安装 Dify

1. 克隆仓库

1. git clone https://github.com/langgenius/dify.git
2. cd dify/docker

复制代码

2. 配置环境变量

创建 .env 文件：

1. cp .env.example .env
2. nano .env

复制代码

修改关键配置（示例）：
env

1. OPENAI_API_KEY=sk-your-api-key-here  # 必填
2. DB_PASSWORD=dify_db_password         # 自定义数据库密码

复制代码

3. 启动容器

1. sudo docker-compose up -d

复制代码

首次启动需要下载约 2GB 的依赖，请耐烦等待。

---

三、验证安装

1. 查抄服务状态

1. docker-compose ps

复制代码

正常应显示以下服务均为 running：

• api-server
  
• worker
  
• web-client
  
• postgres
  
• redis
  

2. 访问 Web 界面

打开浏览器访问：

1. http://your_server_ip:80

复制代码

首次访问需完成初始化设置：

• 创建管理员账号
  
• 选择语言模型供应商（如 OpenAI）
  
• 配置 API 密钥
  

---

四、基础配置

1. 邮件服务配置（可选）

在 .env 文件中添加：
env

1. MAIL_HOST=smtp.example.com
2. MAIL_PORT=587
3. MAIL_USERNAME=your@email.com
4. MAIL_PASSWORD=your-password

复制代码

2. HTTPS 配置

建议使用 Nginx 反向署理：
nginx

1. server {
2.     listen 443 ssl;
3.     server_name dify.example.com;
5.     ssl_certificate /path/to/fullchain.pem;
6.     ssl_certificate_key /path/to/privkey.pem;
8.     location / {
9.         proxy_pass http://localhost:80;
10.         proxy_set_header Host $host;
11.         proxy_set_header X-Real-IP $remote_addr;
12.     }
13. }

复制代码

---

五、维护与管理

1. 更新版本

1. cd dify/docker
2. git pull origin main
3. docker-compose down && docker-compose up -d --build

复制代码

2. 数据备份

备份 PostgreSQL 数据：
bash
复制

1. docker exec -t dify-postgres pg_dumpall -U dify > dify_backup.sql

复制代码

3. 常见题目处置惩罚

Q1: 端口辩论
修改 docker-compose.yml 中的端口映射：
yaml

1. web-client:
2.   ports:
3.     - "8080:80"  # 改为其他端口

复制代码

Q2: 内存不足
增加 SWAP 空间：

1. sudo fallocate -l 4G /swapfile
2. sudo chmod 600 /swapfile
3. sudo mkswap /swapfile
4. sudo swapon /swapfile

复制代码

---

六、开始使用

• 创建新应用：通过 Web 界面选择对话型或文本生成型应用
  
• 接入模型：支持 OpenAI、Azure、Hugging Face 等主流模型
  
• 构建工作流：使用可视化工具编排 AI 处置惩罚流程
  
• 部署 API：生成可直接调用的 API 端点
  

---

七、总结

通过本教程，您已完成：
✅ Dify 核心服务的容器化部署
✅ 基础环境配置与安全加固
✅ 体系维护方案的制定
建议后续使用：

• 定期查抄容器日志：docker-compose logs -f
  
• 配置监控诉警（推荐 Prometheus + Grafana）
  
• 参考官方文档探索高级功能：Welcome to Dify | Dify
  

---

   提示：部署过程中如遇题目，可通过 docker-compose logs [service_name] 查看具体错误日志。对于生产环境部署，建议使用云数据库替代默认的 PostgreSQL 容器以获得更好性能。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。