A ideia#
O servidor roda em um de dois modos, e o endereço ao qual ele se vincula decide qual. Ambos os modos protegem os seus projetos; diferem em quem é confiável.
Modo local#
O servidor se vincula a 127.0.0.1 ou ::1, então apenas o seu computador consegue alcançá-lo. Este é o padrão e o que o vukem-video serve faz.
- Não há login. Na primeira inicialização, o servidor cria um token local aleatório no espaço de trabalho, em um arquivo legível apenas por você. A CLI e o servidor MCP stdio o leem de lá.
- "Sem login" não é "sem proteção". Qualquer página web que você abre pode enviar requisições para
127.0.0.1, então o servidor também confere oHoste oOriginde cada requisição e recusa o que não vem do editor ou de um cliente que tenha o token. - Toda operação registra um ator, como
local:claude-codepara um agente oulocal:uipara o editor. O histórico mostra quem mudou o quê. - Esvaziar a lixeira só é aceito pelo editor no navegador, nunca pelo token que um agente tem.
Modo de rede#
O servidor se vincula a qualquer outro endereço, para compartilhá-lo com outras pessoas ou executá-lo em um servidor. Vincular a um endereço que não é de loopback sem a configuração do modo de rede é um erro de inicialização, nunca uma exposição silenciosa.
- O login é obrigatório. Não há cadastro aberto: o operador cria os usuários pela linha de comando, e cada projeto pertence ao usuário que o criou.
- O acesso programático usa chaves de API que um usuário autenticado cria. Uma chave tem escopos (
read,edit,media,render,admin) e pode ser limitada a um projeto. - O TLS é obrigatório, diretamente ou por um proxy reverso. A única exceção é um contêiner na sua própria máquina com a porta publicada para o loopback.
- A importação por caminho fica confinada às raízes de importação que o operador configura.
O ator de uma operação é user:<id> ou key:<id>. Os limites são por espaço de trabalho e por chave.
De qual preciso?#
| Você quer | Use |
|---|---|
| Editar no seu próprio computador, com ou sem um agente | Modo local |
| Executá-lo em um contêiner na sua própria máquina | Modo local, com a porta publicada em 127.0.0.1 |
| Compartilhar um servidor com uma equipe | Modo de rede |
Erros comuns#
- Publicar a porta do contêiner em todas as interfaces sem o modo de rede. Publique-a apenas em
127.0.0.1. - Colocar uma chave em uma URL. Um token ou uma chave só é aceito em um cabeçalho e nunca é registrado em log nem devolvido.