Introduzione
- Segui il tutorial qui sotto e ospita il tuo server Lavalink oggi stesso, è semplicissimo! Se hai bisogno di assistenza, contattaci attraverso i nostri canali di supporto ufficiali.
- Successivamente, dovrai creare un account su Square Cloud, cosa che puoi fare tramite la pagina di registrazione. Puoi usare la tua email per creare un account.
- Infine, devi avere un piano attivo sul tuo account. Confronta i piani disponibili e scegline uno in base alle tue esigenze.
Scegliere la versione
ScaricaLavalink.jar dalla pagina ufficiale delle release. Questa guida usa Lavalink v4: scegli l’ultima release 4.x e assicurati che il tuo bot usi un client Lavalink compatibile con la v4.
Creazione dell’application.yml
Crea un fileapplication.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
Rafforzare la sicurezza
Sostituisci il valore dipassword 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 Advanced configuration del modulo di upload o nella pagina Environment Variables della tua applicazione nella dashboard, oppure dalla CLI:
Creazione del file di configurazione di Square Cloud
Crea un filesquarecloud.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).
Scopri di più su: come creare il file di configurazione per Square Cloud.
Il file squarecloud.app è un file di configurazione che verrà utilizzato per configurare la tua applicazione; servirà a definire il nome, la descrizione, la versione, il file principale, tra le altre cose.
Deploy di Lavalink
MettiLavalink.jar, application.yml e squarecloud.app nella stessa cartella (per caricarli dalla dashboard, comprimili in un file .zip). Poi, carica il tuo progetto su Square Cloud.
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.
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.
Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.

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
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.
Tramite CLI
Per utilizzare questo metodo, il tuo progetto deve avere un file di configurazione chiamatosquarecloud.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 Per caricare uno zip che hai creato tu, passalo con
squarecloud.ignore, e la carica:--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.
Connettere il tuo bot
Lavalink è in ascolto sulla porta80 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):
La connessione con la porta
80 o con secure: false fallisce. 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.

