본문으로 건너뛰기
PromptQuorum인간을 위해 설계. AI를 위해 구조화.
홈/고급 로컬 LLM
RAG & Document Chat

RAGFlow 리뷰: 복잡한 문서 이해와 인용 추적 RAG 엔진

·읽는 시간 12분Hans Kuepper 저 · PromptQuorum 창립자 · 오픈 웨이트·오픈소스 AI 디스커버리 엔진

RAGFlow는 깊이 있는 문서 이해를 중심으로 만들어진 무료 오픈소스(Apache 2.0) RAG 엔진입니다. 레이아웃 인식 파서가 복잡한 PDF와 스캔 파일에서 표, 그림, 구조를 추출하며, 생성되는 모든 답변은 그 출처가 된 정확한 청크로 연결됩니다.

핵심 요점

  • Apache 2.0 라이선스 — 무료로 셀프호스팅, 수정, 재배포 가능
  • 검색과 에이전트 기능을 결합한 오픈소스 RAG 엔진, InfiniFlow 개발
  • 깊이 있는 문서 이해: 레이아웃 인식 분석이 파일을 텍스트로 평탄화하는 대신 표·그림·구조를 추출
  • 근거 기반 인용: 모든 답변이 생성된 특정 청크로 연결되며 미리보기 제공
  • Docker로 셀프호스팅; 최소 사양은 CPU 4코어, RAM 16GB, 디스크 50GB
  • 문서 중심 워크플로(계약서, 재무제표, 스캔 보고서)에 최적; 단순 텍스트 질의응답에는 더 가벼운 도구로 충분
  • 셀프호스팅을 원하지 않는 팀을 위한 유료 관리형 클라우드(cloud.ragflow.io)도 존재 — 이 리뷰는 셀프호스팅 오픈소스 배포를 다룹니다

📍 한 문장으로

RAGFlow는 복잡한 PDF, 표, 스캔 파일에 대한 레이아웃 인식 분석을 통해 깊이 있는 문서 이해에 특화된 오픈소스(Apache 2.0) 셀프호스팅 RAG 엔진이며, 답변은 정확한 출처 청크까지 추적됩니다.

💬 쉽게 말하면

RAGFlow는 PDF를 하나의 긴 텍스트 문자열로 다루는 대신 레이아웃을 읽어냅니다. 표는 표로 유지되고 각주는 해당 페이지에 계속 연결되며, 질문에 답하기 위해 문서의 어느 부분을 사용했는지 정확히 보여줍니다.

대부분의 RAG 도구는 PDF를 분석하기도 전에 하나의 텍스트 덩어리로 평탄화해 표, 각주, 상호 참조를 모두 잃어버립니다. RAGFlow는 먼저 문서 레이아웃을 분석한 뒤, 정확한 출처 청크까지 추적 가능한 인용과 함께 질문에 답합니다.

RAGFlow 리뷰: 복잡한 문서 이해와 인용 추적 RAG 엔진

RAGFlow란?

RAGFlow(github.com/infiniflow/ragflow)는 InfiniFlow가 개발하고 Apache 2.0 라이선스로 공개한 오픈소스 RAG 엔진입니다. 공식 문서는 이를 검색 증강 생성과 에이전트 기능을 결합해 LLM을 위한 컨텍스트 레이어를 만드는 것으로 설명합니다 — 실제로는 문서 질의응답 시스템과 에이전트 워크플로를 구축할 수 있는 웹 인터페이스를 갖춘 셀프호스팅 애플리케이션입니다.

  • 깊이 있는 문서 이해: 레이아웃 인식 분석 파이프라인(DeepDoc)이 모든 파일을 단순 텍스트로 취급하는 대신 복잡한 파일 형식에서 텍스트, 표, 그림을 추출
  • RAGFlow 스스로 "설명 가능"하다고 표현하는 템플릿 기반 지능형 청킹 — 인덱싱 전에 문서가 어떻게 분할되었는지 확인하고 조정 가능
  • 출처 청크 미리보기가 포함된 근거 기반 인용으로, 답변을 정확한 원문 구절과 대조 확인 가능
  • 에이전트 기능: 검색·도구·다단계 추론을 연결하는 시각적 워크플로 빌더와 Model Context Protocol(MCP) 지원
  • Word, Slides, Excel, TXT, 이미지, 스캔본, 구조화된 데이터, 웹페이지 등을 소스 문서로 지원
  • Docker를 통해 셀프호스팅 배포 가능, 또는 직접 인프라를 운영하고 싶지 않다면 InfiniFlow의 유료 관리형 클라우드(cloud.ragflow.io) 이용 가능

깊이 있는 문서 이해와 인용 — RAGFlow의 핵심 차별점

문서가 깔끔한 텍스트 파일이라면 단순 RAG는 쉽습니다. 하지만 비즈니스 문서는 그런 경우가 드뭅니다 — 계약서에는 중첩된 표, 각주, 헤더, 스캔된 페이지, 상호 참조가 포함될 수 있으며, 단순한 PDF-텍스트 변환은 이 모든 것을 구조 없는 덩어리로 뭉개버립니다. RAGFlow는 이 구조를 버리지 않고 분석하도록 특별히 설계되었습니다.

문서 분석 작동 방식

RAGFlow의 분석 파이프라인은 레이아웃을 인식합니다. 파일 순서대로 원본 텍스트를 추출하는 대신, 청킹 전에 표·그림·헤더·읽기 순서를 먼저 식별합니다. 청킹은 템플릿 기반이며 프로젝트는 이를 "설명 가능"하다고 표현합니다 — 인덱싱 전에 특정 문서가 어떻게 청크로 분할되었는지 확인하고 조정할 수 있으며, 이는 표가 잘못 분할되어 엉뚱한 답변이 생성될 상황에서 중요합니다.

인용 추적성 작동 방식

RAGFlow가 질문에 답할 때, 답변에는 생성에 사용된 구체적인 청크에 대한 참조가 포함됩니다. 인터페이스에서 원본 문서 내 인용된 구절을 빠르게 미리볼 수 있어, 모델 요약을 맹목적으로 신뢰하는 대신 답변을 실제 출처와 대조 확인할 수 있습니다. 이는 검증 불가능한 답변이 단순한 불편함이 아니라 리스크가 되는 컴플라이언스 검토, 법률 조사, 재무 분석 등의 용도에서 평가해야 할 기능입니다.

📌참고: RAGFlow는 핵심 문서 파이프라인 외에도 GraphRAG 방식의 지식 그래프 구축과 조정 가능한 에이전트형 추론 깊이도 지원합니다 — 기본적인 문서 질의응답에 반드시 필요하다고 가정하기보다 자신의 사용 사례에 맞춰 평가하세요.

RAGFlow는 Quivr, Dify, LlamaIndex와 어떻게 다른가?

네 도구 모두 검색 증강 생성을 다루지만 해결하는 문제는 다릅니다. RAGFlow는 벡터 데이터베이스나 코드 프레임워크가 아니라 Quivr 같은 즉시 사용 가능한 문서 질의응답 애플리케이션과 비교 평가해야 합니다 — 이들은 "내 문서를 가리키고 질문하기"라는 동일한 구매 결정을 두고 경쟁합니다.

RAGFlow vs. Quivr

Quivr는 즉시 사용 가능한 셀프호스팅 RAG 애플리케이션으로, 설치가 더 단순하고 리소스 사용량도 가볍습니다. 강점은 단순한 텍스트 문서에서 첫 답변까지 빠른 속도입니다. RAGFlow는 이러한 단순함의 일부를 레이아웃 인식 파서와 인용 추적성과 맞바꿉니다 — 문서 복잡도(표, 스캔본, 다단 레이아웃)가 높아질수록 그 격차는 커지고, 순수 텍스트 파일에서는 추가적인 분석 정교함이 아무런 의미가 없어 격차가 사라집니다.

RAGFlow vs. Dify

Dify는 더 넓은 범위의 LLM 애플리케이션 플랫폼입니다. RAG는 에이전트 오케스트레이션, 워크플로 구축, 앱 배포와 함께 하나의 구성 요소일 뿐입니다. 검색 증강 문서 질의응답이 요구사항의 전부라면 Dify는 필요 이상의 플랫폼입니다. 문서 검색이 일부에 불과한 다단계 AI 애플리케이션을 구축한다면 RAGFlow의 문서 중심 초점보다 Dify의 범위가 더 적합할 수 있습니다.

RAGFlow vs. LlamaIndex

LlamaIndex는 애플리케이션이 아니라 코드 우선 Python/TypeScript 프레임워크로, 내장 웹 인터페이스가 없습니다. 코드를 작성하고 벡터 데이터베이스(Chroma, Qdrant, Weaviate 등)를 선택하며, 문서 분석을 포함한 모든 단계를 완전히 제어하며 자신만의 파이프라인을 구성합니다. RAGFlow는 범용 로더 대신 자체 문서 파서를 갖춘 동등한 파이프라인을 UI 뒤에 묶어 제공합니다. 어떤 애플리케이션도 제공하지 않는 맞춤형 파이프라인 로직이 필요하다면 LlamaIndex를, 강력한 문서 분석을 갖춘 즉시 사용 가능한 인터페이스가 이미 요구사항을 충족한다면 RAGFlow를 선택하세요.

RAGFlow를 어떻게 셀프호스팅하나요?

RAGFlow는 Docker를 통해 배포됩니다. 다음은 이 리뷰 작성 시점 기준 프로젝트 공식 퀵스타트 가이드에 문서화된 단계입니다 — 배포 전에는 항상 저장소 문서에서 최신 릴리스 태그를 확인하세요.

  1. 1
    최소 사양 충족 여부를 확인하세요: CPU 4코어 이상(x86), RAM 16GB 이상, 여유 디스크 50GB 이상, Docker 24.0.0 이상, Docker Compose v2.26.1 이상.
  2. 2
    Linux에서는 내장 검색 컴포넌트를 위해 커널 메모리 맵 한도를 높이세요: sudo sysctl -w vm.max_map_count=262144를 실행한 후, 재부팅 후에도 유지되도록 /etc/sysctl.conf에 vm.max_map_count=262144를 추가하세요.
  3. 3
    저장소를 클론하고 안정 릴리스 태그로 체크아웃하세요: git clone https://github.com/infiniflow/ragflow.git 실행 후 cd ragflow/docker && git checkout -f v0.27.1 (배포 시점에 최신인 태그를 사용).
  4. 4
    스택을 시작하세요: docker compose -f docker-compose.yml up -d. docker logs -f docker-ragflow-cpu-1로 로그를 확인하며 성공적인 시작 메시지를 기다린 후 다음 단계로 진행하세요.
  5. 5
    브라우저에서 http://<서버 IP>를 여세요(RAGFlow는 기본적으로 포트 80에서 대기), Model providers로 이동해 사용할 LLM과 임베딩 모델의 API 키 또는 엔드포인트를 추가하세요.
  6. 6
    데이터셋을 생성하고 임베딩 모델과 청킹 방식을 선택한 뒤 파일을 업로드하고 재생 버튼을 눌러 분석하세요 — 그런 다음 생성된 청크를 검토하고 해당 데이터셋에 연결된 채팅을 만들어 질문을 시작하세요.

RAGFlow는 인터넷 연결 없이 실행할 수 있나요?

RAGFlow 자체는 배포 후 완전히 오프라인으로 실행되지만, 답변을 생성하려면 LLM이 필요합니다. 전체 파이프라인을 오프라인으로 유지하려면 클라우드 API 대신 로컬 모델 서버(예: Ollama 호환 엔드포인트)를 지정하세요 — 지원되는 로컬 엔드포인트는 RAGFlow의 모델 제공자 설정에서 확인할 수 있습니다.

RAGFlow는 실제로 얼마나 많은 디스크 공간이 필요한가요?

문서화된 최소 요구사항은 여유 공간 50GB이며, 이는 인덱싱된 문서와 생성되는 청크/임베딩이 차지하는 공간과는 별도입니다. RAGFlow는 원본 파일 외에 분석된 청크와 임베딩도 저장하므로 대규모 문서 컬렉션에는 더 많은 여유 공간을 확보하세요.

RAGFlow는 누구에게 적합한가?

RAGFlow의 문서 분석 깊이는 복잡한 파일에는 실질적인 강점이지만, 그것이 필요 없는 팀에게는 설치 복잡성과 하드웨어 측면에서 실질적인 비용입니다.

RAGFlow를 사용해야 하는 경우

  • 소스 문서에 보존해야 할 실제 구조가 있는 경우 — 표, 각주, 스캔 페이지, 다단 레이아웃, 상호 참조
  • 답변을 정확한 출처 구절과 대조 확인해야 하는 경우 — 컴플라이언스 검토, 법률 조사, 재무 분석, 감사 추적
  • 필요한 하드웨어 여유가 있는 경우 — RAM 16GB 이상과 디스크 50GB 이상은 가벼운 RAG 앱보다 확실히 더 무거운 요구사항
  • 검색 위에 에이전트형 워크플로(다단계 추론, 도구 호출, MCP)를 원하는 경우, 단순한 파일 채팅 인터페이스로는 부족한 경우

RAGFlow를 피해야 하는 경우

  • 문서가 순수 텍스트, Markdown, 단순한 플랫 파일인 경우 — 더 가벼운 셀프호스팅 도구가 더 적은 설정으로 더 빠르게 질문에 답함
  • 제한적이거나 저사양인 하드웨어에서 가능한 한 작은 리소스 사용량을 원하는 경우
  • 어떤 패키지형 애플리케이션도 제공하지 않는 로직을 가진 완전히 맞춤화된 검색 파이프라인이 필요한 경우 — 대신 LlamaIndex 같은 코드 우선 프레임워크를 검토
  • 문서 분석 깊이와 인용 추적성이 사용 사례의 요구사항이 아닌 경우 — 이때는 추가된 복잡성이 아무런 이점을 주지 않음

RAGFlow vs. 대안

구매자가 실제로 비교하는 기준 — 인터페이스, 문서 처리, 라이선스 — 에 따른 나란히 비교.

도구
인터페이스
문서 분석
인용
라이선스
RAGFlow웹 앱 + 시각적 에이전트 빌더레이아웃 인식 / 표·스캔본 대응출처 청크까지 추적 가능Apache 2.0
Quivr웹 앱범용 텍스트 추출출처 참조오픈소스
Dify웹 앱 + 워크플로 빌더범용(RAG는 하나의 모듈)출처 참조오픈소스
LlamaIndex코드 프레임워크, UI 없음자체 로더로 구성 가능직접 구현MIT

디렉터리에서 비교

RAGFlow 평가 시 흔한 실수

이러한 실수는 RAGFlow를 더 단순한 도구의 완전한 대체품으로 취급하거나, 반대로 사양을 부족하게 구성한 뒤 소프트웨어 탓을 하는 데서 비롯됩니다.

실수 1: 순수 텍스트 질의응답에 RAGFlow를 배포

전체 문서 컬렉션이 깔끔한 Markdown 메모나 순수 텍스트라면 RAGFlow의 레이아웃 인식 분석은 분석할 대상이 없습니다 — 애초에 필요하지 않았던 문서를 위해 깊이 있는 문서 이해의 설치 및 하드웨어 비용을 지불하는 셈입니다. 더 가벼운 셀프호스팅 RAG 앱이 더 작은 리소스로 동일한 답변 품질을 제공합니다.

실수 2: 셀프호스팅 환경을 부족하게 구성

문서화된 최소 사양 — CPU 4코어, RAM 16GB, 디스크 50GB — 은 하한선이지, 실제 문서 컬렉션을 위한 편안한 목표치가 아닙니다. 이 최소 사양 이하에서 RAGFlow를 실행하거나 Linux에서 vm.max_map_count 커널 설정을 건너뛰는 것은 스택이 시작은 되지만 결코 사용 가능한 상태에 이르지 못하는 흔한 원인입니다.

실수 3: 인용을 확인하지 않고 답변을 신뢰

RAGFlow의 인용 기능은 실제로 사용할 때만 리스크를 줄여줍니다. 연결된 출처 청크를 열어보지 않고 생성된 답변을 최종적인 것으로 취급하는 것은 애초에 인용 중심 도구를 선택한 목적 자체를 무력화합니다 — 특히 검증되지 않은 답변이 바로 이 기능이 방지하려는 리스크인 컴플라이언스나 법률 관련 사용 사례에서 그렇습니다.

자주 묻는 질문

RAGFlow란 무엇인가요?

RAGFlow는 InfiniFlow가 개발한 오픈소스(Apache 2.0) RAG 엔진으로, 깊이 있는 문서 이해에 특화되어 있습니다. 레이아웃 인식 파서가 복잡한 문서에서 표, 그림, 구조를 추출하며, 생성되는 모든 답변은 그 출처가 된 정확한 청크로 연결됩니다.

RAGFlow는 무료인가요?

셀프호스팅 오픈소스 배포는 Apache 2.0 라이선스 하에 무료입니다. InfiniFlow는 자체 인프라를 운영하고 싶지 않은 팀을 위해 별도의 유료 관리형 클라우드(cloud.ragflow.io)도 제공합니다 — 이는 이 리뷰가 다루는 무료 셀프호스팅 소프트웨어와는 별개의 제품입니다.

RAGFlow는 어떤 라이선스로 공개되나요?

상업용 제품을 포함해 자유로운 사용, 수정, 재배포를 허용하는 Apache License 2.0입니다.

RAGFlow의 인용 기능은 어떻게 작동하나요?

RAGFlow가 생성하는 모든 답변에는 그 답변의 근거가 된 구체적인 청크에 대한 참조가 포함됩니다. 인터페이스에서는 원본 문서 내 인용된 구절을 미리볼 수 있어, 요약만 신뢰하는 대신 실제 출처와 대조해 답변을 검증할 수 있습니다.

RAGFlow는 일반적인 RAG 도구와 무엇이 다른가요?

대부분의 RAG 도구는 청킹 전에 문서를 순수 텍스트로 변환해 표 구조, 각주, 레이아웃을 잃습니다. RAGFlow는 먼저 레이아웃을 분석해 표는 표로 유지되며, 이는 스캔한 계약서나 재무제표 같은 복잡한 비즈니스 문서에서 특히 중요합니다.

RAGFlow는 어떤 문서 형식을 지원하나요?

프로젝트 공식 문서에 따르면 Word, Slides, Excel, TXT, 이미지, 스캔본, 구조화된 데이터, 웹페이지를 지원합니다. RAGFlow는 새로운 형식 지원을 자주 추가하므로 배포 전 현재 GitHub 저장소에서 완전하고 최신인 형식 목록을 확인하세요.

RAGFlow를 셀프호스팅할 수 있나요?

네. RAGFlow는 자체 인프라에서 Docker와 Docker Compose를 통해 배포됩니다. 문서화된 최소 하드웨어는 CPU 4코어, RAM 16GB, 여유 디스크 50GB입니다.

RAGFlow를 셀프호스팅하기 위한 하드웨어 요구사항은 무엇인가요?

RAGFlow 퀵스타트 문서에 따르면 CPU 4코어 이상(x86), RAM 16GB 이상, 여유 디스크 공간 50GB 이상, Docker 24.0.0 이상, Docker Compose v2.26.1 이상이 필요합니다.

RAGFlow vs. LlamaIndex — 어느 쪽을 사용해야 하나요?

코드로 구축하는 완전히 맞춤화된 검색 파이프라인이 필요하고, 벡터 데이터베이스를 직접 선택하며 패키지형 UI가 필요 없다면 LlamaIndex를 선택하세요. 강력한 문서 분석을 갖춘 즉시 사용 가능한 웹 애플리케이션이 이미 요구사항을 충족하고 직접 검색 파이프라인을 작성하고 싶지 않다면 RAGFlow를 선택하세요.

RAGFlow는 RAG뿐 아니라 AI 에이전트도 지원하나요?

네. 문서 검색을 넘어 RAGFlow는 검색 단계, 도구, 다단계 추론을 연결하는 시각적 워크플로 빌더와 외부 도구를 에이전트에 연결하기 위한 Model Context Protocol(MCP) 지원을 포함합니다.

출처

← 고급 로컬 LLM으로 돌아가기

MCP