Dify — 설치·사용 가이드 (공식 문서 한글 정리)

11. 한눈에 보기

▸ 무엇인가요
Dify(디파이)는 LLM(대규모 언어 모델, 챗GPT 같은 AI의 바탕 기술) 앱을 만드는 오픈소스 개발 플랫폼입니다.
README 소개: AI 워크플로(작업 순서도), RAG(내 문서를 찾아 AI 답변에 붙이는 기술) 파이프라인, 에이전트(스스로 작업하는 AI), 모델 관리, 관측(로그·성능 확인) 기능을 한 화면에 모아 시제품에서 실제 서비스까지 빠르게 가게 해 준다고 합니다.
이름은 'Do It For You'에서 왔다고 공식 문서에 적혀 있습니다.
▸ 만든 곳
GitHub 저장소 langgenius/dify. LICENSE 저작권 표기는 © 2025 LangGenius, Inc. 입니다.
▸ 라이선스
Dify Open Source License(Apache 2.0 기반 + 추가 조건). 8단계에서 자세히 봅니다.
▸ 비용(원문 표기 그대로)
· 셀프호스트 Community: Free(무료).
· Dify Cloud: Sandbox는 Free(무료), 그 밖에 유료 플랜(Professional, Team)이 있습니다.
· Enterprise: Custom(별도 협의).
▸ 어디서 돌아가나요
· Dify Cloud(cloud.dify.ai): 공식 측이 운영합니다. 서버 관리 없이 써 볼 수 있습니다.
· 셀프호스트: 내 컴퓨터·서버에서 Docker Compose(여러 컨테이너를 한 번에 띄우는 도구)로 실행합니다. 컨테이너는 프로그램을 담아 돌리는 상자입니다.

22. 이런 분께 맞아요 / 이럴 땐 맞지 않아요

▸ 이런 분께 맞아요(원문 근거)
· 셀프호스트 Community 대상(가격 페이지): 오픈소스를 좋아하는 분, 개인 개발자, 비상업 프로젝트.
· Cloud Sandbox 대상: Dify 핵심 기능을 먼저 써 보려는 분.
· 내 서비스에 AI를 붙이려는 개발자: 모든 기능에 대응하는 API가 있다고 README에 적혀 있습니다.
· 셀프호스트와 SSO(통합 로그인)·RBAC(역할별 권한)·기업 지원 SLA가 필요한 조직: README는 Dify Enterprise 문의를 안내합니다.
▸ 이럴 땐 맞지 않아요(원문 근거)
· 여러 고객에게 작업 공간을 나눠 주는 멀티테넌트 서비스 운영: 서면 허락(상업 라이선스) 없이는 불가합니다.
· 프런트엔드를 쓰면서 Dify 로고·저작권 표시를 지우거나 바꾸려는 경우: 허용되지 않습니다.
· CPU 2코어, 메모리 4GiB에 못 미치는 컴퓨터: 셀프호스트 최소 사양 미달입니다. 이때 원문상 대안은 서버가 필요 없는 Dify Cloud입니다.

33. 시작 전에 준비할 것

▸ 최소 사양(README·공식 문서 공통)
· CPU >= 2 Core
· RAM >= 4 GiB
▸ 운영체제별 필요 소프트웨어(공식 설치 문서)
1) macOS 10.14 이상: Docker Desktop + Docker Compose 2.24.0 이상. Docker 가상 머신에 가상 CPU 2개, 메모리 8GiB 이상을 배정하라고 합니다.
2) 리눅스: Docker 19.03 이상 + Docker Compose 2.24.0 이상.
3) WSL 2(윈도우 안의 리눅스)를 켠 Windows: Docker Desktop + Docker Compose 2.24.0 이상. 소스 코드와 데이터는 윈도우가 아닌 리눅스 파일 시스템에 두라고 합니다.
▸ 필요한 도구
내려받기 명령에 git, curl, jq 가 필요합니다. 'command not found' 오류가 나면 빠진 도구를 설치하고 다시 실행합니다. Compose 버전 확인:
docker compose version
▸ 계정
· 셀프호스트: 첫 접속 때 관리자 계정을 직접 만듭니다.
· Cloud: cloud.dify.ai 에서 무료 가입, Sandbox 플랜으로 시작합니다.
▸ API 키(AI 모델 사용 열쇠)
· Cloud는 AI 크레딧(이용권)이 있어 처음엔 내 키 없이 시작할 수 있습니다. Sandbox 크레딧은 200개, 한 번만 주고 매달 채워지지 않습니다. 다 쓰면 내 API 키로 바꿔 쓸 수 있습니다.
· 내 키를 넣으면 비용은 그 모델 회사의 내 계정으로 청구됩니다.
· 셀프호스트에서 AI 크레딧 제공 여부: 원문에서 확인되지 않았습니다.

44. 설치 방법 (셀프호스트, Docker Compose)

공식 설치 문서(Deploy Dify with Docker Compose) 순서 그대로입니다.
▸ 1단계: 소스 코드 내려받기(최신 릴리스)
git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git
버전을 직접 지정할 때(<version> 자리에 releases 페이지의 버전 번호):
git clone --branch <version> https://github.com/langgenius/dify.git
▸ 2단계: docker 폴더로 이동
cd dify/docker
README 빠른 시작은 같은 동작을 두 줄로 적습니다.
cd dify
cd docker
▸ 3단계: 기본 환경 설정 파일 복사
cp .env.example .env
▸ 4단계: 컨테이너 시작(Docker Compose 2.24.0 이상 필요)
docker compose up -d
공식 문서 기준으로 핵심 서비스 7개(api, web, worker 등), 의존 구성 요소 8개(db_postgres, redis, nginx, weaviate 등), 한 번만 도는 작업 init_permissions 가 시작됩니다.
▸ 5단계: 상태 확인
docker compose ps
모두 Up 또는 healthy 면 정상입니다. init_permissions 의 Exited(종료)는 원래 그렇습니다.
▸ git이 없거나 네트워크가 제한될 때(공식 FAQ의 ZIP 방식)
wget -O dify.zip "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r '.zipball_url')"
unzip dify.zip && rm dify.zip
▸ 설정 바꾸기
필수 값은 docker/.env 에서 고칩니다. 선택 설정은 docker/envs/ 의 템플릿을 복사해 고치며, docker/.env 값이 우선합니다. 고친 뒤 재시작:
docker compose down
docker compose up -d

55. 처음 실행해 보기

▸ 셀프호스트
1) 관리자 초기화 페이지를 열어 관리자 계정을 만듭니다.
# Local environment
http://localhost/install
# Server environment
http://your_server_ip/install
2) 그다음 아래 주소로 로그인합니다.
http://localhost
http://your_server_ip
▸ Dify Cloud
cloud.dify.ai 에서 무료로 가입하면 Sandbox 플랜으로 시작합니다.
▸ 첫 앱(공식 '30-Minute Quick Start' 첫 부분)
원문은 Cloud 기준이며, 셀프호스트도 내 인스턴스에서 같은 단계를 따르면 된다고 합니다.
1) Integrations > Model Provider 에서 OpenAI 모델 제공업체를 설치합니다(예시 모델 gpt-5.2). 크레딧 적용 모델은 키 없이 바로 쓸 수 있고, 내 키를 넣어도 됩니다.
2) Model Provider 페이지 오른쪽 위 Default Models 에서 System Reasoning Model 을 gpt-5.2 로 정합니다.
3) Studio > Create from Blank > Workflow 를 고릅니다.
4) 이름을 Multi-platform content generator 로 정하고 Create 를 누르면 워크플로 캔버스(작업 판)가 열립니다.
5) User Input 노드(사용자 입력 칸)에 입력 항목을 추가합니다. 이후 단계는 원문 Quick Start에서 이어서 확인하세요.

66. 알아 둘 기능

README 'Key features' 번역입니다.
1) Workflow: 시각적 캔버스에서 AI 워크플로를 만들고 시험합니다.
2) 폭넓은 모델 지원: 수십 개 제공업체와 자체 호스팅 솔루션의 상용·오픈소스 LLM 수백 종과 연동. GPT, Mistral, Llama3, OpenAI API 호환 모델을 포함합니다.
3) Prompt IDE: 프롬프트(AI 지시문) 작성, 모델 성능 비교, 채팅 앱에 TTS(글을 음성으로) 같은 기능 추가.
4) RAG Pipeline: 문서 넣기부터 검색까지. PDF, PPT 등 흔한 문서에서 글자 추출을 기본 지원합니다.
5) Agent: 자기 샌드박스(격리된 실행 공간)를 가진 자율 에이전트가 명령 실행·소프트웨어 설치·파일 처리를 합니다. Dify Marketplace 도구, MCP 서버, 내 API를 연결해 채팅 앱이나 워크플로 단계로 씁니다.
6) LLMOps: 앱 로그와 성능을 모니터링·분석하고, 운영 데이터와 주석으로 프롬프트·데이터셋·모델을 개선합니다.
7) Backend-as-a-Service: 모든 기능에 대응하는 API가 있어 내 업무 로직에 연동할 수 있습니다.
▸ 공식 문서가 함께 안내하는 것: REST API 연동, CLI(difyctl), 플러그인 개발, Marketplace(연동 기능·앱 템플릿).

77. 막힐 때 / 주의할 점

▸ 설치 문제는 먼저 공식 FAQ
README는 설치가 막히면 FAQ를 보고, 그래도 안 되면 커뮤니티에 문의하라고 안내합니다.
▸ 'Remote branch null not found' 오류
최신 버전을 찾는 GitHub API 요청이 실패하면(주로 비로그인 요청 한도) 아래 오류가 납니다.
fatal: Remote branch null not found in upstream origin
releases 페이지에서 버전 번호를 찾아 직접 지정하세요.
git clone --branch <version> https://github.com/langgenius/dify.git
▸ 업그레이드 전 백업
FAQ는 데이터 손실을 막기 위해 업그레이드 전 항상 백업하라고 합니다.
cp -r dify "dify.bak.$(date +%Y%m%d%H%M%S)"
업그레이드 절차는 릴리스마다 다르니 Releases 페이지 안내를 봅니다. 업그레이드 후 .env.example 과 .env 를 비교해 새 변수를 확인하고, docker-compose.yaml 을 고쳤다면 새 파일에 변경을 다시 적용합니다.
▸ 모델 키와 비용
제공업체는 워크스페이스 소유자·관리자만 관리하며, 추가한 키의 비용은 내 제공업체 계정으로 청구됩니다.
▸ 보안 취약점
공개 이슈에 올리지 말고 GitHub Security Advisories로 비공개 제보하라고 README가 안내합니다.

88. 라이선스와 비용

▸ 라이선스: Dify Open Source License
LICENSE 원문: Apache License 2.0을 수정한 버전에 아래 추가 조건을 붙였습니다.
▸ 조건 1: 상업적 이용
다른 앱의 백엔드 서비스나 기업용 앱 개발 플랫폼 등 상업적 이용이 가능합니다. 단 아래에 해당하면 제작사로부터 상업 라이선스를 받아야 합니다.
a) 멀티테넌트 서비스: Dify의 명시적 서면 허락 없이 Dify 소스 코드로 멀티테넌트 환경을 운영할 수 없습니다. 테넌트 하나 = 워크스페이스(데이터·설정이 분리된 공간) 하나입니다.
b) 로고·저작권 정보: 프런트엔드를 쓰는 동안 콘솔·앱의 로고와 저작권 정보를 지우거나 바꿀 수 없습니다. 프런트엔드를 쓰지 않으면 적용되지 않습니다. 프런트엔드 = 소스 실행 시 web/ 폴더 전체, Docker 실행 시 "web" 이미지.
▸ 조건 2: 기여자 동의 사항
a) 제작사는 필요하면 약관을 더 엄격하게 또는 느슨하게 바꿀 수 있습니다.
b) 기여한 코드는 클라우드 사업 등 상업 목적에 쓰일 수 있습니다.
▸ 그 밖
나머지 권리·제한은 Apache License 2.0을 따릅니다. 제품의 인터랙티브 디자인은 디자인 특허(appearance patent)로 보호된다고 적혀 있습니다.
▸ 비용(가격 페이지, 금액은 바뀌므로 생략)
· Self-Hosted Community: Free. 공개 저장소의 핵심 기능, 단일 워크스페이스, 라이선스 준수.
· Cloud Sandbox: Free. 유료 플랜 Professional, Team 이 있습니다.
· Enterprise: Custom. 포함 항목에 Commercial License Authorization(상업 라이선스 승인)이 있습니다.

99. 면책 및 원문 확인

이 문서는 원저자의 공식 사이트와 깃허브 문서를 한국어로 옮겨 정리한 안내입니다. 가고파는 이 소프트웨어를 개발·배포·보증하지 않으며, 설치·사용으로 생기는 결과(데이터 손실, 보안 문제, 비용, 라이선스 위반 등)에 책임지지 않습니다. 번역·요약 과정의 오류가 있을 수 있고 원문은 수시로 바뀌므로, 설치 전에 반드시 아래 원문(공식 사이트·깃허브)에서 최신 내용을 확인하세요. 제휴 링크·광고가 없습니다. (Dify 추가 고지) Dify는 Apache 2.0을 바탕으로 추가 조건을 붙인 'Dify Open Source License'를 따릅니다. 원문 라이선스에 따르면 Dify의 서면 허락 없이 Dify 소스 코드로 멀티테넌트(여러 고객이 각자 작업 공간을 쓰는 방식) 환경을 운영할 수 없고, 프런트엔드를 쓰는 경우 콘솔·앱의 로고와 저작권 표시를 지우거나 바꿀 수 없습니다. 이런 조건에 해당하면 제작사로부터 상업 라이선스를 받아야 합니다. Dify Cloud에는 유료 플랜이 있습니다. 이 문서는 법률 자문이 아니므로 상업적으로 쓰기 전에 원문 LICENSE를 직접 확인하세요.

원문 주소(복사해서 브라우저 주소창에 붙여넣기):
· 공식 사이트: https://dify.ai
· GitHub 저장소: https://github.com/langgenius/dify
· 공식 문서: https://docs.dify.ai

이 자료를 보는 방법

이 안내는 인스타그램 카드·릴스에서 다 담지 못한 내용을 담은 무료 자료입니다. 로그인이나 이메일 확인 없이 바로 읽을 수 있고, 링크는 새 창에서 열립니다.

가고파 생활 가이드 시리즈

이 자료는 가고파(Natas Market)가 생활 주제별로 만들어 두는 무료 DM 자료 중 하나입니다. 인스타그램·스레드 카드뉴스에서 줄인 설명을 여기서 자세히 풀어 씁니다.

각 자료는 카드뉴스 1편과 한 세트입니다. 카드에서 “댓글에 ○○ 남겨주세요”로 안내한 경우, 그 키워드를 남기면 이 자료 링크를 받습니다.

자주 묻는 질문