Dify Docker Compose 安装指南

1. 环境准备和依赖检查

# 检查 Docker 是否已安装
docker --version# 检查 Docker Compose 是否可用
docker compose version# 如果未安装 Docker，请先安装（以 Ubuntu 为例）
# 更新包索引
sudo apt update# 安装 Docker 依赖
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common# 添加 Docker 官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -# 添加 Docker 仓库
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"# 安装 Docker
sudo apt update
sudo apt install -y docker-ce# 启动 Docker 服务
sudo systemctl start docker
sudo systemctl enable docker# 将当前用户添加到 docker 组（避免每次使用 sudo）
sudo usermod -aG docker $USER# 重新登录或执行以下命令使组更改生效
newgrp docker

2. 获取 Dify 代码

# 克隆 Dify 仓库
git clone https://github.com/langgenius/dify.git# 进入 docker 目录
cd dify/docker# 如果需要安装特定版本（例如 v0.6.0），可以使用：
# git clone --branch v0.6.0 https://github.com/langgenius/dify.git# 如果速度太慢，使用镜像地址克隆
# git clone https://bgithub.xyz/langgenius/dify.git 	

3. 配置和启动 Dify

# 复制环境配置文件
cp .env.example .env# 可选：编辑配置文件（如果需要修改端口等设置）
# nano .env 或 vim .env# 启动所有服务
docker compose up -d# 查看服务状态
docker compose ps# 查看日志（可选）
docker compose logs -f

4. 完整的 docker-compose.yml 文件内容

version: '3.8'services:web:image: langgenius/dify-web:latestcontainer_name: dify-webports:- "${NGINX_HTTP_PORT}:80"- "${NGINX_HTTPS_PORT}:443"depends_on:- appvolumes:- ./nginx/conf.d:/etc/nginx/conf.d- ./nginx/logs:/var/log/nginx- upload_data:/app/api/storageenv_file:- .envnetworks:- difyapp:image: langgenius/dify-api:latestcontainer_name: dify-appdepends_on:- db- redisvolumes:- upload_data:/app/api/storageenv_file:- .envenvironment:- DB_HOST=db- REDIS_HOST=redis- CONSOLE_API_URL=http://web:80- CONSOLE_WEB_URL=http://web:80networks:- difydb:image: postgres:16-alpinecontainer_name: dify-dbenvironment:- POSTGRES_DB=${DB_NAME}- POSTGRES_USER=${DB_USERNAME}- POSTGRES_PASSWORD=${DB_PASSWORD}volumes:- db_data:/var/lib/postgresql/datanetworks:- difyredis:image: redis:6-alpinecontainer_name: dify-redisvolumes:- redis_data:/datanetworks:- difyvolumes:db_data:redis_data:upload_data:networks:dify:driver: bridge

5. 环境配置文件 (.env) 示例

# 数据库配置
DB_NAME=dify
DB_USERNAME=postgres
DB_PASSWORD=your_secure_password_here
DB_HOST=db
DB_PORT=5432# Redis 配置
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=# 应用配置
SECRET_KEY=your_secret_key_here
API_COMPRESSION_ENABLED=false
DEBUG=false
DEPLOY_ENV=PRODUCTION
SERVER_URL=http://localhost:80
CONSOLE_API_URL=http://web:80
CONSOLE_WEB_URL=http://web:80# 文件上传限制
UPLOAD_FILE_SIZE_LIMIT=50
UPLOAD_FILE_BATCH_LIMIT=5
UPLOAD_IMAGE_FILE_SIZE_LIMIT=10# Nginx 配置
NGINX_HTTP_PORT=80
NGINX_HTTPS_PORT=443
NGINX_CLIENT_MAX_BODY_SIZE=50m# 功能开关
CONSOLE_WEB_ENABLED=true
CONSOLE_API_ENABLED=true
EDITOR_WS_ENABLED=true

6. 安装后操作

# 检查所有容器是否正常运行
docker compose ps# 查看应用日志
docker compose logs app# 查看 Web 日志
docker compose logs web# 停止服务
docker compose down# 停止并删除所有数据（重置安装）
docker compose down -v# 更新 Dify
cd dify/docker
git pull origin main
docker compose down
docker compose pull
docker compose up -d

7. 访问和初始化

安装完成后，在浏览器中访问：

http://你的服务器IP地址

8. 故障排查

# 检查容器状态
docker ps -a# 检查特定容器日志
docker logs dify-app# 进入容器内部检查
docker exec -it dify-app bash# 检查网络
docker network ls# 检查卷
docker volume ls