Skip to main content

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

Scarica Lavalink.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 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.

Rafforzare la sicurezza

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 Advanced configuration del modulo di upload o nella pagina Environment Variables della tua applicazione nella dashboard, oppure dalla CLI:
Consulta Variabili d’ambiente per gli altri modi di gestirle.

Creazione del file di configurazione di 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).

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.
Metti Lavalink.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.
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):
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.

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.