에디션과 서피스 프로필

Nodaro에는 Community, Business, Cloud라는 세 가지 에디션이 있습니다. 모두 같은 코드로 빌드하며 EDITION 변수로 선택합니다. Business 에디션에서는 서피스 프로필이 다시 빌드하지 않고도 설치가 보여 주는 범위를 좁힙니다. 인터페이스 일부를 숨기고, 노드와 모델을 제거하고, 제품 이름을 바꾸고, 로그인을 제한할 수 있습니다. 이 페이지에서는 두 가지를 모두 다룹니다.

세 가지 에디션

• Community(EDITION=community, 기본값)는 무료 셀프 호스팅 에디션입니다. 가입하는 사람은 모두 일반 사용자가 됩니다.
• Business(EDITION=business)는 관리자 패널과 사용자 관리를 추가합니다. 여전히 셀프 호스팅이며 결제 기능은 없습니다.
• Cloud(EDITION=cloud)는 크레딧과 결제를 추가합니다. app.nodaro.ai를 구동하며 셀프 호스팅용이 아닙니다.

Business 에디션의 관리자 패널과 사용자 관리는 Enterprise 기능입니다. 개발과 테스트 용도로는 실행할 수 있지만, 프로덕션에서 사용하려면 Nodaro Enterprise 구독이 필요합니다. 라이선스를 참고하세요.

셀프 호스팅 설치를 Business로 전환

API는 시작할 때 EDITION을 읽습니다. 브라우저의 편집기는 이미지를 빌드할 때 VITE_EDITION에서 에디션을 읽습니다. 공개된 이미지는 Community Edition으로 빌드되어 있으므로, Business 설치는 소스에서 빌드합니다.

Community에서 Business로 옮겨도 데이터베이스에는 부담이 없습니다. 스키마가 같기 때문입니다.

  nodaro:
    build:
      args:
        VITE_EDITION: business      # was: community
    environment:
      EDITION: business             # was: community

docker compose -f docker-compose.community.yml build --no-cache nodaro
docker compose -f docker-compose.community.yml up -d

소스에서 빌드한 설치는 git pull과 build로 업데이트하세요. docker compose pull을 실행하면 공개된 Community 이미지를 다시 내려받게 됩니다.

빌드는 비어 있거나 알 수 없는 VITE_EDITION을 거부합니다. 이 검사가 없으면 설정하지 않은 값으로도 빌드가 문제없이 끝나 community로 대체되고, Business 이미지가 관리자 패널 없이 배포됩니다. Compose 파일이 값을 대신 전달합니다. 직접 작성한 docker build에는 --build-arg VITE_EDITION=community, business, cloud 중 하나가 필요합니다.

빌드 시점에 고정되는 것과 고정되지 않는 것

세 가지 브라우저 설정은 빌드 시점에 고정되지 않습니다. API 주소, 브라우저의 로그인 주소, anon 키입니다. 컨테이너는 부팅할 때 PUBLIC_URL, FRONTEND_SUPABASE_URL, SUPABASE_ANON_KEY에서 이 값을 가져와 /config.js에 쓰고, 브라우저는 앱이 시작되기 전에 그 파일을 읽습니다. 그래서 공개된 이미지는 재시작하면 어떤 포트나 도메인에서도 제공됩니다. VITE_* 빌드 인수는 런타임 값이 설정되지 않았을 때의 대체값일 뿐입니다.

빌드 시점에 고정되는 다른 브라우저 설정:

서피스 프로필

NODARO_SURFACE_PROFILE은 다시 빌드하지 않고 Business 또는 Cloud 설치의 인터페이스 범위를 좁힙니다. Community Edition은 이 변수를 무시하고 항상 전체 인터페이스를 보여 줍니다.

• 형식. 인라인 JSON이나, 파일을 읽는 @/path/to/profile.json입니다. Compose 스택에서 파일을 쓰려면 컨테이너에 마운트하고 컨테이너 안의 경로를 지정하세요.
• 좁히기만 합니다. 프로필은 숨기고 제거할 수 있습니다. 에디션이 끈 기능을 켜는 일은 절대 없습니다.
• 모든 필드는 선택 사항입니다. 빈 목록은 “기본값 유지”를 뜻합니다. 설정하지 않으면 설치는 전체 인터페이스를 보여 줍니다.
• 오류. 형식이 잘못된 필드는 로그에 경고를 남기고 그 필드의 기본값으로 대체됩니다. 프로필을 전혀 불러올 수 없으면 Business 또는 Cloud 설치가 [surface-profile] FATAL … Refusing to boot a narrowing deployment mainline-open과 함께 부팅을 멈춥니다. 파일을 읽을 수 없거나, JSON이 잘못되었거나, 값 전체가 검증에 실패하면 이렇게 됩니다. 범위를 좁히는 설치가 모든 것을 보여 주는 상태로 실행되어서는 안 되기 때문입니다.
• 적용. 앱을 재시작하세요. 프로필은 /config.js를 통해 브라우저에 전달됩니다.

예시

NODARO_SURFACE_PROFILE={"nav":{"hide":["gallery"]},"brand":{"productName":"Studio"},"outputs":{"allowPublic":false},"voice":{"allowedGenders":["male"]}}

이 설정은 갤러리를 숨기고, 제품 이름을 Studio로 바꾸고, 모든 출력물을 비공개로 유지하고, 남성 보이스만 제공합니다.

필드

로고와 파비콘은 프로필에 포함되지 않습니다. Docker 이미지에 정적 파일 레이어를 추가해 교체하세요.

홈 화면 섹션

dashboard.tabs는 순서가 있는 허용 목록 하나입니다. 전체 키는 workflows, projects, apps, miniapps, templates, tutorials, statistics, gallery, studio, mcp입니다.

• workflows, projects, studio: 이어서 하기 탭의 워크스페이스 필터에 나오는 목록으로, 내 목록의 순서를 따릅니다. 내 목록에 셋 중 아무것도 없으면 셋 모두 표시되므로, 기본 목록이 비는 일은 없습니다.
• apps: 이어서 하기의 Nodaro 앱 띠입니다.
• templates: 탐색의 “템플릿으로 시작하기” 행과 사이드바의 템플릿 항목입니다.
• tutorials: 탐색의 실력 키우기 튜토리얼과 사이드바의 튜토리얼 항목입니다. templates와 tutorials가 모두 없으면 탐색 탭이 표시되지 않습니다.
• miniapps: 사이드바의 미니앱 항목입니다.
• statistics: 실행 기록 페이지의 통계 개요입니다.
• mcp: 네 번째 “이어서 작업하기” 목록으로, MCP 클라이언트가 자동으로 만든 mcp 프로젝트에 생성한 워크플로입니다.

유지할 섹션을 모두 나열하세요. 예를 들어 ["workflows","projects","statistics","tutorials"]는 워크플로 및 프로젝트 목록, 튜토리얼, 통계를 유지합니다. 스튜디오 목록, 앱 띠, 템플릿 행, 사이드바의 템플릿 및 미니앱 항목은 빠집니다. 그 위에 nav.hide도 그대로 적용됩니다.

허용 목록

엄선한 설치에는 허용 목록이 더 안전한 형태입니다. 새 노드나 모델이 거부 목록에 없다는 이유로 나타나는 대신, 내가 나열할 때까지 사용할 수 없는 상태로 남기 때문입니다.

• sticky-note와 preview 같은 유틸리티 노드는 허용 목록에 빠졌다고 제거되지 않습니다. 명시적인 deny만 이 노드를 제거합니다.
• 관리자는 관리자 패널에서 런타임에 노드와 모델의 사용 가능 여부를 바꿀 수 있습니다. 저장된 런타임 설정은 초기 상태로 재설정할 때까지 프로필의 목록을 대신합니다.
• 관리자가 관리자 패널에서 끈 노드는 관리자에게는 계속 사용 가능합니다. 프로필로 제거한 노드는 관리자에게도 제거됩니다. 하지만 관리자가 프로필로 제거된 노드를 관리자 패널에서 다시 켜면 모든 사람에게 풀리므로, 그만큼 믿을 수 있는 사람에게만 관리자 역할을 주세요.
• 끈 모델은 관리자에게도 꺼집니다.
• 실행은 그 실행을 수행하는 사용자 기준으로 검사합니다. 앱이나 프레젠테이션 실행은 실행하는 사람으로 수행됩니다. 예약 실행이나 Webhook으로 트리거된 실행은 워크플로 소유자로 수행되며, API 토큰이나 연결된 앱은 각자의 소유자로 동작합니다. 그 소유자가 관리자라면 실행에서 사용자에게 숨겨진 노드를 쓸 수 있으므로, 그런 워크플로의 Webhook URL은 신중하게 다루세요.
• 숨겨진 노드가 들어 있는 앱, 컴포넌트, 템플릿은 게시할 수 없습니다. 요청이 node_not_available로 실패합니다.
• 역할 변경은 약 5분 안에 이 검사에 반영됩니다.

로그인 방법

auth.methods는 로그인 페이지의 로그인 방법을 email, google, sso 중에서 좁힙니다. sso는 SSO 버튼의 텍스트인 auth.ssoLabel과 함께 있을 때만 목록에 두세요.

sso만 나열한 목록은 서버 쪽 규칙도 켭니다. 로그인한 모든 계정은 싱글 사인온으로 만들었거나 연결된 계정이어야 합니다. 그 밖의 세션은 첫 API 호출에서 403 sso_required로 거부되므로, 로그인 서비스에 직접 등록한 계정은 설치를 쓸 수 없습니다. 목록에 email을 추가하면 이 규칙이 꺼집니다. 싱글 사인온을 참고하세요.

보이스 성별

voice.allowedGenders는 서버에서 적용됩니다.

• 보이스 목록과 공유 보이스 라이브러리에는 허용된 성별의 보이스만 표시됩니다.
• 다른 성별의 기본 제공 보이스를 쓰는 요청은 voice_not_available로 거부됩니다.
• 모든 기본 보이스와 대체 보이스는 허용된 성별의 첫 번째 보이스가 됩니다.
• 편집기는 Suno 노드에서 다른 성별의 보컬 성별 태그를 숨깁니다.

보이스를 만드는 노드의 출력 성별은 미리 알 수 없습니다. 이 노드를 제거하려면 "nodes":{"deny":["voice-design","voice-remix"]}를 추가하세요.

피커 카탈로그

검토된 피커 콘텐츠만 제공해야 하는 설치라면 "catalogs":{"required":true,"factoryPresets":false}로 설정하세요.

• required: true이면 편집기는 서버에서 엄선된 전체 카탈로그를 받은 뒤에만 피커 선택지를 제공하며, 그 요청이 실패하면 아무것도 제공하지 않습니다. 새 노드와 초기화는 제공된 값만 사용합니다.
• factoryPresets: false이면 번들된 프리셋이 편집기와 API에서 숨겨집니다. 사용자가 직접 만든 프리셋은 남습니다.
• 서버는 가져오거나 이전에 저장한 워크플로에서도 제외된 카탈로그 선택지를 거부합니다.