Vai al contenuto principale

​
Introduzione

Per sviluppare e ospitare un server Lavalink su Square Cloud, è essenziale seguire una sequenza strutturata di configurazioni e prerequisiti. Questa guida tecnica coprirà l’intero processo, dalla configurazione iniziale al deploy in produzione.

​
Prerequisiti

  • Account Square Cloud: Registrati tramite la pagina di registrazione usando la tua email.
  • Piano attivo: Garantisce risorse dedicate e prestazioni ottimizzate per la tua applicazione. Consulta i nostri piani disponibili e scegli quello più adatto alle tue esigenze.
Questa guida usa il runtime Java.

​
Ottenere il progetto

Scarica Lavalink.jar dalla pagina ufficiale delle release. Questa guida usa Lavalink v4: scegli l’ultima release 4.x (4.2.0 o successiva) e assicurati che il tuo bot usi un client Lavalink compatibile con la v4 e con DAVE (vedi Connettere il tuo bot).
Abbiamo già tutto pronto per il deploy nelle nostre release di lavalink-web, con il plugin di YouTube configurato. Scarica il project.zip e caricalo: durante il deploy di Lavalink, sostituisci il valore provvisorio di LAVALINK_SERVER_PASSWORD nelle variabili d’ambiente con una password lunga e casuale.
Crea un file application.yml accanto a Lavalink.jar. La configurazione minima qui sotto è in ascolto sulla porta indicata dalla variabile d’ambiente PORT (Square Cloud la imposta a 80) e riproduce YouTube tramite il plugin ufficiale youtube-source, perché la sorgente YouTube integrata in Lavalink è deprecata:
application.yml
Lavalink scarica il plugin al primo avvio. Per tutte le altre opzioni (altre sorgenti, filtri, buffer), consulta il file di esempio ufficiale.
Mantieni address: 0.0.0.0 e non sostituire la porta con un valore fisso diverso da 80: Square Cloud consegna il traffico del tuo sottodominio alla porta 80 della tua applicazione.

​
Impostare una password robusta

Sostituisci il valore di password con una password robusta e casuale di almeno 32 caratteri. Per tenerla fuori dai tuoi file, impostala invece nella variabile d’ambiente LAVALINK_SERVER_PASSWORD: Lavalink dà la precedenza alle variabili d’ambiente rispetto all’application.yml. Aggiungi la variabile in Configurazione avanzata del modulo di upload o nella pagina Variabili d’ambiente della tua applicazione nella dashboard, oppure dalla CLI:
Consulta Variabili d’ambiente per gli altri modi di gestirle.

​
Configurare Square Cloud

Crea un file squarecloud.app accanto a Lavalink.jar. Il campo SUBDOMAIN pubblica il tuo server su https://<sottodominio>.squareweb.app:
squarecloud.app
MAIN=Lavalink.jar fa sì che Square Cloud avvii il server con java -jar Lavalink.jar, MEMORY è la sua RAM in MB, e AUTORESTART=true lo riavvia se va in crash (consulta come funziona il riavvio automatico).

​
Cosa mettere nello ZIP

  • Lavalink.jar
  • application.yml
  • squarecloud.app
Metti i tre file nella stessa cartella e comprimili in un file .zip da caricare dalla dashboard.

​
Deploy e verifica

​
Tramite dashboard

1

Accedi alla pagina di upload

Accedi alla pagina di upload e carica il file zip del tuo progetto.
2

Configura il tuo ambiente

Dopo aver caricato il tuo zip, dovrai configurare il nome, il file principale o il runtime environment e altre impostazioni per il tuo progetto.
Se stai caricando un progetto web, assicurati di selezionare “Web Publication” e di impostare un sottodominio per il tuo progetto.
3

Esegui il deploy del tuo progetto

Infine, clicca sul pulsante “Deploy” per ospitare il tuo progetto su Square Cloud.
Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.
Caricamento dell'applicazione su Square Cloud
4

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Nella dashboard, attendi che lo stato della tua applicazione mostri “in esecuzione” e controlla i log per eventuali errori di avvio.
Se hai fatto il deploy di un sito web o di un’API, apri https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.
La tua app non si avvia? Consulta la guida alla risoluzione dei problemi per le cause più comuni e le relative soluzioni.

​
Tramite CLI

Per utilizzare questo metodo, il tuo progetto deve avere un file di configurazione chiamato squarecloud.app nella sua radice. Indica a Square Cloud come eseguire la tua applicazione.

Guida al file di configurazione

Scopri come creare il file di configurazione squarecloud.app che definisce l’ambiente della tua applicazione.
1

Installa la CLI

Installa la CLI di Square Cloud. Se ce l’hai già, esegui lo stesso comando per aggiornarla:
2

Accedi

Esegui il comando qui sotto. Apre il tuo browser: approva l’accesso lì e la CLI è pronta. Non c’è nessuna chiave API da copiare. Per script e CI, consulta Autenticazione della CLI.
3

Carica il tuo progetto

Dalla cartella del tuo progetto, esegui il comando qui sotto. La CLI comprime la cartella corrente, escludendo ciò che elenca squarecloud.ignore, e la carica:
Per caricare uno zip che hai creato tu, passalo con --file:
4

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Controlla lo stato e i log della tua applicazione direttamente dal terminale:
Se hai fatto il deploy di un sito web o di un’API, apri https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.
La tua app non si avvia? Consulta la guida alla risoluzione dei problemi per le cause più comuni e le relative soluzioni.

​
Connettere il tuo bot

Lavalink è in ascolto sulla porta 80 all’interno di Square Cloud, ma il tuo bot si connette tramite l’edge pubblico, che serve HTTPS sulla porta 443. Configura il nodo nel tuo client Lavalink così (i nomi dei campi variano tra le librerie):
Da marzo 2026 Discord fa entrare i bot nei canali vocali solo con DAVE, la sua crittografia end-to-end per la voce. Lavalink la supporta dalla versione 4.2.0, e anche il client Lavalink del tuo bot deve supportarla: altrimenti il bot si connette a Lavalink ma non riesce a entrare in un canale vocale.

​
Errori comuni

La connessione con la porta 80 o con secure: false fallisce: usa la porta 443 e secure: true, come mostrato in Connettere il tuo bot. Se la connessione si chiude con il codice 1006, consulta Connessione Lavalink chiusa con codice 1006.

​
Prossimi passi

Bot Discord

Ospita il bot musicale che si connette al tuo server Lavalink.

Errori dei bot Discord

Risolvi token non validi, intent mancanti ed errori di connessione a Lavalink.

Runtime Java

Come Square Cloud esegue le applicazioni Java.
Per saperne di più su Lavalink, consulta la documentazione ufficiale di Lavalink.

​
Contattaci

Se continui a riscontrare difficoltà tecniche, il nostro team di supporto specializzato è disponibile ad assisterti. Contattaci e saremo felici di aiutarti a risolvere qualsiasi problema: la qualità del supporto è una parte importante del motivo per cui gli sviluppatori valutano Square Cloud 4,9/5 su 402 recensioni su Google e Trustpilot.