Dify安装与启动指南

项目概览

Dify是一个开源的LLM应用开发平台，能够帮助开发者快速构建和部署大语言模型应用。

安装进度

✅ 项目下载完成: 已成功从GitHub下载Dify项目到 ~/dify-installation/dify/

✅ 环境配置完成: 已配置Docker Compose环境文件和参数

🔄 Docker镜像下载中: 正在下载Dify相关Docker镜像，这是一个较大的镜像集合，主要包括：

langgenius/dify-api:1.14.2
langgenius/dify-web:1.14.2
PostgreSQL数据库
Redis数据库
Weaviate向量数据库
Nginx服务
其他辅助服务

启动命令

1
2


cd ~/dify-installation/dify/docker
docker-compose up -d

服务架构

Dify部署包含以下主要服务：

api - Dify API服务 (端口: 5001)
web - Dify Web界面 (端口: 80)
db_postgres - PostgreSQL数据库
redis - Redis缓存服务
weaviate - Weaviate向量数据库
nginx - Nginx反向代理
worker - 后台任务处理
worker_beat - 定时任务调度
sandbox - 代码执行沙箱

访问地址

当所有服务启动完成后，可以通过以下地址访问：

Web界面

本地访问: http://localhost:8080
如果配置了外部访问: 请使用实际IP地址:8080

API服务

API地址: http://localhost:5001
健康检查: http://localhost:5001/health

访问提示

注意: 本机 macOS 上 Trae IDE 占用了 80 端口，因此 Dify Nginx 改为使用 8080 端口 提供服务。

默认凭据

根据官方默认配置：

数据库

类型: PostgreSQL
主机: db_postgres (容器内), localhost:5432 (外部)
数据库: dify
用户名: postgres
密码: difyai123456

Redis

主机: redis (容器内), localhost:6379 (外部)
密码: difyai123456

管理员账户

默认安装后首次访问需要设置管理员账户密码。

服务状态检查

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 查看所有容器状态
cd ~/dify-installation/dify/docker
docker-compose ps

# 查看服务日志
docker-compose logs -f

# 检查特定服务
docker-compose logs -f api
docker-compose logs -f web

启动时间预估

初次启动可能需要较长时间，特别是：

Docker镜像下载 (时间取决于网络速度) ✓ 进行中
服务初始化 (Postgres、Weaviate等数据库初始化)
数据迁移 (如有需要)

预计总时间: 10-30分钟

后续步骤

⏳ 等待Docker镜像下载完成
⏳ 等待所有服务成功启动
🔗 浏览器访问 http://localhost
🔐 设置管理员账户
🚀 开始使用Dify

故障排除

常见问题

端口冲突

1
2
3


# 检查本地端口占用
lsof -i :80
lsof -i :5001

权限问题

1
2


# 确保docker-compose.yml所在目录有正确权限
chmod -R 755 ~/dify-installation/dify/docker/volumes/

服务启动失败

1
2


# 查看具体服务日志
docker-compose logs [服务名]

内存不足 Dify服务需要约4GB以上内存，确保系统有足够资源。

Dify安装与启动指南

技术教程 — Dify安装与启动指南

Dify安装与启动指南

项目概览

安装进度

启动命令

服务架构

访问地址

Web界面

API服务

访问提示

默认凭据

数据库

Redis

管理员账户

服务状态检查

启动时间预估

后续步骤

故障排除

常见问题

相关文档