Corrigir erros do servidor de licenças V-Ray (2026)

Os erros do servidor de licenças V-Ray podem paralisar o pipeline de renderização. Já encontrámos quase todas as variantes destes erros na infraestrutura da nossa render farm, desde falhas de dongles de hardware a conflitos de licenciamento em rede. Este guia abrange tanto o licenciamento legado baseado em dongle como a abordagem mais recente de licenciamento online baseado em conta Chaos Cloud, que serve de base ao V-Ray 6 e 7.

Compreender a arquitetura do servidor de licenças V-Ray

O servidor de licenças V-Ray (vrlservice.exe no Windows, vrlservice no Linux/macOS) gere o modo como o V-Ray acede ao seu licenciamento. Quer se utilize um dongle físico WIBU-KEY, um Chaos License Server local ou o licenciamento online baseado em conta Chaos, o servidor coordena as verificações de permissões e valida a licença.

Na nossa render farm, gerimos licenças em vários nós de renderização — alguns com dongles legados, outros ligados a servidores de licenças partilhados e a nossa infraestrutura mais recente com licenciamento baseado em conta Chaos. Cada abordagem tem modos de falha e passos de recuperação diferentes.

O erro «No License for This Product» explicado

Quando o V-Ray apresenta «vray no license for this product error» ou mensagens semelhantes, isso significa normalmente uma de três coisas: o servidor de licenças não arrancou, o dongle não é reconhecido ou o servidor de licenças não consegue contactar a origem de autenticação.

A falha de arranque do vrlservice.exe é a causa principal. O serviço tenta arrancar quando o V-Ray é inicializado e, se falhar, os erros de licenciamento surgem de imediato. Ao contrário de algum software que recorre a um modo alternativo de forma gradual, o V-Ray interrompe-se por completo — sem modo de avaliação e sem funcionalidade reduzida.

Licenciamento por dongle: resolução de problemas do sistema legado

Se estiver a utilizar o V-Ray 6 ou anterior com um dongle WIBU-KEY, comece aqui.

Passo 1: verificar a ligação do dongle

Inspecione fisicamente o dongle USB. Confirme que está bem encaixado numa porta USB. Mude-o para outra porta USB 2.0 — as portas USB 3.0 causam por vezes problemas de reconhecimento com dongles mais antigos.

Evite encadear dongles em série ou ligá-los através de hubs sem alimentação. Para testes, utilize uma ligação direta ao conector USB da placa-mãe do anfitrião, não a uma porta do painel frontal.

Passo 2: atualizar os controladores WIBU-KEY

O controlador WIBU-KEY é o que permite ao sistema reconhecer o dongle físico. Um controlador desatualizado ou corrompido é a causa mais comum dos erros «dongle not found».

Primeiro, desinstale por completo o controlador WIBU-KEY. No Windows, abra o Device Manager (devmgmt.msc), localize o WIBU-KEY em «Universal Serial Bus controllers», clique com o botão direito e selecione «Uninstall device». Marque a caixa para remover o software do controlador.

Reinicie o sistema por completo. Depois de reiniciar, visite wibu.com e transfira o controlador WIBU-KEY mais recente para a versão do sistema operativo em uso. Instale-o de raiz. Reinicie novamente.

No Linux e no macOS, pode ser necessário descarregar da memória o módulo do kernel:

sudo kextunload -b com.wibu.CodeMeter

Depois, transfira e instale o software WIBU-KEY mais recente a partir do portal de suporte da Chaos.

Passo 3: verificar o reconhecimento no Device Manager

No Device Manager, expanda «Universal Serial Bus controllers». O WIBU-KEY deve aparecer como «WIBU-KEY» ou «CodeMeter» (a tecnologia subjacente). Se surgir um ponto de exclamação amarelo ou «Unknown Device», a instalação do controlador falhou.

Repita o Passo 2 ou contacte o suporte da Chaos se a instalação do controlador indicar um código de erro.

Passo 4: verificar o ficheiro de licença no dongle

Se o dongle for reconhecido mas o V-Ray continuar a indicar licenças em falta, o ficheiro de licença guardado no dongle pode estar corrompido ou em falta.

Algumas instalações ainda utilizam a antiga ferramenta «License Medic» (agora descontinuada). Em vez disso, utilize o software Chaos License Server para ler e validar o conteúdo do dongle. No Windows, também é possível verificar através do painel de definições do V-Ray: render settings > System > License Server > Manual License Server Setup.

Migração do V-Ray 6 para o V-Ray 7: alterações no licenciamento

Quem migrar do V-Ray 6 para o V-Ray 7 deve ter em conta que a Chaos alterou profundamente o funcionamento do licenciamento. O V-Ray 7 deixou de suportar dongles WIBU-KEY físicos em novas instalações.

O V-Ray 7 requer:

Um Chaos License Server (um servidor de licenças local, baseado em software, que comunica com a nuvem da Chaos)
Licenciamento online baseado em conta Chaos (autenticação direta na conta Chaos)

Ao atualizar nós de renderização que utilizavam dongles, existem dois caminhos:

Caminho A: configurar um Chaos License Server na rede. Este servidor liga-se uma vez à nuvem da Chaos e depois guarda as licenças em cache localmente. Os nós de renderização ligam-se a este servidor (porta 30304 por predefinição). Esta abordagem funciona mesmo que os nós de renderização percam temporariamente a ligação à internet.

Caminho B: configurar o V-Ray 7 com as credenciais diretas da conta Chaos. Cada nó de renderização autentica-se de forma independente na nuvem da Chaos. Isto exige que todos os nós consigam aceder à internet ou a um proxy.

Optámos pelo Caminho A na nossa render farm porque temos interrupções de rede ocasionais e o modelo de licenças em cache é mais resiliente.

Configuração do Chaos License Server (preferível para render farms)

O Chaos License Server é o substituto moderno tanto dos dongles físicos como do software de servidor de licenças mais antigo.

Transfira o Chaos License Server a partir do portal de documentação da Chaos. É um único executável — cslserver.exe no Windows.

No anfitrião do servidor de licenças, execute-o com privilégios elevados:

cslserver.exe

Por predefinição, escuta na porta 30304. Confirme que esta porta está aberta entre o servidor de licenças e todos os nós de renderização.

Gere ou importe as credenciais Chaos para o License Server. São necessários o e-mail da conta Chaos e uma chave de licença ou um ID de subscrição.

Em cada nó de renderização, configure o V-Ray para se ligar ao License Server. Nas definições de licenciamento da Chaos, defina:

License Server: <your-server-ip>:30304

Reinicie o vrlservice. Teste iniciando o V-Ray num nó de renderização.

Conflitos de portas e regras de firewall

A porta 30304 é a porta predefinida do Chaos License Server. Se surgirem erros «connection refused» ou mensagens «port already in use», algum outro serviço está a ocupar a porta.

Verifique o que está a escutar na porta 30304:

No Windows (executar como administrador):

netstat -ano | find ":30304"

No Linux/macOS:

lsof -i :30304

Se outro serviço ocupar a porta, pare esse serviço ou reconfigure o Chaos License Server para utilizar outra porta (definida no ficheiro de configuração do cslserver).

Quanto às regras de firewall: confirme que os nós de renderização conseguem aceder ao servidor de licenças na porta 30304 (TCP). Se a render farm abranger várias sub-redes, verifique se as ACL de rede permitem esse tráfego. Mantemos uma regra de firewall interna chamada «SRF_License_Server_Access» que permite a todos os nós de renderização aceder ao nosso servidor de licenças principal.

Numa firewall empresarial, adicione os intervalos de IP da nuvem da Chaos à lista de permissões. A Chaos publica esses intervalos na documentação.

Licenciamento online: método direto por conta Chaos

Em alternativa, o V-Ray 7 suporta a autenticação direta com conta Chaos, sem um License Server local.

Crie uma conta Chaos e adquira uma subscrição do V-Ray. Durante a instalação do V-Ray ou nas definições de renderização, selecione «Cloud Authorization» e introduza as credenciais Chaos.

O V-Ray autentica-se na nuvem da Chaos sempre que arranca. Cada nó de renderização precisa de acesso à internet (ou de acesso por proxy) aos endpoints da nuvem da Chaos.

Para render farms, esta abordagem é mais simples de implementar — não requer infraestrutura de License Server separada. No entanto, é menos tolerante a falhas se a ligação à internet cair durante a renderização.

Licenciamento em Docker e máquinas virtuais

Ao executar o V-Ray em contentores Docker ou em máquinas virtuais, o licenciamento comporta-se de forma ligeiramente diferente.

Nos contentores Docker, os dispositivos USB do anfitrião (dongles) têm de ser passados para o contentor. Nesse caso, confirme que o contentor é executado com privilégios suficientes:

docker run --privileged --device /dev/bus/usb ...

O controlador WIBU-KEY tem de estar instalado no sistema operativo anfitrião, não dentro do contentor.

Nas VMs, os dongles físicos podem ser passados através de redirecionamento USB, mas isso introduz latência e instabilidade. A maioria das render farms de grande escala evita a passagem USB. Em vez disso, utiliza-se o Chaos License Server em execução no anfitrião, com as VMs a ligarem-se a ele pela rede.

O Chaos License Server (baseado em rede) funciona sem problemas em VMs, por ser uma ligação TCP/IP padrão. Não é necessária passagem de hardware.

Licenciamento em render farms: como os serviços geridos tratam este assunto

Na nossa render farm, o licenciamento dos nós de renderização está incluído no custo — as licenças não têm de ser geridas por quem utiliza o serviço. Mantemos uma infraestrutura redundante de Chaos License Server com failover. Se um servidor ficar indisponível, o conjunto de nós de renderização muda automaticamente para um servidor de reserva.

A Super Renders Farm é um parceiro oficial da Chaos Group para o V-Ray — o licenciamento dos nós de renderização é gerido de forma centralizada ao abrigo desse acordo de parceria, razão pela qual as falhas de dongle, os conflitos de portas e as falhas de controlador descritos acima são problemas que resolvemos nós, e não algo que seja configurado em cada nó.

Para quem gere a sua própria infraestrutura de render farm aplica-se o mesmo princípio: implemente os License Servers com redundância. Execute um servidor principal e pelo menos um em hot standby. Teste o failover regularmente.

Também monitorizamos continuamente o estado do servidor de licenças. Se o servidor ficar inacessível, alertamos de imediato. Numa render farm independente, configure uma monitorização semelhante — não aguarde que um trabalho de renderização falhe para descobrir que o servidor de licenças está em baixo.

Integração com o Chaos Cloud e licenciamento baseado em conta

O Chaos Cloud é a plataforma nativa de renderização na nuvem da Chaos. Ao utilizar o Chaos Cloud, ou ao ponderá-lo, o licenciamento é tratado inteiramente através da conta Chaos.

No Chaos Cloud, as licenças V-Ray são medidas por consumo. A cobrança é feita por hora de renderização ou por trabalho concluído, e não por nó. Este modelo elimina a necessidade de gerir licenças por nó, uma vez que a plataforma na nuvem distribui as licenças de forma centralizada.

Ao integrar o Chaos Cloud com uma render farm no local, é possível utilizar ambos: nós no local com um Chaos License Server local e cloud bursting através do Chaos Cloud. Cada sistema autentica-se de forma independente.

Resolução de conflitos de portas em configurações de elevada concorrência

Com muitos nós de renderização e processos vrlservice, pode ocorrer esgotamento de portas efémeras. Manifesta-se como erros «connection refused» esporádicos que parecem aleatórios.

O problema: cada processo vrlservice precisa de uma porta para escutar. Com centenas de nós de renderização a reiniciar em simultâneo (após uma falha de energia, por exemplo), o intervalo de portas efémeras do sistema operativo pode esgotar-se.

No Linux, aumente o intervalo de portas efémeras:

sysctl -w net.ipv4.ip_local_port_range="1024 65535"

No Windows, é possível ajustar as definições do registo (consulte o suporte da Chaos para as entradas HKEY_LOCAL_MACHINE específicas).

Uma alternativa mais simples: escalonar os reinícios dos nós de renderização. Reinicie os nós em lotes de 10–20 a cada poucos minutos, em vez de todos de uma vez.

Passos de verificação depois de corrigir os erros de licenciamento

Depois de aplicar qualquer correção, verifique se o servidor de licenças do V-Ray está a funcionar:

Abra um terminal e execute:
```
vrlservice --status
```
(ou verifique o processo vrlservice no Task Manager / Activity Monitor)
Abra o V-Ray e consulte Settings > System > License. Deve aparecer «Licensed» e o tipo de licença (dongle, servidor ou conta na nuvem).
Com um License Server, execute um teste rápido a partir de um nó de renderização:
```
vrlcontrol --server <license-server-ip> --status
```
Submeta um trabalho de renderização de teste em pelo menos um nó de renderização.

Estas verificações confirmam que a cadeia de licenciamento está intacta, desde a origem de autenticação até ao motor de renderização.

FAQ

Q: Aparece «License Server not responding», mas o servidor está a funcionar. O que se passa? A: Verifique a conectividade de rede entre o nó de renderização e o servidor de licenças. Confirme que o IP e a porta estão corretos. Confirme que a firewall permite a porta 30304 (ou a porta configurada). Numa VPN, certifique-se de que a sub-rede da VPN consegue aceder ao servidor de licenças. Execute ping <license-server-ip> a partir do nó de renderização. Se o ping falhar, trata-se de um problema de rede, não de licenciamento.

Q: Posso usar um dongle WIBU-KEY antigo com o V-Ray 7? A: Não. O V-Ray 7 removeu o suporte a dongles. É necessário utilizar o Chaos License Server ou o licenciamento online baseado em conta Chaos. Quem tiver licenças WIBU-KEY existentes deve contactar a Chaos sobre um programa de migração ou de troca de licenças.

Q: A nossa render farm não tem internet. Como licenciar o V-Ray 7? A: Utilize o Chaos License Server. O License Server liga-se uma vez à nuvem da Chaos para validar e guardar em cache as licenças. Depois disso, os nós de renderização ligam-se apenas ao License Server local — sem necessidade de internet. O anfitrião do License Server tem de ter acesso à internet, mas os nós de renderização não. No entanto, as licenças são atualizadas periodicamente (consulte a documentação da Chaos para saber o intervalo de atualização), pelo que períodos offline prolongados podem provocar a expiração da licença.

Q: É necessária uma licença separada para cada nó de renderização? A: Não. Numa render farm, adquirem-se normalmente uma ou mais licenças nomeadas, que o License Server gere e distribui pelos nós de renderização. Cada trabalho de renderização em simultâneo consome uma licença. Os nós de renderização inativos não consomem licenças. Consulte o contacto de licenciamento na Chaos para saber qual o nível de licença adequado ao número de nós.

Q: Porque é que o vrlservice.exe falha ao arrancar? A: Normalmente deve-se ao controlador (um controlador WIBU-KEY antigo) ou a permissões (a conta de serviço não tem privilégios suficientes). No Windows, confirme que o serviço é executado como Local System ou com uma conta de utilizador com direitos administrativos completos. Transfira e instale novamente o software WIBU-KEY ou Chaos License Server mais recente. Consulte os registos de falha do serviço no Event Viewer.

Q: Posso executar vários Chaos License Servers para failover? A: Sim, e recomendamo-lo. Configure um como principal e os restantes como secundários. Os nós de renderização podem ser configurados para tentar primeiro o principal e recorrer aos servidores secundários se o principal estiver inacessível. A configuração exata depende da documentação atual da Chaos, por isso convém confirmar com a equipa de suporte da Chaos para a versão em uso.

Passos seguintes

Se estes passos de resolução de problemas não resolverem a situação, reúna os elementos seguintes e contacte o suporte da Chaos:

Os números de versão do V-Ray e do License Server
As mensagens e os códigos de erro (dos registos e da interface)
O sistema operativo e a arquitetura do sistema (Windows 10/11, Ubuntu 20.04, etc.)
A topologia de rede (no local, na nuvem, híbrida)
Quaisquer alterações recentes (atualizações de controladores, patches do sistema operativo, alterações de rede)

Para render farms que utilizem os nossos serviços na SuperRenders Farm, a nossa equipa de suporte consegue frequentemente resolver problemas de licenciamento sem os escalar para a Chaos. Temos visibilidade aprofundada da nossa própria infraestrutura de License Server e conseguimos diagnosticar rapidamente problemas ao nível dos nós.