Nodaro 문서빠른 시작
명령 두 개로 셀프 호스팅 Nodaro Community Edition을 시작하고, /setup 페이지에서 상태를 확인한 다음 공급자 키나 Nodaro Cloud 연결을 추가해 생성을 시작하세요.
Community Edition 빠른 시작을 따르면 명령 두 개로 아무것도 없는 상태에서 실행 중인 셀프 호스팅 Nodaro까지 갈 수 있습니다. Docker Compose 스택에 자체 데이터베이스, 로그인, 스토리지, 큐가 들어 있으므로 만들 클라우드 계정도, 찾아야 할 API 키도, 구성할 것도 없습니다. Docker 24 이상과 Docker Compose v2가 필요합니다.
Nodaro 시작
저장소 복제와 스택 시작
git clone https://github.com/nodaroai/app.nodaro.ai.git nodaro
cd nodaro
docker compose -f docker-compose.community.yml up첫 부팅에서는 미리 빌드된 약 2.4GB의 앱 이미지와 번들된 서비스를 내려받습니다. 컴파일이 아니라 다운로드이므로 CPU에 부담을 주지 않습니다. 이후 부팅은 몇 초면 끝납니다.
앱 열기와 계정 만들기
http://localhost:3000을 열고 아무 이메일 주소와 비밀번호로 가입하세요. 로컬 스택은 확인 이메일을 보내지 않으므로 계정을 바로 쓸 수 있습니다.
처음 방문하면 홈 화면에 Welcome Demo 워크플로가 추가됩니다. 대본, 이미지, 동영상, 보이스, 최종 편집까지 모든 결과가 이미 만들어진 완성된 실행입니다. 아무것도 구성하기 전에 노드를 열어 보고 최종 클립을 재생할 수 있습니다.
/setup에서 설치 확인
http://localhost:3000/setup을 여세요. 이 페이지는 데이터베이스, Redis, 스토리지, 암호화 키, 공급자 키의 실시간 상태를 보여 주며, 로그인이 필요 없습니다. 새로 만든 스택에서는 공급자 키를 제외한 모든 카드가 초록색입니다.
시작되는 서비스
| 서비스 | 역할 | 데이터 저장 위치 |
|---|---|---|
| Postgres(Supabase 이미지) | 데이터베이스입니다. 첫 부팅 때 마이그레이션이 자동으로 적용됩니다. | db-data 볼륨 |
| GoTrue | 이메일과 비밀번호 로그인입니다. 이메일 서버가 필요 없습니다. | — |
| PostgREST | 편집기가 통신하는 데이터 API입니다. | — |
| MinIO | 미디어 스토리지입니다. 생성된 이미지, 동영상, 오디오가 내 디스크에 남습니다. | minio-data 볼륨 |
| Redis | 작업 큐입니다. | redis-data 볼륨 |
| Nodaro | 앱입니다. 편집기, API, 워커가 포트 3000에서 실행됩니다. | app-data 볼륨 |
스택은 내 컴퓨터에 포트 두 개를 공개합니다. 앱용 3000과 MinIO 콘솔용 9001이며, 9001은 루프백 인터페이스에만 바인딩됩니다.
모델 공급자 추가
데모 보기는 무료이고 오프라인에서도 작동합니다. 노드를 직접 실행하려면 설치에 모델 공급자가 필요합니다. 공급자가 생기기 전까지 홈 화면에 각 방법의 버튼이 있는 이 설치 환경에서는 아직 생성할 수 없습니다. 알림이 표시되며, 이 알림은 닫을 수 있습니다.
세 가지 방법은 함께 쓸 수 있으며, 규칙은 하나입니다. 설치가 Nodaro Cloud에 연결되어 있으면서 NODARO_API_KEY도 가지고 있으면, 연결을 쓰고 키는 무시합니다.
파일도 재시작도 필요 없습니다.
/setup을 열고 1단계 서버 로그인 계정 만들기를 완료하세요. 상태 카드는 로그인 없이 볼 수 있지만, 키를 저장하려면 로그인해야 합니다.- 설치 상태 섹션에서 공급자 타일을 찾으세요. 같은 타일이 앱의 연동 › 모델 공급자에도 있습니다.
- 타일에서 키 붙여 넣기를 클릭하고, 키를 붙여 넣은 다음 저장하세요.
각 타일에는 그 키로 실행되는 기능과 키를 받는 곳이 나와 있습니다. 키는 내 데이터베이스에 암호화되어 저장되고 즉시 적용됩니다. Nodaro Cloud에 연결하면 타일을 채울 필요가 없습니다. 연결이 모든 타일을 대신합니다.
관리할 키가 없습니다.
/setup의 2단계 모델 공급자 연결에서 nodaro.ai 연결을 클릭하세요.- 브라우저에서 Nodaro Cloud 동의 화면이 열립니다. 로그인하거나, 1,500크레딧이 포함된 무료 계정을 만든 다음 승인하세요.
- 연결된 상태로 내 설치에 돌아옵니다.
그러면 이미지, 동영상, 음성, 텍스트 모델이 내 Nodaro Cloud 계정을 통해 실행되고 크레딧으로 청구됩니다. 자세한 내용은 Nodaro Cloud에 연결을 읽어 보세요.
코드형 인프라에 적합합니다. Compose 파일 옆에 .env라는 파일을 만드세요.
KIE_API_KEY=... # broadest model coverage
# or
REPLICATE_API_TOKEN=...
# or
NODARO_API_KEY=... # a personal API token from app.nodaro.ai, Settings › API Tokens그런 다음 적용하세요.
docker compose -f docker-compose.community.yml up -d.env의 키는 화면에 붙여 넣은 키보다 우선합니다. 그 타일에는 set (env)(환경 변수에서 설정됨)이 표시되며, 그 자리에서 편집할 수 없습니다.
모든 공급자와 각 공급자로 실행되는 기능은 공급자 키에서 확인하세요.
비용은 공급자에게 직접 냅니다. Community Edition에는 크레딧 시스템도, Nodaro 수수료도, 워터마크도 없습니다.
무료로 편집기 배우기
홈 화면의 튜토리얼은 첫 부팅 때 추가되는 단계별 안내 모음으로 시작합니다. 둘러보는 데 비용이 들지 않습니다. 이미지, 동영상, 오디오는 Nodaro의 CDN에서 불러오므로 인터넷 연결이 필요합니다. 튜토리얼과 템플릿을 참조하세요.
명령줄에서 설치 확인
/setup보다 더 깊이 확인하려면 복제한 저장소에서 계약 프로브를 실행하세요. Node.js가 필요합니다.
node tools/community-smoke.mjs http://localhost:3000프로브는 일회용 계정으로 가입하고, 워크플로를 만들고, 생성을 제출하고, 작업이 끝날 때까지 따라간 다음 통과한 검사를 보고합니다. 이미 공급자 키를 추가한 경우처럼 내 설치에 해당하지 않는 검사는 건너뜀으로 보고됩니다. 추가 플래그가 없으면 프로브는 비용을 전혀 쓰지 않습니다.
실제 생성도 테스트하려면 --keyed를 추가하세요.
node tools/community-smoke.mjs http://localhost:3000 --keyed--keyed를 쓰려면 설치에 KIE_API_KEY 또는 REPLICATE_API_TOKEN이 .env에 있거나 /setup에 붙여 넣어져 있어야 합니다. 그 키에 맞는 가장 저렴한 모델로 생성을 한 번 실행합니다. KIE_API_KEY로는 Z-Image를, REPLICATE_API_TOKEN으로는 Flux 2 Klein을 씁니다. 공급자 요금으로는 보통 1센트도 들지 않습니다. 그런 다음 프로브는 미디어가 내 설치의 스토리지에 저장되었는지 확인합니다. Nodaro Cloud 연결이나 토큰은 따로 확인합니다.
자주 쓰는 명령
| 작업 | 명령 |
|---|---|
| 백그라운드에서 시작 | docker compose -f docker-compose.community.yml up -d |
| 로그 따라 보기 | docker compose -f docker-compose.community.yml logs -f |
| 스택 중지 | docker compose -f docker-compose.community.yml down |
바뀐 .env 적용 | docker compose -f docker-compose.community.yml up -d |
정말 의도한 경우가 아니라면 down에 -v를 붙이지 마세요. docker compose down -v는 볼륨을 삭제하며, 그와 함께 데이터베이스와 미디어도 삭제됩니다.
다른 사람이 설치에 접근하기 전에
Compose 기본값은 로컬 사용을 위한 것이며, 공개되어 있습니다. 스택을 네트워크에 공개하기 전에 새 인증 키를 발급하고, 데이터베이스와 스토리지의 비밀번호를 새로 설정하고, 설치를 HTTPS로 제공하세요. 설치 보안 강화와 리버스 프록시와 HTTPS를 따르세요.
다음 단계
- 설치: 관리형 서비스, 스토리지, 시크릿을 포함한 전체 설정.
- 리버스 프록시와 HTTPS: 내 도메인에서 설치 제공.
- 업데이트: 이미지 태그와 업데이트.
- 백업과 복원: 각각 명령 하나.
- 문제 해결:
/setup의 카드가 빨간색일 때.
자주 묻는 질문
셀프 호스팅 Nodaro를 처음 시작하는 데 얼마나 걸리나요?
첫 부팅에서 미리 빌드된 약 2.4GB의 앱 이미지와 번들된 서비스를 내려받으므로, 일반적인 인터넷 연결로 몇 분이 걸립니다. 컴파일이 아니라 다운로드입니다. 이후 부팅은 몇 초면 끝납니다.
Community Edition을 실행하려면 .env 파일이 필요한가요?
아니요. docker-compose.community.yml의 모든 값에는 작동하는 기본값이 있습니다. .env 파일은 공급자 키를 추가하거나, 공개 URL을 바꾸거나, 내 관리형 서비스를 쓸 때만 만드세요.
새로 설치한 Nodaro에서 아무것도 생성할 수 없는 이유는 무엇인가요?
아직 모델 공급자가 없기 때문입니다. /setup에 공급자 키를 붙여 넣거나, .env에 키를 설정하거나, 설치를 Nodaro Cloud 계정에 연결하세요. 공급자가 생길 때까지 홈 화면에 두 가지 방법을 안내하는 알림이 표시됩니다.
기본 설치를 그대로 인터넷에 공개해도 안전한가요?
아니요. Compose 파일의 기본 키와 비밀번호는 공개되어 있습니다. 다른 사람이 설치에 접근할 수 있게 하기 전에 새 인증 키를 발급하고, 새 비밀번호를 설정하고, 리버스 프록시 뒤에서 HTTPS로 제공하세요.
Community Edition의 비용은 얼마인가요?
Nodaro에 내는 비용은 없습니다. 크레딧 시스템도, Nodaro 수수료도, 워터마크도 없습니다. 모델 공급자에게 직접 비용을 내거나, Nodaro Cloud 연결로 실행되는 작업에 크레딧으로 비용을 냅니다.
관련 문서
설치
공급자 키
Nodaro Cloud에 연결
리버스 프록시와 HTTPS
문제 해결
최종 업데이트