릴리즈일: 2026-08-25 | GitHub 원본 릴리즈 노트 →
Dify 1.17.0이 2026년 8월 25일 출시되었습니다. 이번 릴리즈는 E2B 클라우드 Sandbox 지원, 워크스페이스 레벨 Skill 관리, Workflow LLM 환경변수 재사용, Cloudflare Turnstile CAPTCHA, Azure Key Vault 연동 등 대규모 신기능을 포함합니다. 또한 환경변수 명칭 변경(EDITION → DEPLOYMENT_EDITION)과 실행 시간 기본값 상향(1200s → 3600s) 등 운영에 영향을 주는 Breaking Changes가 포함되어 있어 업그레이드 전 반드시 확인이 필요합니다.
⚠️ Breaking Changes
• 환경변수 EDITION이 DEPLOYMENT_EDITION으로 이름 변경됨. 기존 설정 파일 반드시 업데이트 필요
• ENTERPRISE_ENABLED 환경변수 제거됨 (enterprise gating 통합)
• AGENT_BACKEND_RUN_TIMEOUT_SECONDS → DIFY_AGENT_RUN_TIMEOUT_SECONDS로 대체
• DIFY_AGENT_SHELLCTL_AUTH_TOKEN, DIFY_AGENT_SHELLCTL_ENTRYPOINT 제거됨 (agent runtime 재설계)
• APP_MAX_EXECUTION_TIME, WORKFLOW_MAX_EXECUTION_TIME 기본값 1200s → 3600s로 상향
• docker-compose.yaml 구성 변경 및 docker-compose.e2b.yaml 신규 추가
• 신규 DB 마이그레이션 다수 포함: flask db upgrade 실행 필수
• conversations 테이블 규모에 따라 add_conversation_cleanup_index 마이그레이션 소요 시간이 길어질 수 있음
✨ 주요 신기능
• E2B Sandbox 백엔드 지원: agent shell/코드 실행을 E2B 클라우드 sandbox에서 실행 가능. DIFY_AGENT_RUNTIME_BACKEND 환경변수로 선택, docker-compose.e2b.yaml 신규 제공
• Build-time Home Snapshot: agent 빌드(publish) 시점의 sandbox 홈 디렉토리(설치 패키지, 파일, 상태)를 스냅샷으로 저장하여 이후 실행 시 동일한 파일시스템 상태에서 시작
• 워크스페이스 레벨 Skill 관리: 재사용 가능한 버전 관리 Skill(코드+툴 정의) 패키지를 draft → publish → version 라이프사이클로 관리. 웹 UI(목록, 빌더 패널, 파일 에디터) 포함
• Context-aware history compaction: 긴 agent 대화에서 모델 컨텍스트 창 초과 방지. 오래된 tool 결과 제거 → 오래된 히스토리 요약 순으로 단계적 압축
• Workflow LLM 환경변수 재사용: 공유 provider/model/mode/파라미터 설정을 한 번 정의하고 여러 LLM 노드에서 참조 가능. DSL import/export, snippet, RAG pipeline, 협업 편집 지원
• Loop/Iteration 내 Human Input 지원: Loop 및 Iteration 노드 내에서 human-in-the-loop 폼 동작. 페이지 새로고침 후에도 pause/resume 정상 동작
• Provider-Neutral 통합 트레이싱: OPS_TRACE_UNIFIED_ENABLED 옵션으로 전체 parent-child span 트리 조립. Phoenix, LangSmith 어댑터 우선 제공. 기본 비활성화, 하위 호환
• GenAI span 추가: LLM TTFT, agent ReAct 단계, tool 호출, 실패한 LLM 노드 등 심층 observability 제공
• Cloudflare Turnstile CAPTCHA 지원: 로그인 및 이메일 코드 로그인에 Turnstile 챌린지 추가 가능. TURNSTILE_SITE_KEY, TURNSTILE_SECRET_KEY 등으로 설정
• Azure Key Vault / Pluggable KMS: KMS 프로바이더 추상화 도입, Azure Key Vault로 키 프로비저닝/암호화/복호화 및 키 로테이션 설정 지원
• TiDB Vector 전문 검색 및 하이브리드 검색: TIDB_VECTOR_ENABLE_FULLTEXT_SEARCH 옵션으로 다국어 전문 인덱스와 벡터 검색 병행 사용 가능 (기본 비활성화)
• 멀티모달 파일 처리 개선: LLM 노드 및 agent에서 이미지 파일을 멀티모달 모델에 직접 전달 가능. agent 채팅에서 비전 외 첨부파일 누락 버그 수정
• Go to Anything (⌘K / Ctrl+K): 콘솔 어디서든 커맨드 팔레트 호출. agent, skill 검색 추가 및 아이콘 커맨드 시스템 전면 리팩토링
• ODT(OpenDocument Text) 문서 추출 지원
• tool plugin에 date/date-picker 파라미터 타입 추가
• 라오어(lo-LA) 언어 지원 추가
• 오래된 대화 자동 정리 태스크: ENABLE_CONVERSATION_CLEANUP_TASK 환경변수로 활성화
• Marketplace가 통합 카테고리에 직접 임베드되어 tool/plugin 탐색 편의성 향상
🐛 버그픽스 및 개선
• Redis Streams에서 workflow_started 이벤트 누락 및 중복 실행 방지
• workflow 타임스탬프를 naive UTC로 정규화, 실패/취소/중단된 실행의 run 스냅샷/히스토리 보존
• 크로스탭 채팅 대화 전환 방지 및 agent 채팅에서 비전 외 첨부파일 누락 수정
• Qwen/VL 시스템 메시지 순서 수정: 시스템 메시지를 먼저 병합하여 올바른 순서 보장
• Elasticsearch-JA 어댑터 document_id 매핑 및 VectorType 수정
• Bedrock schema 빈 필드 방지
• nginx upstream에 동적 DNS 해석 적용
• 텍스트 업로드 시 UTF-8 바이트 크기 보존
• 워크플로우 캔버스 상태가 히스토리 업데이트 후 유지되도록 수정
• SSE 스트림이 터미널 이벤트에서 정상 종료되도록 수정
• stop 신호가 non-streaming 노드 사이에서도 동작하도록 수정
• 일시 중지된 workflow의 stale 취소 신호 정상 처리
• 대규모 접근성(a11y) 개선: 실제 button 시맨틱, 아이콘 전용 액션 접근 가능한 이름 부여, 키보드 접근성 향상
• workflow 생성기가 이미 설치/설정된 tool을 우선 추천
• 인증 보안 강화: 이메일 코드 검증 시도 횟수 제한(EMAIL_CODE_LOGIN_MAX_ATTEMPTS), 토큰 만료 시간 설정(EMAIL_CODE_LOGIN_TOKEN_EXPIRY_MINUTES), 일시 정지 이메일 도메인 처리
• 접근 제어 강화: dataset, document, RAG, conversation, workspace credential, OAuth client 리소스의 소유자 및 앱 범위 바인딩
• SSRF 및 아웃바운드 요청 강화: 아웃바운드 HTTP connect 단계 5초 제한, agent/binding 다운로드 및 실행 타임아웃 설정 가능
• audio/x-m4a ASR 지원 추가 및 오디오 MIME 타입 검증 정확도 향상
• webapp 이메일 코드 및 비밀번호 폼 제출 복원, 모바일 로그인 오버플로우 수정, toast 스택 안정화
💡 운영 시 참고사항
• 업그레이드 전 반드시 EDITION 환경변수를 DEPLOYMENT_EDITION으로 변경할 것
• flask db upgrade 실행 필수. conversations 테이블이 클 경우 add_conversation_cleanup_index 마이그레이션 시간이 길어질 수 있으므로 유지보수 창 확보 권장
• docker-compose.yaml이 변경되었으므로 커스텀 compose 파일을 사용 중이라면 변경사항을 신중히 병합할 것
• E2B sandbox 사용 시 docker-compose.e2b.yaml과 관련 환경변수(DIFY_AGENT_E2B_API_KEY 등) 별도 설정 필요
• APP_MAX_EXECUTION_TIME, WORKFLOW_MAX_EXECUTION_TIME 기본값이 3600s로 상향되었으므로 리소스 계획 재검토 권장
• 통합 트레이싱(OPS_TRACE_UNIFIED_ENABLED)은 기본 비활성화 상태이며 opt-in 방식
• Azure Key Vault KMS 도입 시 KEY_PROVIDER_TYPE, AZURE_KEYVAULT_VAULT_URL 등 관련 환경변수 설정 필요
• ENABLE_CONVERSATION_CLEANUP_TASK 활성화 시 CONVERSATION_CLEANUP_TASK_INTERVAL, CONVERSATION_CLEANUP_BATCH_SIZE로 동작 조정 가능