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
| Community | Business | Cloud | |
|---|---|---|---|
| Pode ser auto-hospedada | Sim | Sim | Não, gerenciada pelo Nodaro |
| Painel de administração | Não | Sim | Sim |
| Gerenciamento de usuários | Não | Sim | Sim |
| Registro de créditos | Não | Não | Sim |
| Cobrança | Não | Não | Sim |
| Preços de crédito definidos por administradores | Não | Não | Sim |
| Perfil de superfície | Ignorado | Sim | Sim |
- 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: communityAs 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 -dAtualize 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ção | O que faz | Padrão |
|---|---|---|
VITE_STUDIO_URL | O endereço do app Studio, para os links Abrir no Studio | https://studio.nodaro.ai |
VITE_PERSON_URL | O endereço do app Person, para o cartão Abrir Person da tela inicial | https://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.jsonpara 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
| Campo | O que faz |
|---|---|
nav.hide | Oculta 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.tabs | Uma única lista de permissões ordenada das seções da tela inicial. Veja Seções da tela inicial. |
nodes.deny, models.deny | Tipos 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.allow | Listas 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.ssoLabel | Os métodos de login a oferecer: email, google, sso. sso é descartado, a menos que auth.ssoLabel esteja definido. Veja Métodos de login. |
siblings.apps | Substitui os links do Nodaro no seletor de produtos: [{ "label": "...", "url": "..." }]. |
brand.productName | Substitui 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.wordmark | Texto 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.description | Substitui a meta description da página. |
brand.favicon | O ícone do navegador: um caminho no seu site, ou uma lista de até quatro. Veja A marca no cabeçalho da página. |
brand.platformLinks | false 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.default | O idioma em que um novo visitante começa. |
locale.picker | false oculta o seletor de idioma. O padrão é true, também quando você omite a chave ao lado das outras chaves de locale. |
locale.offered | Os idiomas que um visitante pode escolher, como IDs de localidade, por exemplo ["he","en"]. Veja Idiomas oferecidos. |
outputs.allowPublic | false 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.errorDetail | Quem lê as próprias palavras do provedor sobre uma tarefa que falhou: "owner" (o padrão) ou "admin". Veja Palavras do provedor. |
imports.links | false 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. |
strings | Os seus próprios textos para a interface do editor, por idioma. Veja Os seus próprios textos. |
voice.allowedGenders | Restringe as vozes a qualquer subconjunto de male, female e neutral. Vazio significa todos os gêneros. Veja Gêneros de voz. |
features.hide | Desativa 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.manage | Quem 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. Semtemplatesetutorials, 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áticomcpdele.
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-noteepreview, nunca são removidos por ficarem de fora de uma lista de permissões. Só umdenyexplí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 com403 model_not_available, na execução e emPOST /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-2quando 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õesV4_5PLUS,V4_5ALLeV4_5do Suno. - O modelo de um personagem treinado (
flux-lora-character). Nenhum menu,GET /v1/modelsoulist_modelsdo 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óprioflux-lora-characteré recusada com403 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-remakee as rotas dele, e toda execução de tendência.POST /v1/trends/:slug/estimatee/runsrespondemnode_not_availableonde ele não é oferecido.film-pipelineé o pipeline de filme (História → vídeo, Nodaro Cloud). Onde ele não é oferecido,POST /v1/pipelinese toda rota de pipeline que inicia ou continua trabalho respondem403 node_not_available, antes de qualquer reserva. Ler um pipeline, mudar uma execução para manual ePOST /v1/pipelines/:id/cancelcontinuam 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 comnode_not_available, e a reserva não gasta é reembolsada. Um pipeline pausado em uma etapa de aprovação continua pausado. As ferramentas MCPstart_pipeline,branch_pipeline,chat_pipeline_stageeapply_chat_proposalnã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/rune as ferramentas MCPcreate_explainerecreate_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émtext-to-speech,forced-alignmenterender-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-pipelineevideo-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_audioecapture_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/dubbinge 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
imageUrlouimageSrcSet, nenhum tópico de Pessoa ou Figurino e beleza trazimageUrl, e todoimageCountdo diretório é0. Isso vale paraGET /v1/picker-catalogs,GET /v1/picker-catalogs/:nodeType,GET /v1/catalogse a ferramenta MCPget_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çohttpsno 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
imageUrlda API é a imagem, e as respostas REST também trazem a maior comoimageLargeUrl. 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-assetsoucdn-cgi, em maiúsculas ou minúsculas. - O nome do arquivo termina em
.pngou.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_presetseget_node_preseto trazem como um endereço absoluto: emPUBLIC_URLou, 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.defaultque 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 MCPbrowse_gallery,list_jobs,list_appselist_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 MCPget_app_inputs,run_apperetry_app_run. As execuções antigas que uma pessoa fez do app de outra continuam legíveis, também com oget_app_rundo MCP. - Um componente roda só para quem o criou.
POST /v1/component/execute, orun_componente oget_component_inputsdo MCP e o Executar este nó do editor no componente de outra pessoa respondemComponent 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_assetedisplay_asset, os itens quelist_favoritesretorna e a adição de um favorito (POST /v1/gallery/favorite, MCPfavorite_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 temerrorDetail, 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/statusePOST /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_assetediagnose_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.
Importação por link
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 deimportsque não é um objeto, é lido comofalse. - 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
sourceUrlde uma dublagem e a sondagem de mídiaPOST /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
imageUrldePOST /v1/generate-videoou ovideoUrldePOST /v1/trim-video. Esse link segue a regra só ondeimports.inputLinksdetermina (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.
Entradas de mídia dadas como links
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" } }| Valor | O 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 enquantoimports.linksnão forfalse. 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,…videoe…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 comlink_imports_disabledantes 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çãoGETé 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 emR2_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çãoadminousuper_admin, com login ou com um token de API pessoal. Qualquer outra pessoa recebe403 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 doindex.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.offeredou, sem essa chave, um dos idiomas do editor,en,he,ja,koept-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
&, 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>recebebrand.productName, a menos que ele sejaNodaro.<meta name="description">recebebrand.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 blocobrandsemproductNameé 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.
Páginas relacionadas
Primeiro usuário e administrador
Configuração
Login único (SSO)
Licença
Edições
Última atualização
Primeiro usuário e administrador
Crie o primeiro usuário de um Nodaro auto-hospedado e promova um administrador na Business edition com um comando SQL, com ou sem o painel do Supabase.
Configuração
Todas as variáveis de ambiente de um Nodaro auto-hospedado, por finalidade, com o padrão, se o .env pode defini-las no Compose e o que elas mudam.