Dify 완전 정복 가이드 3편: 고급 하이브리드 RAG 튜닝 및 프로덕션 운영 (3/3)

# 1. .dockerignore에 volumes 제외 추가 (최우선)
echo "docker/volumes" >> .dockerignore

# 2. Dify 소스 클론 및 버전 체크아웃
git clone https://github.com/langgenius/dify.git /tmp/dify-patch
cd /tmp/dify-patch
git checkout 1.14.1

# 3. result-item.tsx 패치 (33번 라인)
vi web/app/components/datasets/hit-testing/components/result-item.tsx
# :33 → 해당 라인 확인 후 수정

- const extension = document.name.split('.').slice(-1)[0] as FileAppearanceTypeEnum
+ const extension = (document?.name?.split('.').slice(-1)[0] ?? '') as FileAppearanceTypeEnum

- const extension = document.name.split('.').slice(-1)[0] as FileAppearanceTypeEnum
+ const extension = (document?.name?.split('.').slice(-1)[0] ?? '') as FileAppearanceTypeEnum

# 패치 이미지 빌드 (10~20분 소요)
docker build -t langgenius/dify-web:1.14.1-patched -f web/Dockerfile .

# docker-compose.yaml 이미지명 변경
sed -i 's|langgenius/dify-web:1.14.1|langgenius/dify-web:1.14.1-patched|g' \
  docker/docker-compose.yaml

# 재시작
cd docker && docker compose down && docker compose up -d

# 적용 확인 — 1.14.1-patched 가 표시되면 성공
docker ps | grep dify-web

# 현재 URL 설정 확인
grep "CONSOLE_WEB_URL\|CONSOLE_API_URL" /opt/dify/docker/.env

# 설정된 URL과 동일하게만 접속할 것
# 예: CONSOLE_WEB_URL=http://192.168.1.100 이면
#     반드시 http://192.168.1.100 으로만 접속
#     https://dify.example.com 으로도 접속하면 안 됨

# Redis 연결 확인
docker exec dify-redis redis-cli ping
# PONG 이 나와야 정상

# Redis 메모리 사용량 확인
docker exec dify-redis redis-cli info memory | grep used_memory_human

# Redis 재시작
docker compose restart dify-redis

# SECRET_KEY 확인 (기본값 'sk-9f73s3ljTXVcMT3Blb3ljTqtsKiGHXVcMT3BlbkFJLK7U'면 반드시 변경)
grep "SECRET_KEY" /opt/dify/docker/.env

# 새 키 생성
openssl rand -base64 42

# .env 수정 후 재시작 (기존 세션 무효화됨 — 재로그인 필요)
docker compose down && docker compose up -d

# 1. sandbox 설정 폴더 생성
mkdir -p /opt/dify/docker/volumes/sandbox/conf

# 2. 기본 설정 파일 생성
cat > /opt/dify/docker/volumes/sandbox/conf/config.yaml << 'EOF'
app:
  port: 8194
  debug: false
  key: "dify-sandbox"
max_workers: 4
max_requests: 100
worker_timeout: 15
python_path: /usr/local/bin/python3
enable_network: true
allowed_syscalls: []
EOF

# 3. 권한 설정
chmod 644 /opt/dify/docker/volumes/sandbox/conf/config.yaml

# 4. 재시작 및 확인
docker compose restart dify-sandbox
docker logs dify-sandbox --tail=30

# 1. 현재 마이그레이션 상태 확인
docker exec dify-api flask db current

# 2. 최신 마이그레이션 실행
docker exec dify-api flask db upgrade

# 3. 마이그레이션 히스토리 확인
docker exec dify-api flask db history

# 4. DB 직접 접속하여 테이블 확인
docker exec -it dify-db psql -U postgres -d dify
# \dt — 전체 테이블 목록
# \q  — 종료

# 5. API 서비스 재시작
docker compose restart dify-api dify-worker

#!/bin/bash
set -euo pipefail

BACKUP_DIR="/backup/dify"
DATE=$(date +%Y%m%d_%H%M)
RETENTION_DAYS=30

mkdir -p $BACKUP_DIR

echo "[$DATE] Dify 백업 시작"

# 1. PostgreSQL 덤프 (가장 중요)
docker exec dify-db pg_dump -U postgres dify | \
  gzip > $BACKUP_DIR/db_$DATE.sql.gz
echo "  ✓ PostgreSQL 백업 완료"

# 2. Qdrant 벡터 데이터
tar -czf $BACKUP_DIR/qdrant_$DATE.tar.gz \
  -C /opt/dify/docker/volumes qdrant/
echo "  ✓ Qdrant 벡터 DB 백업 완료"

# 3. 업로드 파일
tar -czf $BACKUP_DIR/storage_$DATE.tar.gz \
  -C /opt/dify/docker/volumes app/storage/
echo "  ✓ 업로드 파일 백업 완료"

# 4. 환경 설정 파일
cp /opt/dify/docker/.env $BACKUP_DIR/env_$DATE.bak
echo "  ✓ .env 백업 완료"

# 5. 오래된 백업 삭제
find $BACKUP_DIR -mtime +$RETENTION_DAYS -delete
echo "  ✓ ${RETENTION_DAYS}일 이상 백업 삭제"

echo "[$DATE] 백업 완료 — 총 크기: $(du -sh $BACKUP_DIR | cut -f1)"

chmod +x /opt/dify/backup.sh
(crontab -l 2>/dev/null; echo "0 2 * * * /opt/dify/backup.sh >> /var/log/dify-backup.log 2>&1") | crontab -

# 1. Dify 중지
docker compose down

# 2. DB 데이터 초기화
rm -rf /opt/dify/docker/volumes/db/data/*

# 3. DB만 시작 (초기화)
docker compose up -d dify-db
sleep 15

# 4. 백업 복원
gunzip -c /backup/dify/db_20260521_0200.sql.gz | \
  docker exec -i dify-db psql -U postgres dify

# 5. Qdrant 벡터 복원
tar -xzf /backup/dify/qdrant_20260521_0200.tar.gz \
  -C /opt/dify/docker/volumes/

# 6. 전체 서비스 시작
docker compose up -d

# 전체 컨테이너 상태 (1초 단위 갱신)
docker stats --no-stream

# 디스크 사용량 확인
df -h /opt/dify/docker/volumes/
du -sh /opt/dify/docker/volumes/*

# 최근 오류 로그 확인
docker compose logs --since 1h dify-api | grep -i "error\|exception\|critical"
docker compose logs --since 1h dify-worker | grep -i "error\|failed"

# Redis 큐 적체 확인 (워크플로우 멈춤 시)
docker exec dify-redis redis-cli llen celery

# PostgreSQL 연결 수 확인
docker exec dify-db psql -U postgres -c "SELECT count(*) FROM pg_stat_activity;"