Come installare Shlink su Saplo (il tuo accorciatore di link con statistiche)

Bitly con un piano a pagamento può costare ben oltre 100 Euro al mese, ancora prima che tu superi il limite di link accorciati, perché la fatturazione dipende dal numero di indirizzi attivi e dei clic. Shlink è un accorciatore di link open source, basato sulla stessa idea di Bitly, ma da installare sul tuo Box, con un costo una tantum, senza limiti di indirizzi e senza fattura mensile. Ecco come installare Shlink su Saplo, passo dopo passo.

Perché Shlink sul tuo Box invece di Bitly

I piani a pagamento di Bitly hanno due caratteristiche che risultano particolarmente problematiche nelle campagne marketing e nel monitoraggio dei link a lungo termine:

• limite mensile di link accorciati e clic - il piano gratuito basta per una singola campagna, non per un intero anno di lavoro di un'agenzia,
• dati sui clic conservati da un'azienda esterna - le statistiche del traffico delle tue campagne restano sui server di Bitly, non sui tuoi.

Shlink è lo stesso meccanismo di accorciamento dei link e conteggio dei clic che installi sul tuo Box. Nessun limite al numero di URL, i dati sui clic restano sulla tua infrastruttura e il tuo dominio personalizzato per i link accorciati appare professionale, anziché generico bit.ly.

Requisiti

Per installare Shlink su Saplo, ti servono:

• un Box con Docker attivo (il motore lo abilita automaticamente durante l'installazione dal catalogo, mentre il nesting in un container è necessario e Saplo lo supporta per impostazione predefinita),
• almeno 512 MB di RAM liberi sul Box e 2 GB di spazio su disco,
• un Dominio o un sottodominio *.saploapp.pl incluso nel prezzo di ogni piano, meglio se breve, perché sarà visibile in ogni link breve.

Vale la pena distinguere subito cosa Shlink è e cosa non è. Shlink è un'API REST e un server di reindirizzamento dei link brevi. Su Saplo lo ricevi insieme al Pannello ufficiale nel browser, accessibile all'indirizzo dell'applicazione e protetto da password, quindi non devi installare o configurare nulla. Per l'installazione non hai bisogno di alcun database esterno, perché per impostazione predefinita Shlink conserva i dati in un file SQLite locale all'interno del volume dei dati. Se prevedi un traffico elevato, puoi anche scegliere il database MySQL condiviso di Saplo.

Installazione passo dopo passo

1. Nel Pannello Saplo apri Catalogo delle applicazioni e scegli Shlink (categoria "Strumenti").
2. Indica la Box su cui deve essere installato e il dominio o il sottodominio sotto cui funzioneranno i link abbreviati, quindi scegli il database: SQLite (predefinito, nessuna infrastruttura aggiuntiva) oppure MySQL (database condiviso di Saplo, migliore in caso di traffico elevato).
3. Conferma l'installazione. Il motore crea due container Docker con immagini ufficiali shlinkio/shlink e shlinkio/shlink-web-client (Pannello), genera una chiave API e una password per il Pannello, quindi espone il tutto tramite nginx con SSL gratuito.
4. Il motore attende che Shlink risponda effettivamente alla richiesta di controllo dello stato, e ripete il controllo due volte prima di considerare completata l'installazione, perché il primo avvio richiede la migrazione dello schema del database, che può durare più di pochi secondi.
5. Al termine, nei dati iniziali dell'applicazione (file SHLINK-SETUP.txt) troverai il nome utente e la password per il Pannello, oltre alla chiave API.

Prima configurazione

Shlink, come Grafana e MinIO, genera automaticamente i dati di accesso durante l'installazione, invece di richiederli nella procedura guidata.

1. Apri i dati iniziali dell'applicazione nel Pannello Saplo (file SHLINK-SETUP.txt), dove troverai login, password e chiave API.
2. Clicca su Apri accanto all'applicazione, accedi e seleziona il server I miei link. Il server è già collegato tramite chiave API, non devi inserire nulla.
3. Crea il primo link breve nella scheda di creazione dei link, opzionalmente con un codice breve personalizzato invece di una sequenza casuale di caratteri.
4. Controlla le statistiche dei clic e il codice QR del link creato, entrambe le funzioni sono integrate e disponibili subito dopo l'installazione.

I link brevi funzionano sulla stessa dominio senza password, mentre la password protegge solo il pannello. Il codice breve personalizzato non può chiamarsi server, settings, assets né icons, perché questi indirizzi sono riservati al pannello.

Se preferisci l'automazione invece di fare clic nell'interfaccia, puoi fare la stessa cosa direttamente tramite REST API, ad esempio creando un link breve con un unico comando:

curl -s -X POST 'https://tuo-dominio.saploapp.pl/rest/v3/short-urls' \
  -H "X-Api-Key: YOUR_API_KEY" -H 'Content-Type: application/json' \
  -d '{"longUrl":"https://saplo.pl"}'

Shlink su Saplo contro Bitly

Domande frequenti

Shlink ha un Pannello web per l'accesso, come WordPress o Ghost? Sì. Su Saplo, all'indirizzo dell'applicazione si trova il Pannello ufficiale di Shlink protetto da una password; login e password sono nel file SHLINK-SETUP.txt. Puoi anche aggiungere lo stesso server nel client app.shlink.io oppure gestirlo tramite REST API con la chiave contenuta nel file.

Esiste un limite al numero di link abbreviati? No. Shlink non impone alcun limite al numero di indirizzi o clic; l'unico limite sono le risorse del Box acquistato.

Posso vedere da quale paese è stato cliccato il link? Per impostazione predefinita no; la geolocalizzazione delle visite richiede una propria chiave MaxMind gratuita, che non è possibile creare automaticamente durante l'installazione. Senza di essa, Shlink conta normalmente i clic, ma senza informazioni sul paese del visitatore.

Qual è la differenza tra SQLite e MySQL durante l'installazione? SQLite è un file di database nel volume dei dati: nessuna infrastruttura aggiuntiva ed è sufficiente nella maggior parte dei casi. MySQL è un database condiviso di Saplo, da scegliere solo in caso di traffico di clic davvero elevato.

I dati di Shlink vengono sottoposti automaticamente a backup? Dipende dal piano Box acquistato. Il backup funziona a livello dell'intero Box, come per le altre applicazioni presenti nel Catalogo delle applicazioni, e non è una funzione separata di Shlink.

Se hai domande sull'installazione di Shlink sul tuo Box o sulla prima configurazione del Pannello, scrivici: ti aiuteremo con la prima configurazione.