2026년 10월 23일 공개된 Dify 1.18.0 공식 릴리스 안내는 Agent Knowledge Base를 베타 기능으로 표시합니다. 기존 Classic Knowledge 흐름이 안정적이라면 지금 바로 옮기지 마세요. 이번 주에는 Community Edition의 공식 지원 범위, 활성화 조건, 이미지 출처부터 확인하고, 조건을 충족할 때만 분리된 시험 환경에서 검증하는 편이 안전합니다.
이 글은 Dify Community Edition을 운영하며 1.18.0 적용을 검토하는 개발자와, 기업 지식 베이스의 데이터 경계를 관리하는 담당자를 위한 안내입니다. 플랫폼·지식 서비스·모델 추론을 나눠 서버 자원을 계획하는 팀에도 적합합니다.
마지막 업데이트: 2026년 10월 26일. Dify 공식 릴리스 및 배포 안내와 관련 배포 설정을 기준으로 확인했습니다.
먼저 구분할 것은 기존 흐름과 새 지식 공간입니다
Classic Knowledge는 이미 검증한 지식 베이스와 검색 흐름을 계속 운영하려는 팀에 맞습니다. 1.18.0 공개만으로 기존 흐름을 바꿔야 하는 것은 아닙니다. 릴리스 안내는 Agent Knowledge Base를 베타로 소개하면서 Classic Knowledge도 계속 사용할 수 있다고 설명합니다.
Agent Knowledge Base는 에이전트가 활용하는 새 지식 공간을 위한 기능입니다. 따라서 판단의 출발점은 “새 기능이 나왔는가”가 아니라 “현재 업무에 필요한 기능이 무엇인가”입니다. 지식 공간을 별도로 관리하거나 검색 과정과 권한 경계를 검토해야 하는 요구가 있을 때만 시험할 이유가 생깁니다. 권한 분리나 추적 기능이 실제 배포에서 어떻게 동작하는지는 문서만으로 단정하지 말고 직접 확인해야 합니다.
배포 형태별 적합도 비교
아래 적합도는 공식 호환성 인증이 아니라, 공개된 베타 상태와 운영 목적을 바탕으로 한 편집 기준입니다. 지원 여부를 대신하지 않습니다.
| 운영 상황 | 권장 판단 | 적합도 | 다음 조치 |
|---|---|---|---|
| 기존 Classic Knowledge와 검색 흐름이 안정적임 | 당장은 유지 | 높음 | 현재 동작을 기록하고 새 기능은 보류합니다 |
| 에이전트용 별도 지식 공간이 꼭 필요함 | 분리 시험을 검토 | 조건부 | 공식 지원과 서비스 구성을 먼저 확인합니다 |
| Community Edition에서 바로 운영 반영하려 함 | 검증 전에는 보류 | 낮음 | 이미지와 활성화 조건, 복구 경로를 확인합니다 |
| Enterprise 또는 Cloud를 사용함 | 해당 배포 형태의 안내를 확인 | 조건부 | Community Edition 설정을 그대로 적용하지 않습니다 |
Dify 1.18.0의 공식 배포 안내와 저장소 설정은 실제 설치 형태에 맞춰 확인해야 합니다. Enterprise와 Cloud의 이용 가능 시점이나 배포 방식은 Community Edition의 로컬 구성과 같다고 가정하지 마세요. 공개된 최신 공식 안내에서 해당 형태의 기능 제공과 지원 조건을 별도로 확인해야 합니다.
Community Edition에서는 기본 설정과 지원 범위를 따로 확인합니다
공식 Docker Compose 설정에서 KnowledgeFS가 기본으로 켜져 있다고 가정하면 안 됩니다. 공식 업그레이드 안내는 로컬 Community Edition 배포에서 개발 옵션을 명시해야 한다고 설명합니다. 설정 한 줄을 추가하는 것과 운영 지원이 확인되는 것은 서로 다른 문제입니다.
또한 독립 서비스와 데이터베이스가 필요하므로 기존 Dify 컨테이너만 기준으로 서버 규모를 정하면 누락이 생길 수 있습니다. Dify 플랫폼, KnowledgeFS 관련 서비스, 데이터베이스, 모델 추론은 역할과 자원 소비가 다릅니다. 모델을 외부 API로 호출한다면 모델 추론 자원은 Dify 서버의 요구량과 분리해 계산합니다. 반대로 CPU에서 모델을 직접 실행하려면 모델 크기뿐 아니라 양자화 방식, 문맥 길이, 메모리 사용량을 따로 검증해야 합니다. 학습이나 고동시성 대형 모델 추론을 이 서버 구성의 전제로 삼지는 않습니다.
공식 KnowledgeFS 환경 설정 예시는 설정 항목을 검토할 근거입니다. 다만 예시 파일이 있다고 해서 모든 Community Edition 배포에서 안정적인 운영 지원이나 이미지 제공이 보장된다는 뜻은 아닙니다.
커뮤니티의 이미지 질문은 공식 지원 판정이 아닙니다
2026년 10월 24일 올라온 GitHub 커뮤니티 이슈는 Community Edition에서 KnowledgeFS 이미지와 지원 경로를 어떻게 확인해야 하는지 묻는 사용자 질문입니다. 이 글은 공식 지원 여부를 확정하는 답변이나 제품 약속이 아닙니다. 이미지가 보이지 않는다는 사용자 보고만으로 “지원하지 않는다”고 결론 내릴 수도 없습니다.
운영 적용 전에는 공식 릴리스의 이미지 공개 기록, 배포 문서의 지원 범위, 현재 사용하는 아키텍처와 이미지의 호환 여부를 각각 확인하세요. 확인 결과가 불명확하면 운영 지식 베이스와 분리된 시험 환경에 머물러야 합니다. 커뮤니티 1.18.0 릴리스 논의는 질문과 사용자 반응을 살피는 자료로 활용할 수 있지만, 공식 문서와 같은 근거로 취급하지 않습니다.
활성화 전에 실행할 점검 항목
다음 순서대로 확인하면 새 기능의 필요성과 운영 위험을 함께 판단할 수 있습니다.
- [ ] 현재 Classic Knowledge에서 해결하지 못하는 업무 요구를 구체적으로 적습니다. 새 지식 공간이 꼭 필요한지, 단순한 버전 업데이트인지 구분합니다.
- [ ] 사용 중인 Edition과 배포 형태를 확인합니다. Community Edition의 로컬 Compose 조건을 Enterprise나 Cloud에도 그대로 적용하지 않습니다.
- [ ] 공식 문서와 Compose 설정에서 활성화 조건, 독립 서비스, 데이터베이스 의존성을 대조합니다. 필요한 구성요소가 확인되지 않으면 운영 배포를 보류합니다.
- [ ] 사용할 컨테이너 이미지의 공식 출처와 공개 상태, 버전 대응, 서버 아키텍처 호환성을 확인합니다. 커뮤니티 질문만으로 가용 여부를 확정하지 않습니다.
- [ ] 데이터 저장 위치와 백업 대상을 확인하고, 별도 환경에서 복구 절차를 시험합니다. 백업 파일이 있다는 사실만으로 복구 가능하다고 판단하지 않습니다.
- [ ] 검색 결과, 권한 경계, 실패 시 기존 흐름으로 되돌리는 절차를 시험합니다. 검증에 실패하면 Classic Knowledge를 유지합니다.
- [ ] 시험 결과와 문서 버전을 기록한 뒤에만 운영 반영 여부를 결정합니다. 공식 지원 조건이나 이미지 상태가 바뀌면 다시 확인합니다.
복구 계획은 KnowledgeFS 데이터만이 아니라 관련 서비스 설정과 데이터베이스를 함께 다뤄야 합니다. Dify의 공식 저장소 빠른 시작 안내도 실제 운영에 적용하기 전 현재 배포 문서와 대조하세요. 문서의 최신 내용이 사용 중인 릴리스와 다르면 해당 릴리스에 맞는 설정과 복구 절차를 우선 확인해야 합니다.
자주 묻는 질문
Community Edition에서도 자체 호스팅할 수 있나요?
공식 안내상 Community Edition 로컬 배포에서는 별도 활성화 조건이 있습니다. 기본 Compose 설정이 자동으로 켜 주는 기능으로 여기지 마세요. 지원 범위와 이미지 출처, 버전 및 아키텍처 대응을 먼저 확인하고, 모호한 부분이 남으면 운영 환경이 아닌 격리된 시험 환경에서만 검증합니다. 커뮤니티 이슈는 사용자 질문이지 공식 지원 판정이 아닙니다.
Agent Knowledge Base는 Classic Knowledge를 대체하나요?
공식 발표는 Agent Knowledge Base를 베타 기능으로 설명하며 Classic Knowledge도 계속 사용할 수 있다고 안내합니다. 따라서 두 기능을 일괄 교체 관계로 보면 안 됩니다. 기존 검색 흐름이 요구사항을 충족하면 유지하고, 새 에이전트 지식 공간이 필요한 상황에서만 별도 검증을 시작하세요. 특정 권한이나 추적 동작은 실제 배포에서 확인해야 합니다.
KnowledgeFS에는 별도 서비스와 데이터베이스가 필요한가요?
필요합니다. KnowledgeFS는 선택형 독립 서비스와 데이터베이스로 설명되어 있으므로, 기존 플랫폼만으로 구성된 배포와 같은 자원 계획을 그대로 적용하지 마세요. 공식 환경 설정과 Compose 구성을 확인해 추가 서비스, 저장 데이터, 백업 및 복구 범위를 정리합니다. 서비스별 연결 설정이 확인되기 전에는 운영 지식 베이스를 연결하지 않는 편이 안전합니다.
기존 지식 베이스를 1.18.0에서 옮겨야 하나요?
기존 Classic Knowledge와 검색 과정이 안정적이면 업데이트만을 이유로 이전할 필요는 없습니다. 새 기능의 목적, 현재 Edition의 지원 조건, 이미지 공개 상태와 복구 방법이 확인된 뒤에 이전 여부를 판단하세요. 이전을 검토한다면 운영 데이터와 분리된 환경에서 검색 결과와 권한을 확인하고, 문제가 생겼을 때 기존 흐름으로 되돌아갈 수 있는 절차를 먼저 준비합니다.
기존 VPS나 클라우드 인스턴스는 시작 비용이 낮을 수 있지만, 공유 자원으로 인한 성능 변동, CPU 초과 할당 가능성, 트래픽 과금 조건, 디스크와 시스템 구성의 제약을 확인해야 합니다. KnowledgeFS처럼 서비스와 데이터베이스를 나눠 운영할 계획이라면 이런 조건이 자원 예측과 복구 설계를 어렵게 만들 수 있습니다. 반대로 시험 목적이 짧거나 부하가 가볍고 탄력 확장이 더 중요하다면 물리 서버 임대가 적합하지 않을 수 있습니다.
독립된 자원에서 장기간 운영할 계획이라면 NodeKVM의 AMD 물리 서버도 선택지로 비교할 수 있습니다. 다만 KnowledgeFS 호환이나 사전 설치를 전제로 하지 말고, 실제 배포 조건과 비용은 현재 서버 구성과 요금 안내에서 확인한 뒤 결정하세요. 기업 문서의 처리 경계가 중요한 팀은 배포 방식뿐 아니라 개인정보 처리 안내도 함께 검토하는 것이 좋습니다.
자주 묻는 질문
-
Q
Dify 1.18.0의 KnowledgeFS는 Community Edition에서 자체 호스팅할 수 있나요?
공식 안내에 따르면 Community Edition의 로컬 배포에서는 활성화 조건을 별도로 확인해야 합니다. 기본 Compose 설정은 KnowledgeFS를 켜지 않으며, 개발 옵션을 명시해야 하는 것으로 안내되어 있습니다. 따라서 배포 가능 여부만 보고 운영 환경에 바로 넣지 말고, 공식 지원 범위와 사용할 이미지의 출처, 해당 버전과 서버 아키텍처의 호환성을 먼저 확인해야 합니다.
-
Q
Dify Agent Knowledge Base는 기존 지식 베이스와 무엇이 다른가요?
기존 Classic Knowledge는 이미 운영 중인 지식 베이스와 검색 흐름을 이어가는 선택지입니다. Agent Knowledge Base는 에이전트가 사용하는 지식 공간을 위한 새 기능이며, 공식 발표에서 베타로 표시됐습니다. 새 기능의 목적이 현재 업무에 필요한지 먼저 따져야 합니다. 권한 분리나 검색 과정의 추적이 요구사항이라면 실제 배포에서 해당 동작을 검증한 뒤 판단합니다.
-
Q
KnowledgeFS를 켜려면 별도 서비스와 데이터베이스가 필요한가요?
필요합니다. 공식 발표는 KnowledgeFS를 선택형 독립 서비스와 데이터베이스로 설명합니다. 기존 Dify 플랫폼 컨테이너만 준비하면 자동으로 구성되는 방식으로 간주하지 마세요. 배포 문서와 환경 설정 예시를 확인하고, 각 서비스의 설정값, 데이터 저장 위치, 백업 대상과 복구 순서를 따로 정리해야 합니다. 실제 구성은 사용 중인 공식 문서와 배포 버전을 기준으로 확인합니다.
-
Q
기존 Dify 지식 베이스는 1.18.0으로 올린 뒤 KnowledgeFS로 옮겨야 하나요?
아닙니다. 기존 Classic Knowledge와 검색 흐름이 안정적으로 동작하고 새 Agent 지식 공간이 필요한 상황이 아니라면, 버전 업데이트만을 이유로 이전할 필요는 없습니다. 공식 발표는 Classic Knowledge를 계속 사용할 수 있다고 설명합니다. 이전을 검토할 때는 기능 필요성뿐 아니라 지원 상태, 데이터 이전 방법, 권한 검증, 장애 시 기존 흐름으로 되돌릴 수 있는지까지 확인한 뒤 격리 환경에서 시험합니다.