NodaroAccount
Docs do Nodaro
DocumentaçãoReferência de nósModelosTemplatesAgentes de IA (MCP)DesenvolvedoresAuto-hospedagemPesquisaComparações

Edições e perfis de superfície

Compare as edições Community, Business e Cloud, mude um Nodaro auto-hospedado para a Business e restrinja a interface dele com um NODARO_SURFACE_PROFILE.

O Nodaro tem três edições — Community, Business e Cloud —, feitas a partir do mesmo código e escolhidas com a variável EDITION. Na Business edition, um perfil de superfície restringe, então, o que a instalação mostra, sem recompilar. Ele pode ocultar partes da interface, remover nós e modelos, renomear o produto e restringir o login. Esta página trata dos dois.

As três edições

CommunityBusinessCloud
Pode ser auto-hospedadaSimSimNão, gerenciada pelo Nodaro
Painel de administraçãoNãoSimSim
Gerenciamento de usuáriosNãoSimSim
Registro de créditosNãoNãoSim
CobrançaNãoNãoSim
Preços de crédito definidos por administradoresNãoNãoSim
Perfil de superfícieIgnoradoSimSim
  • Community (EDITION=community, o padrão) é a edição auto-hospedada gratuita. Qualquer pessoa que cria uma conta se torna um usuário comum.
  • Business (EDITION=business) acrescenta o painel de administração e o gerenciamento de usuários. Ela continua auto-hospedada e continua sem cobrança.
  • Cloud (EDITION=cloud) acrescenta créditos e cobrança. Ela é a base do app.nodaro.ai e não é feita para auto-hospedagem.

O painel de administração e o gerenciamento de usuários da Business edition são recursos Enterprise. Você pode rodá-los para desenvolvimento e testes, mas usá-los em produção exige uma assinatura do Nodaro Enterprise. Veja Licença.

Mudar uma instalação auto-hospedada para a Business

A API lê EDITION na inicialização. O editor no navegador lê a edição dele de VITE_EDITION quando a imagem é compilada. A imagem publicada é compilada como Community Edition, então uma instalação Business é compilada a partir do código-fonte.

Passar da Community para a Business não tem custo no banco de dados: o esquema é o mesmo.

Mudar os dois valores no arquivo do Compose

No docker-compose.community.yml, no serviço nodaro, mude as duas linhas que dizem community:

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

As duas linhas são fixas no arquivo do Compose, então definir EDITION no .env não tem efeito.

Compilar e iniciar

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

Atualize uma instalação compilada a partir do código-fonte com git pull e build. O docker compose pull baixaria de novo a imagem Community publicada.

A compilação recusa um VITE_EDITION vazio ou desconhecido. Sem essa verificação, um valor não definido compilaria sem erros e voltaria a community, e uma imagem Business sairia sem o painel de administração. O arquivo do Compose passa o valor para você. Um docker build escrito à mão precisa de --build-arg VITE_EDITION=community, business ou cloud.

O que é fixado na compilação e o que não é

Três configurações do navegador não são fixadas na compilação: o endereço da API, o endereço de login do navegador e a chave anon. Na inicialização, o contêiner as grava em /config.js a partir de PUBLIC_URL, FRONTEND_SUPABASE_URL e SUPABASE_ANON_KEY, e o navegador lê esse arquivo antes de o app iniciar. Assim, a imagem publicada serve qualquer porta ou domínio depois de uma reinicialização. Os argumentos de compilação VITE_* são só alternativas para valores de tempo de execução não definidos.

Outras configurações do navegador fixadas na compilação:

Argumento de compilaçãoO que fazPadrão
VITE_STUDIO_URLO endereço do app Studio, para os links Abrir no Studiohttps://studio.nodaro.ai
VITE_PERSON_URLO endereço do app Person, para o cartão Abrir Person da tela inicialhttps://person.nodaro.ai

Perfis de superfície

NODARO_SURFACE_PROFILE restringe a interface de uma instalação Business ou Cloud sem recompilar. A Community Edition ignora essa variável e sempre mostra a interface completa.

  • Formato. JSON inline, ou @/path/to/profile.json para ler um arquivo. Para usar um arquivo no conjunto de serviços do Compose, monte-o no contêiner e informe o caminho dele dentro do contêiner.
  • Só restringe. Um perfil pode ocultar e remover. Ele nunca ativa algo que a edição desativa.
  • Todos os campos são opcionais. Uma lista vazia significa “manter o padrão”. Sem a variável, a instalação mostra a interface completa.
  • Erros. Um campo malformado volta ao padrão desse campo, com um aviso no registro. Um perfil que não carrega de jeito nenhum impede a inicialização de uma instalação Business ou Cloud, com [surface-profile] FATAL … Refusing to boot a narrowing deployment mainline-open. Isso acontece com um arquivo ilegível, um JSON inválido ou um valor que falha na validação como um todo. Uma instalação com restrições nunca deve subir mostrando tudo.
  • Aplicar. Reinicie o app. O perfil chega ao navegador pelo /config.js.

Exemplo

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

Isso oculta a galeria, renomeia o produto para Studio, mantém todas as saídas privadas e oferece só vozes masculinas.

Campos

CampoO que faz
nav.hideOculta itens da barra lateral. Valores: gallery, explore, pricing, templates, apps, community, integrations. Ocultar apps também esvazia a listagem pública de apps: GET /v1/apps/browse, as listas de apps do SDK e da CLI e o escopo público da ferramenta MCP list_apps. Os apps da própria pessoa e um app aberto pelo link dele não mudam. Ocultar gallery também remove a rota pública /v1/gallery.
dashboard.tabsUma única lista de permissões ordenada das seções da tela inicial. Veja Seções da tela inicial.
nodes.deny, models.denyTipos de nó e IDs de modelo a remover em todos os lugares: no menu Adicionar nó, em GET /v1/nodes, em GET /v1/models, nas ferramentas MCP e na hora da execução. Um nó removido falha com node_not_available.
nodes.allow, models.allowListas de permissões. Quando uma lista não está vazia, só os tipos de nó ou os IDs de modelo listados são oferecidos, e deny ainda retira itens deles. Veja Listas de permissões.
auth.methods, auth.ssoLabelOs métodos de login a oferecer: email, google, sso. sso é descartado, a menos que auth.ssoLabel esteja definido. Veja Métodos de login.
siblings.appsSubstitui os links do Nodaro no seletor de produtos: [{ "label": "...", "url": "..." }].
brand.productNameSubstitui o logotipo tipográfico e o título da página. Sem ele, o título da página fica como veio. Veja A marca no cabeçalho da página.
brand.wordmarkTexto curto mostrado ao lado do seu próprio logo no cabeçalho da barra lateral, para uma instalação que tem os próprios arquivos de logo. Por exemplo, o nome de produto Acme Studio com o logotipo tipográfico Studio.
brand.descriptionSubstitui a meta description da página.
brand.faviconO ícone do navegador: um caminho no seu site, ou uma lista de até quatro. Veja A marca no cabeçalho da página.
brand.platformLinksfalse oculta os links da própria plataforma para avisos legais, documentação, notas de versão e promoção de produtos. Os links que você define em siblings.apps continuam.
locale.defaultO idioma em que um novo visitante começa.
locale.pickerfalse oculta o seletor de idioma. O padrão é true, também quando você omite a chave ao lado das outras chaves de locale.
locale.offeredOs idiomas que um visitante pode escolher, como IDs de localidade, por exemplo ["he","en"]. Veja Idiomas oferecidos.
outputs.allowPublicfalse torna todas as saídas privadas, seja qual for a escolha do usuário, e fecha toda leitura que entrega o trabalho de uma pessoa a outra. Veja Saídas privadas.
jobs.errorDetailQuem lê as próprias palavras do provedor sobre uma tarefa que falhou: "owner" (o padrão) ou "admin". Veja Palavras do provedor.
imports.linksfalse recusa a importação de mídia a partir de um link para outro site. Veja Importação por link.
imports.inputLinks"allow", "report" ou "refuse": o que acontece com uma entrada de mídia dada como link para outro site enquanto a importação por link está desligada. Veja Entradas de mídia dadas como links.
stringsOs seus próprios textos para a interface do editor, por idioma. Veja Os seus próprios textos.
voice.allowedGendersRestringe as vozes a qualquer subconjunto de male, female e neutral. Vazio significa todos os gêneros. Veja Gêneros de voz.
features.hideDesativa recursos inteiros: copilot remove o Workflow Copilot, e presentation oculta a aba Apresentar do canvas.
catalogs{ "required": true, "factoryPresets": false } para instalações que precisam de conteúdo revisado nos seletores, e images para as imagens das opções dos seletores. Veja Catálogos de seletores.
developerApps.manageQuem pode criar, alterar e excluir apps de desenvolvedor: "owner" (o padrão) ou "admin". Veja Apps de desenvolvedor.
mcp.byPath, mcp.path{"mcp":{"byPath":true}} serve o endpoint MCP sob um caminho nos próprios hosts da instalação, /v1/mcp por padrão, em vez de em um host MCP dedicado. Veja MCP por caminho.

O perfil não leva arquivos de imagem. Inclua os seus arquivos de logo e de ícone com uma camada de arquivos estáticos na sua imagem Docker. Depois, brand.favicon indica os ícones no cabeçalho da página.

Seções da tela inicial

dashboard.tabs é uma única lista de permissões ordenada. O conjunto completo de chaves é workflows, projects, apps, miniapps, templates, tutorials, statistics, gallery, studio e mcp.

  • workflows, projects, studio — as listas do filtro de espaço de trabalho da aba Continuar, na ordem da sua lista. Se a sua lista não citar nenhuma das três, as três aparecem, para que a lista principal nunca fique vazia.
  • apps — a faixa de apps do Nodaro na aba Continuar.
  • templates — a linha “Comece com um template” da aba Explorar e o item Templates da barra lateral.
  • tutorials — os tutoriais da seção Suba de nível na aba Explorar e o item Tutoriais da barra lateral. Sem templates e tutorials, a aba Explorar não aparece.
  • miniapps — o item Miniapps da barra lateral.
  • statistics — o resumo de estatísticas da página Execuções.
  • mcp — a quarta lista de “Continue de onde parou”: os workflows que um cliente MCP criou no projeto automático mcp dele.

Liste todas as seções que você quer manter. Por exemplo, ["workflows","projects","statistics","tutorials"] mantém as listas de workflows e de projetos, os tutoriais e as estatísticas. Essa lista remove a lista do Studio, a faixa de apps, a linha de templates e os itens Templates e Miniapps da barra lateral. nav.hide continua valendo por cima disso.

Listas de permissões

Uma lista de permissões é o formato mais seguro para uma instalação com curadoria. Um nó ou um modelo novo fica, então, indisponível até você listá-lo, em vez de aparecer porque você não o bloqueou.

  • Os nós utilitários, como sticky-note e preview, nunca são removidos por ficarem de fora de uma lista de permissões. Só um deny explícito os remove.
  • Os administradores podem alterar a disponibilidade de nós e modelos em tempo de execução, no painel de administração. Uma configuração de tempo de execução salva substitui as listas do perfil até ser redefinida para o estado de fábrica.
  • Um nó que um administrador desativa no painel de administração continua utilizável pelos administradores. Um nó removido pelo perfil também é removido para os administradores. Mas um administrador que reativa no painel de administração um nó removido pelo perfil o libera para todos, então dê a função de administrador só a pessoas em quem você confia para isso.
  • Um modelo desativado também fica desativado para os administradores.
  • Uma execução é verificada como o usuário em nome de quem ela roda. Uma execução de app ou de apresentação roda como a pessoa que a executa. Uma execução agendada ou disparada por webhook roda como o proprietário do workflow, e um token de API ou um app conectado age como o proprietário dele. Quando esse proprietário é um administrador, a execução pode usar um nó oculto para os usuários, então trate com cuidado a URL de webhook de um workflow assim.
  • Um app, um componente ou um template que contém um nó oculto não pode ser publicado: a requisição falha com node_not_available.
  • Uma mudança de função chega a essas verificações em cerca de 5 minutos.

Uma lista de modelos julga o modelo que uma requisição realmente executa, não só o modelo que ela indica:

  • Os padrões contam. Uma requisição ou um nó de workflow que não indica modelo é julgado pelo padrão que executaria, como o padrão de imagem para a proporção ou o LLM padrão de um recurso de texto. Um modelo indicado em outro campo, como llmModel, também é julgado. Uma requisição recusada falha com 403 model_not_available, na execução e em POST /v1/quote, antes de qualquer criação ou cobrança.
  • Liste todos os modelos que a instalação executa. Inclua os LLMs por trás dos recursos de texto. Uma requisição cujo modelo não está listado é recusada. Ela nunca passa para um padrão que não está na lista.
  • Nós novos começam em um modelo permitido. No editor, um nó novo, ou um nó redefinido para os padrões, cujo modelo padrão não é oferecido começa no primeiro modelo que o próprio menu de modelos dele oferece. Um nó salvo, copiado ou colado mantém o modelo, e a execução recusa esse modelo quando ele não é oferecido.
  • Nós que o servidor cria. A mesma regra vale para um workflow escrito por um cliente MCP e para os nós que uma edição do Copilot adiciona. Ela também vale para um workflow criado a partir de um template e para o workflow inicial de uma conta nova. Um modelo que quem escreve indica é mantido. As ferramentas MCP e o Copilot dizem quais nós começaram em outro modelo. Um workflow escrito pela API REST é salvo como foi enviado.
  • Adicionar legendas sem mecanismo. Um nó Adicionar legendas que não indica nenhum mecanismo de transcrição executa o primeiro mecanismo que a instalação oferece, nesta ordem: incredibly-fast-whisper, elevenlabs-stt, nemotron-3-5-transcribe, whisper. O menu dele lista só os mecanismos oferecidos. Se nenhum dos quatro for oferecido, uma execução que precisa transcrever é recusada, e uma execução que traz as próprias legendas ou a própria transcrição continua rodando.
  • Gerar vídeo Pro e Editar vídeo Pro executam seedance-2 quando não indicam nenhum modelo, então liste-o para esses nós.
  • Menus com valores próprios. Alguns nós listam versões ou motores em vez de IDs de modelo, como as versões do Suno, os modificadores de voz, Upscale de vídeo, Transcrever e Gerar música. Esses nós mantêm os padrões, então liste esses padrões, ou os nós são recusados na execução.
  • Sem lista de modelos, nada muda. Uma instalação que não restringe modelos mantém todos os padrões como estão.

Uma lista de modelos julga os modelos que GET /v1/models lista, e os LLMs. Um modelo que não está nesse catálogo não é retido por ficar de fora: retenha o nó dele com nodes.allow ou nodes.deny. Estes modelos estão no catálogo, então uma lista de permissões que deixa um deles de fora o recusa, enquanto os outros modelos do nó continuam rodando:

  • FLUX Fill Pro (flux-fill), um modelo de Modificar imagem e de Imagem para imagem.
  • Wan Animate Move e Replace (wan-animate-move, wan-animate-replace), modelos de Transferir movimento.
  • LatentSync, HeyGen Lipsync Precision e Lipsync 2 Pro (latentsync, heygen-lipsync-precision, lipsync-2-pro), modelos de Sincronização labial.
  • Suno v4.5 Plus, Suno v4.5 All e Suno v4.5 (suno-v4_5plus, suno-v4_5all, suno-v4_5), as versões V4_5PLUS, V4_5ALL e V4_5 do Suno.
  • O modelo de um personagem treinado (flux-lora-character). Nenhum menu, GET /v1/models ou list_models do MCP o oferece. Uma execução de Gerar imagem passa para ele sozinha quando o único personagem que ela indica tem um modelo treinado. Onde uma restrição o retém, a execução não passa para ele. Ela roda o modelo que o nó ou a requisição indica, pelo preço desse modelo, e usa as imagens de referência do personagem. Uma requisição que indica o próprio flux-lora-character é recusada com 403 model_not_available.

Esses modelos entraram no catálogo depois. Uma configuração de modelos salva no painel de administração antes disso os deixa desligados até que um administrador os ligue.

As listas também valem na API direta. Toda rota que executa um nó é conferida como esse nó, seja qual for o caminho: por exemplo, POST /v1/suno/generate como suno-generate, e as rotas /continue e de transmissão contínua de um nó como o próprio nó. Com nodes.allow definido, uma rota de geração que não está ligada a nenhum nó é recusada com node_not_available. A única rota que não executa nenhum nó, o Workflow Copilot, não é conferida assim. features.hide a controla.

Três IDs de disponibilidade não têm nó no canvas. Liste-os em nodes.allow e nodes.deny exatamente como um nó:

  • cast-swap é o Video Remake: POST /v1/video-remake e as rotas dele, e toda execução de tendência. POST /v1/trends/:slug/estimate e /runs respondem node_not_available onde ele não é oferecido.
  • film-pipeline é o pipeline de filme (História → vídeo, Nodaro Cloud). Onde ele não é oferecido, POST /v1/pipelines e toda rota de pipeline que inicia ou continua trabalho respondem 403 node_not_available, antes de qualquer reserva. Ler um pipeline, mudar uma execução para manual e POST /v1/pipelines/:id/cancel continuam liberados, então um pipeline iniciado antes ainda pode ser acompanhado e interrompido. Um pipeline em execução não inicia a próxima etapa: ele falha com node_not_available, e a reserva não gasta é reembolsada. Um pipeline pausado em uma etapa de aprovação continua pausado. As ferramentas MCP start_pipeline, branch_pipeline, chat_pipeline_stage e apply_chat_proposal não são listadas. O nó do canvas que abre um pipeline, generative-pipeline, é um nó próprio, então liste os dois para o pipeline do editor. Veja Pipelines.
  • video-director é o Diretor de vídeo: POST /v1/video-director/run e as ferramentas MCP create_explainer e create_launch_video. As etapas de fala, alinhamento e renderização dele são conferidas cada uma como o próprio nó, então liste também text-to-speech, forced-alignment e render-video. As duas ferramentas MCP só são listadas onde os quatro são oferecidos.

Antes de o editor conhecer quem está vendo. O editor pergunta ao servidor o que é oferecido a quem está com login. Até essa resposta chegar, e nas páginas que nunca perguntam, como um app publicado ou uma apresentação, o editor aplica as listas nodes, models e worlds do próprio perfil. Assim, nada que as listas retêm é desenhado, nem na primeira pintura da tela. Um nó ou modelo que só um administrador desligou pode aparecer até a resposta chegar. O que quer que o navegador mostre, o servidor recusa um nó ou modelo retido quando ele é salvo ou executado.

A lista de ferramentas MCP acompanha a oferta. Quando a instalação restringe o que oferece, uma sessão MCP só lista uma ferramenta quando tudo de que ela precisa é oferecido ao usuário dessa sessão. Uma restrição é nodes.allow, nodes.deny, models.allow, models.deny, worlds.allow, imports.links: false ou um nó que um administrador desligou. Do que uma ferramenta precisa:

  • O nó que a rota dela executa. Isso inclui cast-swap, film-pipeline e video-director, e cada etapa que uma chamada executa em sequência.
  • O mundo studio, para as ferramentas de produções do Studio que criam ou alteram uma produção.
  • Importações por link, para download_youtube_audio e capture_site.
  • Pelo menos um modelo do Suno, para as ferramentas do Suno, quando os modelos são restritos.

As ferramentas que leem os próprios dados do usuário, agem sobre trabalhos já feitos, fornecem uploads, executam workflows, apps ou componentes salvos ou fornecem documentação são sempre listadas. Uma chamada a uma ferramenta que não está na lista responde com a própria recusa da execução, como 403 node_not_available, model_not_available, link_imports_disabled ou world_not_available, antes de qualquer criação ou reserva. A lista é calculada a cada requisição, então acompanha uma mudança de disponibilidade em até um minuto. get_node_skill recusa um nó retido, e o catálogo de nós de start_workflow_editor o deixa de fora. Uma instalação que não define nenhuma dessas restrições mantém a lista completa de ferramentas.

Uma configuração de disponibilidade em tempo de execução salva antes de um ID passar a ser controlável não decide esse ID. cast-swap, film-pipeline e video-director mantêm o estado de fábrica até a configuração ser salva de novo, então uma atualização nunca desativa algo que os usuários tinham.

Métodos de login

auth.methods restringe os métodos de login da página de login, entre email, google e sso. Mantenha sso na lista só junto com auth.ssoLabel, o texto do botão de SSO.

Uma lista que cita só sso também ativa uma regra no servidor: toda conta logada precisa ter sido criada ou vinculada por login único (SSO). Qualquer outra sessão é recusada na primeira chamada à API com 403 sso_required, então uma conta registrada diretamente no serviço de login não pode usar a instalação. Adicionar email à lista desativa a regra. Veja Login único (SSO).

Gêneros de voz

voice.allowedGenders é aplicado no servidor. Uma lista vazia permite todos os gêneros.

  • Listas. A lista de vozes (GET /v1/voices), a biblioteca compartilhada de vozes (GET /v1/voices/library) e a lista de clones de voz (GET /v1/voice-clones) mostram só vozes de gênero conhecido e permitido. As contagens dos filtros da biblioteca (GET /v1/voices/library/facets) contam esse mesmo conjunto restrito.
  • Uso. Uma voz é avaliada só pelo ID. O gênero vem do catálogo de vozes embutido, do clone do próprio usuário ou, para uma voz da biblioteca, do gênero que a biblioteca informou quando esta instalação a listou com a restrição definida. Uma voz de outro gênero é recusada com voice_not_available. Também é recusada uma voz cujo gênero nenhuma dessas fontes consegue determinar, como uma voz da biblioteca escolhida antes da restrição. A requisição é recusada antes que qualquer tarefa seja criada.
  • Onde vale. Texto para fala, Texto para diálogo e Modificador de voz, nas rotas e nas execuções de workflow. O Modificador de voz Pro numa instalação conectada ao Nodaro Cloud. O Gerar vídeo com vozes de personagem: toda voz em que o clipe fala. O worker de fala confere cada voz de novo antes de enviá-la, então uma tarefa na fila cuja voz é recusada falha.
  • Dublagem. A dublagem é recusada enquanto há uma restrição, em POST /v1/dubbing e no nó Dublagem. Uma dublagem fala com clones dos falantes da origem ou com vozes que o serviço de dublagem escolhe, então as vozes dela não podem ser conferidas.
  • Padrões. Toda voz padrão e de reserva passa a ser a primeira voz de um gênero permitido, também quando uma requisição não indica voz. O editor oculta as tags de gênero vocal dos outros gêneros nos nós do Suno.

O gênero de saída dos nós que criam vozes não pode ser conhecido antes. Para removê-los e remover o nó Dublagem, adicione "nodes":{"deny":["voice-design","voice-remix","dubbing"]}.

A restrição avalia as vozes que o Nodaro escolhe. Ela não avalia:

  • Uma faixa de áudio que a requisição fornece. Fala para vídeo e Sincronização labial a usam como veio.
  • A fala que um modelo de vídeo gera com a própria voz.
  • As vozes do nó Avatar de IA no modo de texto, que vêm do catálogo de vozes do próprio nó.

Catálogos de seletores

Para instalações que só podem oferecer conteúdo revisado nos seletores, defina "catalogs":{"required":true,"factoryPresets":false}.

  • Com required: true, o editor só oferece opções nos seletores depois de receber do servidor o catálogo completo com curadoria, e não oferece nenhuma se essa requisição falhar. Os nós novos e as redefinições de fábrica usam só valores oferecidos.
  • Com factoryPresets: false, as predefinições incluídas ficam ocultas no editor e na API. As predefinições dos próprios usuários continuam.
  • O servidor também rejeita opções excluídas do catálogo em workflows importados ou salvos anteriormente.

catalogs.images define as imagens das opções dos seletores: "default" (as imagens da plataforma, o padrão), "none" ou "own". Qualquer outro valor é lido como "none", com um aviso. Com qualquer valor exceto "default":

  • A API deixa todas as imagens de fora dos catálogos de seletores. Nenhuma opção traz imageUrl ou imageSrcSet, nenhum tópico de Pessoa ou Figurino e beleza traz imageUrl, e todo imageCount do diretório é 0. Isso vale para GET /v1/picker-catalogs, GET /v1/picker-catalogs/:nodeType, GET /v1/catalogs e a ferramenta MCP get_picker_catalog. Todo o resto dessas respostas continua igual. Veja Catálogos de seletores.
  • O editor não mostra nenhuma das imagens da plataforma. Isso inclui as prévias renderizadas da CDN do Nodaro e as fotos, os emojis e as bandeiras que a própria instalação serve. Cada seletor, os nós do canvas e os cartões de entrada dos apps mostram o que mostram para uma opção sem imagem: uma prévia desenhada, um ícone ou o rótulo. O cartão Pessoa da tela inicial não mostra fotos.

"own" mostra no lugar as imagens que a implantação registrou. Sem nenhuma registrada, é exatamente "none". Com "none", as imagens registradas também não aparecem, e com "default" elas são ignoradas.

  • Registrar imagens. Uma implantação registra as próprias imagens no próprio código, na inicialização, no mesmo lugar em que registra pacotes de presets. Cada entrada indica um ID de catálogo, uma opção desse catálogo, o endereço de uma imagem e uma imagem maior opcional.
  • Onde as imagens ficam. Cada endereço é um caminho no próprio site da sua instalação, como /brand/pictures/style/cinematic.3f9a2c1e.webp, ou um endereço https no próprio host de mídia da instalação. Veja As suas próprias imagens no seu site. Um endereço em qualquer outro host, a CDN do Nodaro incluída, é recusado, assim como um arquivo de vídeo.
  • Conferido na inicialização. Uma entrada malformada, uma opção registrada duas vezes ou uma opção que não está nos catálogos da implantação impede a inicialização, com todos os problemas numa só mensagem.
  • Uma imagem que falta não é erro. Uma opção sem imagem não mostra nenhuma. O log de inicialização diz quantas opções têm imagem, por catálogo.
  • Onde aparecem. O imageUrl da API é a imagem, e as respostas REST também trazem a maior como imageLargeUrl. A ferramenta MCP deixa a maior de fora. Uma imagem no seu site é um caminho nas respostas REST e um endereço absoluto na ferramenta MCP. No editor, as imagens substituem as da plataforma onde quer que elas estariam: nos seletores, nos nós do canvas, nos cartões de entrada dos apps e no cartão Person. Um seletor que não desenha imagem da plataforma também não desenha as da implantação. Um tópico de Person ou Styling não é uma opção, então não tem imagem.

Os próprios arquivos de imagem da plataforma continuam sendo servidos: um arquivo em /picker-art/, ou uma renderização na CDN do Nodaro, ainda carrega para quem pedir o endereço dele. A API e o editor só deixam de citá-los.

As suas próprias imagens no seu site

Uma imagem de seletor registrada, e a imagem de exemplo de um dos seus pacotes de predefinições, pode ser um arquivo que você inclui na sua própria imagem e serve a partir do próprio site da instalação. Ela ganha versão junto com a sua versão do app e fica na mesma origem em todos os hosts que servem o app.

Para colocar os arquivos no site, copie-os, em uma imagem construída sobre a imagem do Nodaro, para o diretório a partir do qual o servidor web incluído serve o site, dentro de uma pasta sua:

FROM <the Nodaro image>
COPY brand/ /app/frontend/dist/brand/

Mantenha os arquivos nesse diretório. Um caminho que um arquivo em /etc/caddy/sites.d/ responde a partir de outro diretório é recusado na inicialização. Um arquivo assim ainda pode adicionar cabeçalhos para a pasta. Veja Servir outros apps no mesmo host.

Um caminho é aceito quando todas estas condições valem:

  • Ele começa com uma única / e não tem barra invertida, espaço em branco, caractere de controle, ? nem #.
  • Ele usa codificação percentual válida, sem barra nem barra invertida codificadas, e sem segmento vazio, . ou ...
  • Ele indica um arquivo dentro de uma pasta sua. A primeira pasta não pode ser uma que a plataforma usa: v1, .well-known, mcp, og, app, embed, present, storage, supabase, assets, picker-art, preset-previews, face-mesh-art, fonts, notifications, projects, demo-assets ou cdn-cgi, em maiúsculas ou minúsculas.
  • O nome do arquivo termina em .png ou .webp.

Um caminho também precisa de PUBLIC_URL definida com o endereço do próprio site, porque os clientes MCP o recebem como um endereço absoluto ali. Um caminho que quebra uma regra impede a inicialização, indicando a entrada e o problema. Quando o servidor vê o site compilado no próprio disco, como na imagem padrão, ele também confere se cada caminho indica um arquivo ali e impede a inicialização com todos os arquivos ausentes em uma só mensagem. Sem um site compilado, por exemplo em uma execução local de desenvolvimento, ele não confere nada e grava uma linha no registro.

  • As respostas REST trazem o caminho como foi registrado, então ele funciona em todos os hosts da instalação.
  • As ferramentas MCP get_picker_catalog, list_node_presets e get_node_preset o trazem como um endereço absoluto: em PUBLIC_URL ou, com o MCP por caminho, no host pelo qual o cliente se conectou.
  • O editor só mostra um caminho quando ele está na própria origem da página, e o desenha como foi informado.

O servidor web incluído envia um .png com um cabeçalho de cache imutável de um ano, e um .webp sem cabeçalho de cache. Dê a cada imagem um nome com hash do conteúdo, como cinematic.3f9a2c1e.webp, e um nome novo sempre que ela mudar, para que uma imagem substituída nunca seja servida desatualizada.

Idiomas oferecidos

locale.offered lista os idiomas que um visitante pode escolher, como IDs de localidade: ["he","en"]. O Nodaro os lê na grafia dele, então pt-br vira pt-BR. Toda lista de idiomas do editor passa a oferecer só esses: o seletor de idioma da barra lateral e a configuração de idioma no painel de configurações de um nó. Um idioma que já está na tela continua na lista, para que o usuário possa trocar para outro.

  • Um ID desconhecido é descartado com um aviso. Uma lista sem nenhum ID conhecido é ignorada, e todos os idiomas continuam oferecidos.
  • Um locale.default que a lista não inclui gera um aviso na inicialização.

Saídas privadas

Com "outputs":{"allowPublic":false}, toda saída é privada, seja qual for a escolha do usuário. Toda leitura que entrega o trabalho de uma pessoa a outra também responde como se nada fosse público:

  • As listagens não listam nada. Isso inclui a visão pública de GET /v1/gallery, as listagens da comunidade (navegação e favoritos), o marketplace de apps e componentes (GET /v1/apps/browse) e o marketplace de templates (GET /v1/templates/browse). Os dois marketplaces respondem { data: [], nextCursor: null }, incluindo as visões de favoritos. Também inclui o escopo público das ferramentas MCP browse_gallery, list_jobs, list_apps e list_components.
  • As páginas desse trabalho respondem 404 not_found. Isso inclui o cartão de uma publicação da comunidade, os detalhes completos dela e o clone dela. Também inclui um template que outra pessoa listou no marketplace, pela página (GET /v1/templates/:slug) e pelo clone (POST /v1/templates/:slug/clone), e a rota de denúncia da galeria. Um template do canal de tutoriais (GET /v1/tutorials) ainda pode ser lido e clonado por qualquer pessoa.
  • Os links compartilhados antes de você definir a chave param de funcionar para todos, menos para o dono. Um workflow lido por link (GET /v1/public/workflows/:id, que não exige login) responde como um workflow que não está compartilhado. A cópia editável dele, a partir de uma produção compartilhada, é recusada a quem não tem outro compartilhamento com ela. Uma tomada pública do Cine (GET /v1/shots/:id) é lida como privada. A configuração de compartilhamento continua como o dono a definiu. Só as leituras mudam.
  • Um app ou componente publicado é só de quem o criou. A página dele (GET /v1/app/:slug), o cartão de link e a incorporação respondem a qualquer outra pessoa como para um app que não existe. O mesmo vale para uma execução dele iniciada por outra pessoa: POST /v1/app/:slug/run, Restaurar, Tentar novamente e Render final, e as ferramentas MCP get_app_inputs, run_app e retry_app_run. As execuções antigas que uma pessoa fez do app de outra continuam legíveis, também com o get_app_run do MCP.
  • Um componente roda só para quem o criou. POST /v1/component/execute, o run_component e o get_component_inputs do MCP e o Executar este nó do editor no componente de outra pessoa respondem Component not found. Um componente colocado em um workflow continua rodando nas execuções completas desse workflow, seja quem for o dono.
  • A tarefa de outra pessoa pelo ID dela aparece como não encontrada. Isso inclui as ferramentas MCP get_asset e display_asset, os itens que list_favorites retorna e a adição de um favorito (POST /v1/gallery/favorite, MCP favorite_asset). Você só pode favoritar as suas próprias tarefas.

O trabalho marcado como público antes de você definir a chave, ou trazido numa cópia do banco de dados, também não é servido. A galeria, as tarefas, os apps, os componentes, os templates, as tomadas e os workflows compartilhados da própria pessoa não mudam para ela: GET /v1/apps/mine e GET /v1/templates/mine continuam listando os dela.

A chave não fecha estes:

  • Os links de compartilhamento da apresentação (/v1/present/:token), um recurso separado.
  • Um componente colocado em um workflow. Quem já sabe o nome de um componente ainda pode executá-lo colocando-o em um workflow próprio. Com todas as listagens fechadas, ninguém encontra um novo.
  • Os catálogos que um administrador organiza: os tutoriais, a prateleira Keepers, as tendências e a biblioteca compartilhada.
  • O endereço de um arquivo no seu armazenamento. Quem tem o endereço ainda pode ler o arquivo.

Palavras do provedor

Quando uma tarefa falha, a API pode trazer as próprias palavras do provedor sobre a falha. Elas aparecem como error_detail em uma tarefa, como errorDetail em um nó com falha de uma execução e no envelope de tarefa do MCP, e como providerReason na ferramenta MCP diagnose_run. Veja As palavras do próprio provedor.

jobs.errorDetail define quem as lê:

  • "owner" (o padrão, e o que significa a chave ausente): o dono da tarefa e os administradores.
  • "admin": só os administradores. Todos os outros leitores veem uma tarefa que falhou exatamente como uma sobre a qual o provedor não disse nada: error_detail é null, a entrada de um nó não tem errorDetail, e não há providerReason. As chaves continuam as mesmas, então nenhum cliente precisa mudar.

Qualquer outro valor, e um valor de jobs que não é um objeto, é lido como "admin", com um aviso. A chave fica no servidor e não é enviada ao navegador.

O servidor aplica a chave em toda superfície que traz as palavras:

  • As leituras de tarefas: GET /v1/jobs, GET /v1/jobs/:id, GET /v1/jobs/:id/status, GET /v1/jobs/status e POST /v1/jobs/batch-status.
  • Os estados dos nós de uma execução: GET /v1/workflow-executions/:id, a transmissão contínua dele, as listas de execuções e o status de execução de um workflow compartilhado.
  • As ferramentas MCP get_job, wait_for_job, list_jobs, get_asset e diagnose_run.
  • O evento de webhook job.failed. Um corpo registrado antes de você definir a chave também perde as palavras, em uma nova tentativa e no registro de entregas do endpoint.

Um administrador é uma conta com o papel admin ou super_admin. As leituras de tarefas e de execuções seguem o papel de uma conta com login no app. Assim, uma leitura pelo MCP, por um token de API pessoal ou pelo token de um app nunca é a de um administrador nelas. As leituras só para administradores mantêm as palavras, também com o próprio token de um administrador. Uma entrega de webhook nunca é a de um administrador.

Seja qual for a chave, as palavras só vão para um leitor que pode vê-las. As palavras de uma tarefa vão para o dono dela, nunca para outro usuário. As palavras de uma execução só vão para um leitor que pode abrir o workflow que a execução rodou, nunca para quem executa um app publicado ou o link de compartilhamento de outra pessoa.

A chave controla o que o servidor serve de uma tarefa e de uma execução. As palavras que um editor já salvou nos nós de um workflow ficam nesse workflow, e quem pode abrir o workflow as lê junto com ele. A cópia do workflow de um app publicado as deixa de fora.

Com "imports":{"links":false}, os usuários não podem importar mídia a partir de um link para outro site. O editor oculta os campos de link, e o servidor aplica a regra, seja o que for que um cliente envie. A importação de um link para outro site responde 403 link_imports_disabled, antes que qualquer tarefa ou download comece.

  • Valores aceitos. true, false, "true", "false", "1" e "0". O padrão é true. Qualquer outro valor, ou um valor de imports que não é um objeto, é lido como false.
  • O seu próprio armazenamento. Um arquivo no armazenamento da própria instalação não é um link para outro site e nunca é recusado.
  • O que a regra cobre. Toda importação a partir de um link. Isso inclui downloads de vídeo, áudio do YouTube, importações de imagens e de gravações, Salvar no armazenamento, processamento de mídia, Cortar áudio e Transcrever. Inclui também Cover com Suno e Estender upload com Suno com um link como origem, o sourceUrl de uma dublagem e a sondagem de mídia POST /v1/video-metadata. Num workflow, cobre o nó URL de vídeo e a mídia que uma importação de workflow copia. A importação de workflow continua dando certo e informa essa mídia como ignorada. As mesmas rotas pelo MCP, pelo SDK e pela CLI também são recusadas.
  • Toda chamada de ferramenta MCP. Uma chamada cujos argumentos trazem um link para qualquer coisa que não seja um arquivo do seu próprio armazenamento é recusada com 403 link_imports_disabled, antes de a ferramenta ser executada. Isso cobre uma imagem a editar, uma referência, um clipe, um som, uma página, um link nas entradas de um app, um plano de edição e a mídia de entrada de um workflow que um agente escreve ou importa. Um upload, um arquivo gerado, um ID de arquivo, um ID de tarefa e um ID de entidade continuam permitidos. Um link dentro de um prompt é texto e não é avaliado. Veja Ferramentas MCP.
  • Entradas de mídia dadas como links, fora do MCP. Uma rota pode receber a mídia de entrada como um link para outro site, por exemplo o imageUrl de POST /v1/generate-video ou o videoUrl de POST /v1/trim-video. Esse link segue a regra só onde imports.inputLinks determina (abaixo). Sem essa chave, esses links ainda chegam ao provedor ou à sua própria rede, então mantenha um filtro de rede para eles. O proxy de exibição de imagens não é coberto por nenhuma das duas chaves.

Com a importação por link desligada, imports.inputLinks decide o que acontece com a mídia que uma requisição recebe como link para outro site: uma imagem de referência, um clipe de origem, um som, uma máscara ou uma página a extrair.

{ "imports": { "links": false, "inputLinks": "report" } }
ValorO que acontece
"allow"O padrão. O link chega à busca do servidor ou ao provedor, como antes.
"report"Toda requisição segue como antes. Cada link que "refuse" recusaria é gravado no registro do servidor, só com o host, e em um relatório de administração.
"refuse"Recusado como uma importação, com o mesmo 403 link_imports_disabled, antes de qualquer coisa ser criada, reservada, buscada ou enviada a um provedor.
  • Qualquer outro valor é lido como "refuse", com um aviso. A chave não tem efeito enquanto imports.links não for false. Ela só existe no backend e nunca chega ao navegador.
  • O que é avaliado. Toda requisição de API com corpo é avaliada antes das etapas da própria rota. Todo nó que uma execução de workflow executa também é avaliado, incluindo as execuções de apps publicados, de componentes e de nós de caso de uso. Os campos são lidos pelo nome, como …Url, …Urls, …image, …video e …source. Um prompt, um ID e um endpoint para o qual a requisição envia dados, como um webhook, não são avaliados. Numa execução de workflow, o nó cuja entrada é recusada falha com link_imports_disabled antes de os créditos dele serem reservados.
  • O que é permitido. Um upload, um resultado gerado e qualquer outro arquivo do seu próprio armazenamento, e uma URI data:. Nenhuma requisição GET é avaliada.
  • Passe de "report" para "refuse" depois que "report" tiver funcionado tempo suficiente para cobrir o seu uso real, incluindo os workflows agendados. Leia os hosts que os relatórios indicam. Um host que é seu, como um host de mídia mais antigo, significa que esses arquivos não estão em R2_PUBLIC_URL, e todas as cadeias que os usam seriam recusadas.
  • O que "refuse" também bloqueia. Os tutoriais incluídos na edição Business e as sobreposições Lottie do catálogo incluído, cujos arquivos ficam na CDN do Nodaro. Os resultados que uma conta conectada do Nodaro Cloud guarda no próprio armazenamento, que são de outro site para a instalação. A mídia de extrações de redes sociais que não pôde ser copiada para dentro. Uma execução de workflow também recusa uma entidade salva antes da mudança com uma imagem de referência de outro site. Substitua esses arquivos por uploads antes de fazer a mudança.

Apps de desenvolvedor

developerApps.manage define quem pode criar, alterar, trocar o segredo e excluir um app de desenvolvedor, isto é, um cliente OAuth em /v1/developer-apps:

  • "owner" (o padrão, e o que vale quando a chave não existe): cada pessoa com login gerencia os próprios apps.
  • "admin": só um administrador da instalação, com a função admin ou super_admin, com login ou com um token de API pessoal. Qualquer outra pessoa recebe 403 developer_apps_admin_only, e o editor mostra um aviso no lugar das páginas de apps de desenvolvedor.

As pessoas ainda podem ler os próprios apps, e todo app criado antes da mudança continua funcionando, com os tokens dele. Qualquer outro valor, e um valor de developerApps que não é um objeto, é lido como "admin", com um aviso. O registro dinâmico de clientes MCP é uma configuração separada. Junto com MCP_ALLOWED_CLIENT_IDS, esta chave faz dos seus próprios clientes os únicos que podem fazer o login das pessoas: veja MCP só pelo seu próprio cliente.

Os seus próprios textos

strings troca textos da interface do editor pelos seus próprios, por idioma, sem recompilação:

"strings": {
  "flow": {
    "en": { "auth.tagline": "Visual workflows by Example Studio" },
    "he": { "auth.tagline": "תהליכים חזותיים של Example Studio" }
  }
}
  • Produto. O primeiro nível indica o produto. flow é o editor de workflows.
  • Chaves. As chaves são as próprias chaves de mensagem do editor. A compilação do editor as lista, sem o texto, em ui-strings-manifest.flow.json, ao lado do index.html. Toda chave cujo texto em inglês não está vazio pode ser trocada.
  • Idiomas. Uma substituição troca um texto num idioma. Uma substituição em en é também o inglês que um idioma sem tradução própria da chave usa no lugar dela.
  • Conferência. O contêiner confere cada entrada na inicialização, quando grava /config.js. Uma entrada que não passa numa conferência é descartada, com um aviso [surface-profile] strings… no registro. As outras entradas ficam, e uma entrada ruim nunca impede a instalação de iniciar.

Uma entrada é descartada quando:

  • A chave não é uma das chaves do editor.
  • O idioma não é oferecido: um de locale.offered ou, sem essa chave, um dos idiomas do editor, en, he, ja, ko e pt-BR.
  • O texto está vazio, tem mais de 1.000 caracteres ou não é texto simples. Texto simples não tem tag HTML, comentário nem referência de caractere como &amp;, porque o editor mostra o texto exatamente como foi escrito. Também não tem caractere de controle além da quebra de linha, nem caractere de incorporação ou de substituição bidirecional (U+202A a U+202E). As marcas e os isolamentos que o texto da direita para a esquerda usa são aceitos.
  • Os {placeholders} não são exatamente os do texto em inglês. Todo marcador continua e nenhum é acrescentado, mas a ordem pode mudar.

Limites de tamanho: as substituições de um produto podem ter no máximo 64 KiB de texto, senão o bloco inteiro é descartado. Se o perfil com todas as substituições passar de 120 KiB, todas as substituições são descartadas, e nada mais.

Os seus textos aparecem desde a primeira renderização do editor. As mensagens que o servidor envia e os nomes de nós, entradas e modelos não são chaves de mensagem e não são cobertos. Uma atualização pode remover ou renomear uma chave. A sua substituição para ela é então descartada com um aviso, então leia o registro da inicialização depois de cada atualização.

A marca no cabeçalho da página

Na partida, logo depois de gravar /config.js, o contêiner grava a sua marca no index.html compilado. Os mecanismos de busca, as prévias de link e a aba do navegador passam a mostrá-la antes que qualquer script rode:

  • <title> recebe brand.productName, a menos que ele seja Nodaro.
  • <meta name="description"> recebe brand.description.
  • Os links de ícone recebem brand.favicon: um caminho no seu site, ou uma lista de até quatro, como ["/brand/favicon.svg", "/brand/favicon.png"]. Cada caminho vira um <link rel="icon">, com o tipo tirado da extensão, e todo link de ícone da plataforma é removido, inclusive o ícone da tela inicial.

Observações:

  • Só caminhos. Um caminho para outro site (https://… ou //…), ou um caminho com espaços, aspas ou sinais de menor e maior, é descartado com um aviso.
  • Inclua os arquivos você mesmo, na sua camada de arquivos estáticos. Dê a eles nomes com versão, porque as imagens estáticas ficam em cache por um ano.
  • productName é obrigatório. Um bloco brand sem productName é ignorado por inteiro.
  • O resto do arquivo fica como foi compilado. Se o arquivo perdeu um dos três, por exemplo não tem <title> ou tem duas descrições, o contêiner o deixa como foi compilado e registra [start.sh] brand head NOT applied: …. Sem marca definida, o arquivo não é gravado.
  • Uma requisição do próprio /favicon.ico, que alguns rastreadores enviam, continua recebendo o ícone da plataforma.
  • O cabeçalho é gravado a cada partida do contêiner. Cada contêiner novo começa de novo a partir do arquivo compilado.

Uma instalação com o hebraico em primeiro lugar, com nome, descrição, ícones e frase da tela de login próprios:

NODARO_SURFACE_PROFILE={"brand":{"productName":"Example Studio","description":"Workflows by Example Studio","favicon":["/brand/favicon.svg","/brand/favicon.png"]},"locale":{"default":"he","offered":["he","en"]},"strings":{"flow":{"en":{"auth.tagline":"Visual workflows by Example Studio"},"he":{"auth.tagline":"תהליכים חזותיים של Example Studio"}}}}

Perguntas frequentes

Como mudo um Nodaro auto-hospedado da Community para a Business?

Defina EDITION como business e o argumento de compilação VITE_EDITION como business no serviço nodaro do docker-compose.community.yml. Depois, compile a imagem a partir do código-fonte e inicie-a. O banco de dados não precisa de nenhuma alteração.

Por que preciso recompilar a imagem para mudar a edição?

O editor lê a edição dele quando a imagem é compilada, e a imagem publicada é compilada como Community Edition. A API lê EDITION na inicialização, mas o app no navegador só mostra o painel de administração em uma compilação Business.

O que é um perfil de superfície?

Uma configuração em JSON, NODARO_SURFACE_PROFILE, que restringe o que uma instalação Business ou Cloud mostra, sem recompilar. Ela pode ocultar itens da barra lateral e seções da tela inicial, remover nós e modelos, renomear o produto, restringir os métodos de login e forçar as saídas a serem privadas.

A Community Edition lê NODARO_SURFACE_PROFILE?

Não. A Community Edition ignora a variável e sempre mostra a interface completa. Defina EDITION=business para usar um perfil de superfície.

Um perfil de superfície pode ativar um recurso que a edição não tem?

Não. Um perfil só pode restringir. Ele nunca ativa algo que a edição desativa.

Posso trocar os textos do editor numa instalação auto-hospedada?

Sim, na edição Business. A chave strings do perfil de superfície troca textos da interface por idioma, sem recompilação. O contêiner confere cada entrada na inicialização e descarta uma entrada inválida com um aviso no registro.

Última atualização

Nesta página