Nodaro 문서셀프 호스팅
Docker Compose로 내 서버에서 Nodaro를 실행하세요. Community, Business, Cloud 에디션을 비교하고, 내 키나 Nodaro Cloud 연결이 필요한 기능을 확인하세요.
Nodaro를 셀프 호스팅한다는 것은 비주얼 편집기, REST API, 워크플로를 실행하는 워커를 포함한 제품 전체를 내가 관리하는 서버에서 실행한다는 뜻입니다. Docker Compose 파일 하나가 Nodaro와 함께 자체 데이터베이스, 로그인, 미디어 스토리지, 작업 큐를 시작하므로, 새로 설치할 때 클라우드 계정도 구성도 필요하지 않습니다. 그다음 이미지, 동영상, 오디오를 생성하려면 내 모델 공급자 키를 추가하거나 설치를 Nodaro Cloud에 연결하세요.
셀프 호스팅 AI 생성기에서 팀이 Nodaro를 직접 실행하는 이유, 생성할 수 있는 것, fair-code 라이선스가 허용하는 범위를 설명합니다.
제공되는 것
- 편집기와 API 전체. Nodaro Cloud와 같은 캔버스, 노드, 앱, REST API를 내 도메인에서 제공합니다. 내 설치의 OpenAPI 3.1 문서는
/v1/openapi.json에 있습니다. - 모든 구성 요소 포함. Compose 스택은 Nodaro 옆에서 Postgres, 로그인, 데이터 API, MinIO 스토리지, Redis를 실행합니다. 미디어는 내 디스크에 남습니다.
- 크레딧 없음. Community Edition에는 크레딧 시스템도, Nodaro 수수료도, 워터마크도 없습니다. 모델 공급자에게 직접 비용을 냅니다.
- 상태 화면.
/setup은 로그인 없이 데이터베이스, Redis, 스토리지, 암호화 키, 내 공급자 키의 상태를 보여 줍니다. - 명령 하나로 백업. 스크립트 하나가 데이터베이스, 미디어, 암호화 키,
.env를 하나의 아카이브에 저장합니다.
세 가지 에디션
Nodaro에는 같은 코드로 빌드한 세 가지 에디션이 있습니다. EDITION 변수로 community, business, cloud 중 하나를 선택합니다.
| Community | Business | Cloud | |
|---|---|---|---|
| 실행 위치 | 내 서버 | 내 서버 | app.nodaro.ai, Nodaro가 관리 |
| 관리자 패널 | 아니요 | 예 | 예 |
| 사용자 관리 | 아니요 | 예 | 예 |
| 크레딧과 결제 | 아니요 | 아니요 | 예 |
| 서피스 프로필 | 무시됨 | 예 | 예 |
공개된 Docker 이미지는 Community Edition입니다. Business 에디션의 관리자 패널과 사용자 관리는 Enterprise 기능이며, 프로덕션에서 Enterprise 기능을 사용하려면 Nodaro Enterprise 구독이 필요합니다. 에디션을 전환하는 방법은 에디션과 서피스 프로필을, 이용 조건은 라이선스를 읽어 보세요.
내 키 또는 Nodaro Cloud 연결
AI 모델을 호출하는 노드에는 모델 공급자가 필요합니다. 셀프 호스팅 설치는 두 가지 방법으로 공급자를 얻습니다. 내 공급자 키를 쓰거나, 크레딧으로 청구하는 Nodaro Cloud 계정에 연결하는 것입니다. 두 방법을 함께 쓸 수도 있습니다.
| 실행하려는 것 | 필요한 것 |
|---|---|
| 표준 이미지, 동영상, 음성, 음악, 텍스트 모델 | KIE_API_KEY, REPLICATE_API_TOKEN, ANTHROPIC_API_KEY, GEMINI_API_KEY, ELEVENLABS_API_KEY 같은 내 공급자 키, 또는 Nodaro Cloud 연결 |
| AI 아바타와 시네마틱 아바타 | HEYGEN_API_KEY 또는 Nodaro Cloud 연결 |
| 조명 변경 및 교체 | BEEBLE_API_KEY 또는 Nodaro Cloud 연결 |
| 웹 스크래핑과 사이트 캡처 | APIFY_API_TOKEN 또는 Nodaro Cloud 연결 |
| 동영상 생성 Pro, 동영상 편집 Pro, 보이스 체인저 Pro, 동영상 분석, AI 검수 같은 Nodaro 전용 노드 | Nodaro Cloud 연결 |
| 자르기와 합치기 같은 동영상 및 오디오 편집, 동영상 렌더링 | 필요 없음: 내 서버에서 실행됩니다 |
| 3D 장면 생성과 3D 장면 편집 | 텍스트 모델 키. 장면은 내 서버에서 렌더링됩니다. |
| 스토리 → 동영상과 3D 렌더링 Pro | 셀프 호스팅 설치에서는 사용할 수 없음 |
각 키로 무엇을 실행할 수 있는지는 공급자 키를, 연결 방법은 Nodaro Cloud에 연결을 읽어 보세요.
구성 요소의 연결 방식
컨테이너 하나가 웹 서버, API, 워커를 실행합니다. Redis가 이들 사이에 작업을 전달하고, Postgres가 데이터를 보관하며, S3 호환 스토리지가 미디어를 보관합니다.
워커는 내 모델 공급자를 호출하며, 설치가 연결되어 있으면 Nodaro Cloud를 호출합니다. 프로세스, 큐, 인증 모드는 아키텍처를 읽어 보세요.
이 섹션을 읽는 순서
설치
빠른 시작
명령 두 개로 Community Edition을 실행한 뒤 공급자를 추가합니다.
요구 사항
Docker, 데이터베이스, 스토리지, 포트, 공급자 키.
설치
전체 설정: .env, 시크릿, 마이그레이션, 스토리지, 첫 로그인.
리버스 프록시와 HTTPS
nginx나 Caddy로 내 도메인에서 설치를 제공합니다.
첫 사용자와 관리자
첫 사용자를 가입시키고 관리자로 승격합니다.
에디션과 서피스 프로필
Business로 전환하고 인터페이스 범위를 좁힙니다.
구성
구성
모든 환경 변수를 그룹별로, 기본값과 함께.
공급자 키
/setup에 키를 붙여 넣거나 .env에 설정합니다.
데이터베이스
번들된 Supabase 스택, 관리형 프로젝트, 마이그레이션.
Nodaro Cloud에 연결
키 없이 쓰는 모델과 Nodaro 전용 노드.
MCP
Claude, Cursor 같은 AI 클라이언트가 내 설치를 사용하게 합니다.
싱글 사인온
내 ID 공급자로 사용자를 로그인시킵니다.
운영
업데이트
이미지 태그, 업데이트, 메이저 버전, 롤백.
확장
워커를 분리하고 동시 실행 수를 조정합니다.
백업과 복원
양방향 모두 명령 하나, 그리고 유일한 다운그레이드 방법.
문제 해결
/setup에서 시작하는 증상과 해결 방법.
프로젝트
자주 묻는 질문
Nodaro를 내 서버에서 실행할 수 있나요?
네. 공개 리포지토리를 클론하고 docker compose -f docker-compose.community.yml up을 실행하세요. 스택에 자체 데이터베이스, 로그인, 스토리지, 큐가 들어 있으므로 시작할 때 클라우드 계정이 필요하지 않습니다.
Community, Business, Cloud 에디션은 어떻게 다른가요?
Community는 무료 셀프 호스팅 에디션으로, 관리자 패널과 크레딧이 없습니다. Business도 셀프 호스팅 에디션이며 관리자 패널과 사용자 관리가 추가됩니다. Cloud는 app.nodaro.ai에서 제공하는 관리형 서비스로, 크레딧과 결제가 있으며 셀프 호스팅용으로는 제공되지 않습니다.
Nodaro를 셀프 호스팅하려면 API 키가 필요한가요?
설치하고 데모를 여는 데는 필요하지 않습니다. 생성하려면 /setup 페이지나 .env에 내 모델 공급자 키를 추가하거나, 설치를 Nodaro Cloud 계정에 연결하세요. Nodaro Cloud에 연결하면 내 키 없이도 표준 모델을 실행할 수 있습니다.
셀프 호스팅한 Nodaro에 비용이 드나요?
Community Edition에는 크레딧도, Nodaro 수수료도, 워터마크도 없습니다. 모델 공급자에게 직접 비용을 내거나, Nodaro Cloud 연결을 통해 실행한 만큼 크레딧으로 냅니다. 누가 무료로 사용할 수 있는지는 라이선스가 정합니다.
셀프 호스팅 설치에서 사용할 수 없는 기능은 무엇인가요?
스토리 → 동영상 파이프라인과 3D 렌더링 Pro는 Nodaro Cloud에서만 실행됩니다. 동영상 생성 Pro와 보이스 체인저 Pro 같은 Nodaro 전용 노드는 Nodaro Cloud 연결을 통해 셀프 호스팅 설치에서 실행됩니다.
관련 문서
빠른 시작
요구 사항
에디션과 서피스 프로필
Nodaro Cloud에 연결
라이선스
최종 업데이트