릴리즈일: 2026-03-27 | GitHub 원본 릴리즈 노트 →
Dify v1.13.3은 workflow 실행 안정성, streaming 신뢰성, knowledge retrieval 정확성에 집중한 패치 릴리즈입니다. LLM·Question Classifier·Variable Extractor 노드에서 모델 파라미터의 변수 참조 기능이 새롭게 추가되었으며, StreamsBroadcastChannel 동시성 버그 및 Knowledge Retrieval 노드의 다수 크래시 이슈가 수정되었습니다. v1.13.2에서 업그레이드하는 팀에게 즉시 적용을 권장합니다.
⚠️ Breaking Changes
없음
✨ 주요 신기능
**Workflow 모델 파라미터 변수 참조 지원**: LLM, Question Classifier, Variable Extractor 노드에서 모델 파라미터에 변수 참조(variable reference)를 사용할 수 있게 되었습니다. (#33082)
**Firecrawl 페이지네이션 지원**: crawl 상태가 completed일 때 페이지네이션을 자동으로 follow하도록 개선되었습니다. (#33864)
**inner API DSL import/export 엔드포인트 추가**: 관리자용 DSL import/export를 위한 inner API 엔드포인트가 추가되었습니다. (#34059)
**Squid IPv4 강제 설정 지원**: Sandbox 환경에서 IPv4 강제 사용 옵션이 추가되었습니다. (#33556)
🐛 버그픽스 및 개선
**Streaming 안정성**: `StreamsBroadcastChannel`의 replay 및 동시성(concurrency) 이슈를 수정하여 프론트엔드/백엔드 이벤트 전달의 안정성을 확보했습니다. (#34030, #34061)
**Workflow 편집기**: 노드 붙여넣기 시 Loop/Iteration 메타데이터가 유지되는 문제를 수정하고, `HumanInput` 노드가 유효하지 않은 컨테이너에 붙여넣기되는 것을 방지했습니다. (#29983, #34077)
**런타임 실행**: prompt 메시지 변환 로직을 복원하고, HTTP Request 실행 시 `max_retries=0` 처리 오류를 수정했습니다. (#33666, #33619, #33688)
**Knowledge Retrieval**: 웹 응답에서 citation 메타데이터가 유실되는 문제, dataset icon 메타데이터 누락 시 크래시, hit-count 쿼리 필터링 오류, 인덱싱된 문서 청크 미리보기가 표시되지 않는 문제를 모두 수정했습니다. (#33778, #33907, #33757, #33942)
**rate_limit**: `max_active_requests` 변경 시 Redis 캐시가 플러시되지 않는 문제를 수정했습니다. (#33830)
**앱 아이콘**: `icon_type` 업데이트가 누락되는 문제를 수정했습니다. (#33988)
**병렬 iteration**: 타이밍 메트릭이 보존되지 않는 문제를 수정했습니다. (#33216)
**채팅**: opener 리마운트로 인한 이미지 재렌더링 문제를 수정했습니다. (#33816)
💡 운영 시 참고사항
**Sandbox Python/Node.js 경로 변경 (이전 릴리즈 공지 재확인)**: 이전 릴리즈에서 Sandbox의 기본 Python 및 Node.js 경로가 변경되었습니다. 기존 Sandbox 설정 파일을 사용 중인 경우 자동으로 업데이트되지 않으므로, 설정 파일 내 Python 경로와 Node.js 경로를 새 기본값으로 **수동 업데이트**해야 합니다.
**Docker Compose 업그레이드 시**: `docker compose down` 후 볼륨 백업(`tar -cvf volumes-$(date +%s).tgz volumes`)을 반드시 수행한 뒤 `docker compose up -d`로 재기동하세요.
**Source Code 업그레이드 시**: `git checkout 1.13.3` 후 `uv sync` 및 `uv run flask db upgrade`를 실행하세요.
이번 릴리즈는 v1.13.2에서 업그레이드하는 팀을 위한 안정성 패치에 집중되어 있으며, 즉시 적용을 권장합니다.