Errori license server V-Ray e avvio non riuscito (2026)

Gli errori del license server V-Ray possono bloccare l'intera pipeline di rendering. Nella nostra infrastruttura abbiamo incontrato quasi ogni variante di questi errori, dai guasti dei dongle hardware ai conflitti di licenza di rete. Questa guida copre sia il vecchio sistema basato su dongle sia il più recente approccio con licenza legata all'account Chaos Cloud, su cui si basano V-Ray 6 e 7.

Come funziona l'architettura del license server V-Ray

Il license server V-Ray (vrlservice.exe su Windows, vrlservice su Linux/macOS) gestisce il modo in cui V-Ray accede alla licenza. Che tu stia usando un dongle fisico WIBU-KEY, un Chaos License Server locale o la licenza online legata all'account Chaos, il server si occupa di verificare i permessi e di convalidare la licenza.

Sulla nostra render farm gestiamo le licenze su più nodi di rendering: alcuni usano dongle legacy, altri sono collegati a license server condivisi, mentre la nostra infrastruttura più recente usa la licenza legata all'account Chaos. Ogni approccio ha modalità di guasto e procedure di ripristino diverse.

L'errore "No License for This Product" spiegato

Quando V-Ray segnala "vray no license for this product error" o messaggi simili, di solito significa una di queste tre cose: il license server non si è avviato, il dongle non viene riconosciuto oppure il license server non riesce a raggiungere la fonte di autenticazione.

Il mancato avvio di vrlservice.exe è la causa principale. Il servizio tenta di avviarsi quando V-Ray si inizializza e, se fallisce, vedrai subito errori di licenza. A differenza di altri software che ripiegano in modo graduale, V-Ray si ferma di colpo: niente modalità di prova, niente funzionalità ridotte.

Licenza con dongle: risoluzione dei problemi del sistema legacy

Se usi V-Ray 6 o una versione precedente con un dongle WIBU-KEY, parti da qui.

Passo 1: verifica il collegamento del dongle

Controlla fisicamente il dongle USB. Assicurati che sia inserito saldamente in una porta USB. Spostalo su una porta USB 2.0 diversa: le porte USB 3.0 a volte causano problemi di riconoscimento con i dongle più vecchi.

Evita di collegare più dongle in cascata o di usare hub non alimentati. Se stai facendo un test, usa un collegamento diretto al connettore USB della scheda madre dell'host, non una porta del pannello frontale.

Passo 2: aggiorna i driver WIBU-KEY

Il driver WIBU-KEY permette al sistema di riconoscere il dongle fisico. Un driver obsoleto o danneggiato è la causa più comune degli errori "dongle not found".

Per prima cosa, disinstalla completamente il driver WIBU-KEY. Su Windows, apri Device Manager (devmgmt.msc), individua WIBU-KEY sotto Universal Serial Bus controllers, fai clic con il pulsante destro e seleziona "Uninstall device". Spunta la casella per rimuovere anche il software del driver.

Riavvia completamente il sistema. Dopo il riavvio, visita wibu.com e scarica l'ultimo driver WIBU-KEY per la tua versione del sistema operativo. Installalo da zero. Riavvia di nuovo.

Su Linux e macOS potrebbe essere necessario rimuovere il modulo del kernel dalla memoria:

sudo kextunload -b com.wibu.CodeMeter

Poi scarica e installa l'ultimo software WIBU-KEY dal portale di supporto di Chaos.

Passo 3: controlla il riconoscimento in Device Manager

In Device Manager, espandi "Universal Serial Bus controllers". Il tuo WIBU-KEY dovrebbe comparire come "WIBU-KEY" o "CodeMeter" (la tecnologia sottostante). Se vedi un punto esclamativo giallo o "Unknown Device", l'installazione del driver non è riuscita.

Ripeti il Passo 2 oppure contatta il supporto Chaos se l'installazione del driver segnala un codice di errore.

Passo 4: verifica il file di licenza sul dongle

Se il dongle viene riconosciuto ma V-Ray continua a segnalare licenze mancanti, il file di licenza memorizzato sul dongle potrebbe essere danneggiato o assente.

Alcune strutture usano ancora il vecchio strumento "License Medic" (ormai deprecato). Usa invece il software Chaos License Server per leggere e convalidare il contenuto del dongle. Su Windows puoi controllare anche dal pannello Settings di V-Ray: render settings > System > License Server > Manual License Server Setup.

Migrazione da V-Ray 6 a V-Ray 7: cosa cambia nelle licenze

Se stai passando da V-Ray 6 a V-Ray 7, tieni presente che Chaos ha cambiato radicalmente il funzionamento delle licenze. V-Ray 7 non supporta più i dongle fisici WIBU-KEY per le nuove installazioni.

V-Ray 7 richiede una delle due soluzioni seguenti:

Un Chaos License Server (un license server locale basato su software che comunica con il cloud di Chaos)
La licenza online legata all'account Chaos (autenticazione diretta al tuo account Chaos)

Se stai aggiornando nodi di una render farm che usavano i dongle, hai due strade:

Percorso A: configura un Chaos License Server sulla tua rete. Questo server si collega al cloud di Chaos una sola volta, poi memorizza le licenze in locale. I nodi di rendering si collegano a questo server (porta 30304 per impostazione predefinita). Questo approccio funziona anche se i nodi di rendering perdono temporaneamente la connessione a internet.

Percorso B: configura V-Ray 7 con le credenziali dirette dell'account Chaos. Ogni nodo di rendering si autentica in modo indipendente al cloud di Chaos. Questo richiede che tutti i nodi raggiungano internet o un proxy.

Sulla nostra render farm siamo passati al Percorso A perché abbiamo interruzioni di rete occasionali e il modello con licenze in cache è più resiliente.

Configurazione del Chaos License Server (soluzione consigliata per le render farm)

Il Chaos License Server è il sostituto moderno sia dei dongle fisici sia del vecchio software per license server.

Scarica il Chaos License Server dal portale di documentazione di Chaos. È un singolo eseguibile: cslserver.exe su Windows.

Sull'host del license server, eseguilo con privilegi elevati:

cslserver.exe

Per impostazione predefinita rimane in ascolto sulla porta 30304. Assicurati che questa porta sia aperta tra il license server e tutti i nodi di rendering.

Genera o importa le tue credenziali Chaos nel License Server. Ti serviranno l'email del tuo account Chaos e una chiave di licenza o un ID di abbonamento.

Su ogni nodo di rendering, configura V-Ray per collegarsi al tuo License Server. Nelle impostazioni di licenza Chaos, imposta:

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

Riavvia vrlservice. Verifica avviando V-Ray su un nodo di rendering.

Conflitti di porta e regole del firewall

La porta 30304 è la porta standard del Chaos License Server. Se ricevi errori "connection refused" o messaggi "port already in use", significa che qualcos'altro sta occupando la porta.

Controlla cosa è in ascolto sulla 30304:

Su Windows (esegui come amministratore):

netstat -ano | find ":30304"

Su Linux/macOS:

lsof -i :30304

Se la porta è occupata da un altro servizio, ferma quel servizio oppure riconfigura il Chaos License Server perché usi una porta diversa (si imposta nel file di configurazione di cslserver).

Per le regole del firewall: assicurati che i nodi di rendering possano raggiungere il license server sulla porta 30304 (TCP). Se la tua farm si estende su più sottoreti, verifica che le ACL di rete permettano questo traffico. Noi manteniamo una regola firewall interna chiamata "SRF_License_Server_Access" che consente a tutti i nodi di rendering di raggiungere il nostro license server principale.

Se usi un firewall aziendale, aggiungi gli intervalli IP del cloud di Chaos alla tua allowlist. Chaos pubblica questi intervalli nella propria documentazione.

Licenza online: il metodo con account Chaos diretto

In alternativa, V-Ray 7 supporta l'autenticazione diretta con l'account Chaos, senza un License Server locale.

Crea un account Chaos e acquista un abbonamento V-Ray. Durante l'installazione di V-Ray o nelle impostazioni di rendering, seleziona "Cloud Authorization" e inserisci le tue credenziali Chaos.

V-Ray si autenticherà al cloud di Chaos a ogni avvio. Ogni nodo di rendering ha bisogno dell'accesso a internet (o di un accesso tramite proxy) agli endpoint cloud di Chaos.

Per le render farm questo approccio è più semplice da distribuire, perché non richiede un'infrastruttura License Server separata. Tuttavia è meno tollerante ai guasti se la connessione a internet cade durante il rendering.

Licenze con Docker e macchine virtuali

Se esegui V-Ray in container Docker o su macchine virtuali, le licenze si comportano in modo leggermente diverso.

Per i container Docker, i dispositivi USB dell'host (i dongle) devono essere passati al container. In questo caso, assicurati che il container venga eseguito con privilegi sufficienti:

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

Il driver WIBU-KEY deve essere installato sul sistema operativo host, non all'interno del container.

Per le VM, i dongle fisici possono essere passati tramite reindirizzamento USB, ma questo introduce latenza e instabilità. La maggior parte delle render farm di grandi dimensioni evita il passthrough USB. Usa invece il Chaos License Server in esecuzione sull'host, con le VM che si collegano via rete.

Il Chaos License Server (basato su rete) funziona senza problemi con le VM perché è una normale connessione TCP/IP. Non serve alcun passthrough hardware.

Licenze nelle render farm: come le gestiscono i servizi gestiti

Sulla nostra render farm, la licenza dei nodi di rendering è inclusa nel costo: non devi gestire le licenze da solo. Manteniamo un'infrastruttura Chaos License Server ridondata con failover. Se un server diventa non disponibile, la flotta di render passa automaticamente a un server di backup.

Super Renders Farm è un partner ufficiale di Chaos Group per V-Ray: la licenza dei nodi di rendering è gestita centralmente in base a quell'accordo di partnership, ed è per questo che i guasti di dongle, conflitti di porta e driver descritti sopra sono un problema che risolviamo noi, non qualcosa da configurare su ogni nodo.

Se gestisci un'infrastruttura di render farm in proprio, vale lo stesso principio: distribuisci i tuoi License Server con ridondanza. Usa un server primario e almeno uno standby a caldo. Testa regolarmente il failover.

Monitoriamo costantemente anche lo stato di salute del license server. Se il server diventa irraggiungibile, lo segnaliamo subito. In una render farm indipendente, configura un monitoraggio analogo: non aspettare che un job di rendering fallisca per scoprire che il license server è fuori servizio.

Integrazione con Chaos Cloud e licenza legata all'account

Chaos Cloud è la piattaforma di rendering cloud nativa di Chaos. Se usi Chaos Cloud o stai valutando di farlo, la licenza viene gestita interamente tramite il tuo account Chaos.

All'interno di Chaos Cloud, le licenze V-Ray sono a consumo. L'addebito avviene per ora di render o per job completato, non per nodo. Questo modello elimina la necessità di gestire le licenze nodo per nodo, perché la piattaforma cloud distribuisce le licenze in modo centralizzato.

Se integri Chaos Cloud con una render farm on-premises, puoi usare entrambe le soluzioni: nodi on-premises con Chaos License Server locale e cloud bursting tramite Chaos Cloud. Ogni sistema si autentica in modo indipendente.

Risoluzione dei conflitti di porta in configurazioni ad alta concorrenza

Se esegui molti nodi di rendering e processi vrlservice, potresti incontrare l'esaurimento delle porte effimere. Si manifesta con errori "connection refused" sporadici che sembrano casuali.

Il problema: ogni processo vrlservice richiede una porta su cui mettersi in ascolto. Se hai centinaia di nodi di rendering e tutti si riavviano contemporaneamente (dopo un'interruzione di corrente, per esempio), l'intervallo di porte effimere del sistema operativo può esaurirsi.

Su Linux, amplia l'intervallo di porte effimere:

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

Su Windows puoi modificare le impostazioni del registro (consulta il supporto Chaos per le voci HKEY_LOCAL_MACHINE specifiche).

Una soluzione alternativa più semplice: scagliona i riavvii dei nodi di rendering. Riavvia i nodi a gruppi di 10-20 ogni pochi minuti, invece che tutti insieme.

Verifiche dopo la correzione degli errori di licenza

Dopo aver applicato una correzione, verifica che il license server di V-Ray funzioni:

Apri un terminale ed esegui:
```
vrlservice --status
```
(oppure controlla il processo vrlservice in Task Manager / Activity Monitor)
Apri V-Ray e controlla Settings > System > License. Dovrebbe mostrare "Licensed" e il tipo di licenza (dongle, server o account cloud).
Se usi un License Server, esegui un rapido test da un nodo di rendering:
```
vrlcontrol --server <license-server-ip> --status
```
Invia un job di rendering di prova ad almeno un nodo di rendering.

Questi controlli confermano che la catena di licenza è integra, dalla fonte di autenticazione fino al motore di rendering.

FAQ

Q: Vedo "License Server not responding" ma il server è in esecuzione. Cosa c'è che non va? A: Controlla la connettività di rete tra il nodo di rendering e il license server. Verifica che IP e porta siano corretti. Conferma che il firewall consenta la porta 30304 (o quella che hai configurato). Se sei su una VPN, assicurati che la sottorete della VPN possa raggiungere il license server. Esegui ping <license-server-ip> dal nodo di rendering. Se il ping fallisce, il problema è di rete, non di licenza.

Q: Posso usare un vecchio dongle WIBU-KEY con V-Ray 7? A: No. V-Ray 7 ha rimosso il supporto per i dongle. Devi usare il Chaos License Server oppure la licenza online legata all'account Chaos. Se hai già licenze WIBU-KEY, contatta Chaos per un programma di migrazione o di permuta delle licenze.

Q: La nostra farm non ha internet. Come facciamo a licenziare V-Ray 7? A: Usa il Chaos License Server. Il License Server si collega al cloud di Chaos una sola volta per convalidare e memorizzare in cache le tue licenze. Dopodiché i nodi di rendering si collegano solo al tuo License Server locale, senza bisogno di internet. Assicurati che l'host del License Server abbia accesso a internet, ma i nodi di rendering no. Tuttavia le licenze vengono aggiornate periodicamente (consulta la documentazione di Chaos per l'intervallo di aggiornamento), quindi periodi offline prolungati possono causare la scadenza della licenza.

Q: Ho bisogno di licenze separate per ogni nodo di rendering? A: No. Su una render farm di solito si acquistano una o più licenze nominali che il License Server gestisce e distribuisce ai nodi di rendering. Ogni job di rendering concorrente consuma una licenza. I nodi di rendering inattivi non consumano licenze. Chiedi al tuo referente per le licenze presso Chaos quale livello di licenza è adatto al numero dei tuoi nodi.

Q: Perché vrlservice.exe va in crash all'avvio? A: Di solito la causa è legata ai driver (vecchio driver WIBU-KEY) o ai permessi (l'account di servizio non ha privilegi sufficienti). Su Windows, verifica che il servizio venga eseguito come Local System o come account utente con diritti amministrativi completi. Scarica di nuovo e installa l'ultimo software WIBU-KEY o Chaos License Server. Controlla Event Viewer per i log di crash del servizio.

Q: Posso eseguire più Chaos License Server per il failover? A: Sì, ed è quello che consigliamo. Configura un server come primario e gli altri come secondari. I nodi di rendering possono essere impostati per provare prima il primario e poi passare ai server secondari se il primario è irraggiungibile. La configurazione esatta dipende dalla documentazione attuale di Chaos, quindi rivolgiti al loro team di supporto per la tua versione.

Prossimi passi

Se questi passaggi di risoluzione dei problemi non risolvono il tuo problema, raccogli le seguenti informazioni e contatta il supporto Chaos:

I numeri di versione di V-Ray e del License Server
I messaggi di errore e i codici di errore (da log e interfaccia)
Il tuo sistema operativo e l'architettura del sistema (Windows 10/11, Ubuntu 20.04, ecc.)
La topologia di rete (on-premises, cloud, ibrida)
Eventuali modifiche recenti (aggiornamenti dei driver, patch del sistema operativo, modifiche di rete)

Per le render farm che usano i nostri servizi presso SuperRenders Farm, il nostro team di supporto può spesso risolvere i problemi di licenza senza passare da Chaos. Abbiamo una visibilità approfondita sulla nostra infrastruttura License Server e possiamo diagnosticare rapidamente i problemi a livello di nodo.