Installare XFS Bot su Ubuntu e Arch

01Cosa serve

Niente di esotico. Una macchina Linux dove sei amministratore e un quarto d’ora davanti a un terminale.

• Una macchina Linux con almeno 2 GB di RAM e 20 GB liberi. Va bene un VPS da pochi euro, un vecchio portatile, un mini PC in salotto.
• I permessi di amministratore (root o un utente con sudo).
• Un bot Telegram: lo crei parlando con @BotFather, ti dà un token.
• API ID e API Hash del tuo account Telegram: si prendono una volta sola su my.telegram.org → API development tools.
• Un canale Telegram privato dove il bot archivia i file (aggiungi il bot come amministratore).
• Un dominio, se vuoi l’HTTPS e un indirizzo bello. Vanno benissimo i nomi gratuiti tipo miobot.mooo.com di FreeDNS. Non è obbligatorio: senza dominio si lavora con l’indirizzo IP.

02Quale distribuzione conviene

Ci sono due pacchetti perché ci sono due mondi diversi, non perché uno sia migliore dell’altro.

03Copiare il pacchetto sul server

Il pacchetto si scarica dalla homepage sul tuo computer, e da lì si manda al server con scp. Oppure lo si fa scaricare direttamente al server: entrambe le strade vanno bene.

Dal tuo computer al server (scp)

Da Windows, in PowerShell — scp c’è già, non serve installare nulla:

# Ubuntu / Debian
scp .\xfsbot-installer-ubuntu.run root@IL.TUO.SERVER:/root/

# Arch
scp .\xfsbot-installer-arch.run root@IL.TUO.SERVER:/root/

Da Linux o macOS è identico, cambia solo il modo di scrivere il percorso:

scp ~/Scaricati/xfsbot-installer-ubuntu.run root@IL.TUO.SERVER:/root/

Se l’accesso SSH non è sulla porta 22, o se usi una chiave, la porta si scrive con la -P maiuscola (con ssh invece è minuscola: è una delle antipatie storiche di questi programmi):

scp -P 2222 -i ~/.ssh/la_mia_chiave xfsbot-installer-ubuntu.run root@IL.TUO.SERVER:/root/

Oppure: scaricarlo direttamente dal server

Se il server ha accesso a internet è anche più veloce, perché il file non passa due volte dalla tua linea:

ssh root@IL.TUO.SERVER

# poi, sul server:
cd /root
curl -L -O https://filestorexfs.com/scarica/xfsbot-installer-ubuntu.run
# (per Arch: xfsbot-installer-arch.run)

04Verificare che il pacchetto sia integro

Trenta secondi che valgono la pena: ti dicono che quello che stai per lanciare come amministratore è esattamente quello che è stato pubblicato.

Il pacchetto sa controllarsi da solo:

chmod +x xfsbot-installer-ubuntu.run
./xfsbot-installer-ubuntu.run --controlla

Risposta attesa: Pacchetto integro (sha256 …). Questo però dice solo che il file non si è rotto strada facendo. Per sapere che è quello giusto, confronta l’impronta con quella scritta sulla homepage:

sha256sum xfsbot-installer-ubuntu.run

Le due stringhe devono essere identiche, carattere per carattere.

Altre due opzioni utili, se vuoi guardarci dentro prima di lanciarlo:

./xfsbot-installer-ubuntu.run --versione     # che versione è
./xfsbot-installer-ubuntu.run --estrai /tmp/xfs   # estrae senza installare niente
./xfsbot-installer-ubuntu.run --aiuto        # tutte le opzioni

05Lanciare l’installazione

Se sei già collegato al server con ssh, basta:

sudo ./xfsbot-installer-ubuntu.run

ssh -t root@IL.TUO.SERVER "/root/xfsbot-installer-ubuntu.run"

L’installazione è divisa in passi numerati e ti dice sempre a che punto è. Dura fra i cinque e i quindici minuti, quasi tutti spesi a scaricare i programmi di sistema (ffmpeg, aria2, yt-dlp e compagnia).

Se le risposte le hai già scritte: installazione muta

Chi ha già installato una volta, o chi deve mettere in piedi più server uguali, non ha nessuna voglia di ribattere trenta risposte a mano. L’installatore accetta un file di testo con dentro tutto, e in quel caso non chiede niente: parte, legge, installa.

Il file è fatto di righe NOME='valore' — lo legge bash, quindi vanno gli apici singoli. Un modello da riempire si trova dentro il pacchetto stesso:

./xfsbot-installer-ubuntu.run --estrai /tmp/xfs
cp /tmp/xfs/xfsbot-linux/script/risposte-esempio.conf.esempio /root/risposte.conf
nano /root/risposte.conf   # riempi i campi, uno per riga

Com’è fatto risposte.conf, per intero

Non c’è niente di misterioso: è un file di testo che l’installatore esegue con bash (source), quindi valgono le regole di bash. Gli apici singoli sono obbligatori attorno ai valori, perché senza, un carattere come $ o & dentro una password verrebbe interpretato invece che letto. Le righe che cominciano con # sono commenti. L’ordine non conta.

Questo è un file completo, con dentro tutto quello che l’installatore sa leggere. Copialo, cambia i valori e cancella pure i commenti:

# ─── Telegram: il minimo indispensabile ──────────────────────────────
# API ID e hash si prendono da my.telegram.org, sezione "API development tools".
TG_API_ID='1234567'
TG_API_HASH='0123456789abcdef0123456789abcdef'
# Il token che ti dà BotFather quando crei il bot.
TG_BOT_TOKEN='7712345678:AAF-esempio-di-token-non-vero-xyz'
# Il nome del bot SENZA la chiocciola.
TG_BOT_USERNAME='ilmiobot'
# Il canale dove finiscono i file. Comincia per -100. Il bot dev'essere
# amministratore del canale, altrimenti non ci può scrivere.
TG_CHANNEL_ID='-1001234567890'
# Un secondo canale per le copie di sicurezza. Vuoto = non lo voglio.
TG_CHANNEL_BACKUP_ID=''
# Il TUO ID numerico (te lo dice @userinfobot). Più di uno: separati da virgola.
TG_ADMIN_IDS='123456789'

# ─── Account personale: serve per i file oltre i 2 GB ────────────────
# Col solo bot si caricano file fino a 2 GB. Con l'account personale collegato
# si arriva a 4 GB, e con Telegram Premium a 8. Vuoto = solo il bot.
TG_USER_PHONE='+391234567890'
# La password della verifica in due passaggi, se ce l'hai. Vuota se non l'hai.
TG_USER_2FA_PASS='la-mia-password-2fa'
# Come chiamare questo account nel pannello, quando ce n'è più d'uno.
TG_USER_LABEL='Premium'

# ─── Pannello web ────────────────────────────────────────────────────
# Porta INTERNA. Con l'HTTPS acceso non è esposta: ci parla solo Caddy.
WEB_PORT='8890'
WEB_ADMIN_USERNAME='admin'
# Mettila lunga: questo utente può fare tutto.
WEB_ADMIN_PASSWORD='una-password-lunga-e-a-caso'
# Chi può iscriversi al tuo dominio:
#   open     chiunque, subito
#   approval chiunque può chiedere, entra quando approvi tu   <-- consigliato
#   closed   nessuno, gli account li crei tu dal pannello
WEB_REGISTRATION_MODE='approval'

# ─── Dominio e certificato ───────────────────────────────────────────
# Il nome pubblico. Vuoto = si usa l'IP nudo e niente HTTPS.
# ATTENZIONE: il record A deve già puntare a questo server PRIMA di
# installare, se no Let's Encrypt non può emettere il certificato.
DOMINIO='miobot.mooo.com'
# 's' = installa Caddy e prendi il certificato da solo. 'n' = lascia stare.
ABILITA_HTTPS='s'

# ─── Forum e host di file (tutti facoltativi) ────────────────────────
# Servono a cercare e scaricare direttamente dal pannello. Se non hai
# l'account, lascia la riga vuota: non è un errore.
MIRCREW_USER=''
MIRCREW_PASS=''
FORESTA_USER=''
FORESTA_PASS=''
XFS_HOST_FILESTORE_USER=''
XFS_HOST_FILESTORE_PASS=''
XFS_HOST_TERABYTEZ_USER=''
XFS_HOST_TERABYTEZ_PASS=''

# ─── Extra ───────────────────────────────────────────────────────────
# Chiave gratuita da themoviedb.org: con questa i film arrivano con
# locandina, trama e voto invece che col nome del file.
TMDB_API_KEY='0123456789abcdef0123456789abcdef'
# Quanti download insieme. 3 è un buon compromesso.
MAX_CONCURRENT_DOWNLOADS='3'
# Installare unrar/rar per aprire gli archivi .rar (licenza non libera).
INSTALLA_RAR='s'
# 's' = fermati e aspetta il codice di Telegram (serve --codice-da, sotto).
# 'n' = tira dritto, l'account personale lo colleghi dopo dal pannello.
ATTENDI_TELEGRAM='n'

# ─── Fediverso: il collegamento con gli altri domini ─────────────────
# Sempre facoltativo. 'n' e l'istanza vive benissimo per conto suo.
FEDIVERSE_ENABLED='s'
# Come ti vedono gli altri. Vuoto = usa il dominio.
FEDIVERSE_NAME='Il mio archivio'
# 's' = comparire nell'elenco pubblico dei domini. 'n' = restare defilato.
FEDIVERSE_PUBLIC_DIRECTORY='s'
# Da dove partire per conoscere gli altri, separati da virgola. Vuoto va
# benissimo: il programma ne conosce già due di fabbrica e da lì scopre
# tutti gli altri da solo. Non esiste nessun registro centrale.
FEDIVERSE_SEEDS=''
# Domini con cui federarsi SUBITO. Serve che anche l'altro lato accetti,
# quindi se non sei sicuro lascia vuoto e decidi dopo, dal pannello.
FEDIVERSE_PEERS=''

La versione corta

Se vuoi solo un archivio funzionante, senza forum, senza schede dei film e senza federazione, bastano queste dodici righe. Tutto il resto ha un valore di fabbrica sensato — ma ricorda la regola: quello che togli, te lo chiederà.

TG_API_ID='1234567'
TG_API_HASH='0123456789abcdef0123456789abcdef'
TG_BOT_TOKEN='7712345678:AAF-esempio-di-token-non-vero-xyz'
TG_BOT_USERNAME='ilmiobot'
TG_CHANNEL_ID='-1001234567890'
TG_CHANNEL_BACKUP_ID=''
TG_ADMIN_IDS='123456789'
TG_USER_PHONE=''
WEB_PORT='8890'
WEB_ADMIN_USERNAME='admin'
WEB_ADMIN_PASSWORD='una-password-lunga-e-a-caso'
WEB_REGISTRATION_MODE='closed'
DOMINIO=''
ABILITA_HTTPS='n'
ATTENDI_TELEGRAM='n'
FEDIVERSE_ENABLED='n'

bash -n /root/risposte.conf   # muto = va bene

Poi si passa il file all’installatore. Attenzione al -- da solo: serve a dire «quello che segue non è per te, passalo a chi sta dentro».

sudo ./xfsbot-installer-ubuntu.run -- -r /root/risposte.conf

Così non serve nemmeno il terminale: da remoto, in una riga sola e senza -t, perché non c’è più niente da chiedere.

ssh root@IL.TUO.SERVER "/root/xfsbot-installer-ubuntu.run -- -r /root/risposte.conf"

Il codice di accesso di Telegram è l’unica cosa che non si può scrivere in anticipo: arriva sul telefono in quel momento. Se vuoi che sia muta davvero fino in fondo, si mette il codice in un file appena lo ricevi e glielo si indica:

sudo ./xfsbot-installer-ubuntu.run -- -r /root/risposte.conf --codice-da /root/codice.txt

La ricetta completa, dal principio alla fine

Tutto quello che sta scritto sopra, messo in fila e pronto da incollare. Il pacchetto lo scarica il server da sé: non ha senso far passare cento megabyte due volte dalla tua linea.

Ubuntu / Debian

# --- sul server, collegato come root ---
cd /root
curl -fLO https://filestorexfs.com/scarica/xfsbot-installer-ubuntu.run
chmod +x xfsbot-installer-ubuntu.run
./xfsbot-installer-ubuntu.run --controlla

# il modello delle risposte sta dentro il pacchetto
./xfsbot-installer-ubuntu.run --estrai /tmp/xfs
cp /tmp/xfs/xfsbot-linux/script/risposte-esempio.conf.esempio /root/risposte.conf
chmod 600 /root/risposte.conf
nano /root/risposte.conf        # riempi i campi, uno per riga

bash -n /root/risposte.conf     # muto = scritto bene

# installazione muta
./xfsbot-installer-ubuntu.run -- -r /root/risposte.conf

# pulizia
rm -rf /tmp/xfs /root/risposte.conf /root/xfsbot-installer-ubuntu.run

Arch

cd /root
curl -fLO https://filestorexfs.com/scarica/xfsbot-installer-arch.run
chmod +x xfsbot-installer-arch.run
./xfsbot-installer-arch.run --controlla

./xfsbot-installer-arch.run --estrai /tmp/xfs
cp /tmp/xfs/xfsbot-linux/script/risposte-esempio.conf.esempio /root/risposte.conf
chmod 600 /root/risposte.conf
nano /root/risposte.conf

bash -n /root/risposte.conf

./xfsbot-installer-arch.run -- -r /root/risposte.conf

rm -rf /tmp/xfs /root/risposte.conf /root/xfsbot-installer-arch.run

Se hai messo ATTENDI_TELEGRAM='s'

L’installatore si ferma ad aspettare il codice. Per non restare a guardare lo schermo, glielo passi da un file — da un’altra finestra, appena arriva su Telegram:

# finestra 1, sul server
./xfsbot-installer-ubuntu.run -- -r /root/risposte.conf --codice-da /root/codice.txt

# finestra 2, dal tuo computer
ssh root@IL.TUO.SERVER "echo 12345 > /root/codice.txt"

Con ATTENDI_TELEGRAM='n' invece tira dritto, e l’account personale lo colleghi dopo dal pannello, alla voce Impostazioni → Telegram.

Tre precisazioni che fanno risparmiare tempo

• Niente sudo, se sei collegato come root: sei già amministratore, e su un’installazione Arch minimale sudo spesso non c’è nemmeno. Il comando fallirebbe con «command not found» facendoti credere che sia rotto l’installatore. Se invece entri con un utente normale, il sudo davanti ci vuole.
• Il -- da solo prima di -r non è un abbellimento: dice all’involucro autoestraente «quello che segue non è per te, passalo all’installatore che sta dentro». Senza, il file delle risposte non arriva a destinazione e l’installazione ricomincia a farti le domande.
• Con il file delle risposte, da remoto, non serve -t: il -t serve solo quando ci sono domande da fare. Qui non ce ne sono più, quindi una riga sola basta e avanza.

  ssh root@IL.TUO.SERVER "/root/xfsbot-installer-ubuntu.run -- -r /root/risposte.conf"

06Le domande, una per una

Ogni domanda mostra fra parentesi quadre il valore proposto: se ti va bene, premi Invio e passa avanti. Nessuna domanda è irreversibile — tutto quello che rispondi finisce in /opt/xfsbot/.env e si può cambiare dopo.

Telegram

Pannello web e dominio

Scraper, host di file, extra (tutti facoltativi)

• MirCrew e LaForesta: utente e password del forum, se ce l’hai. Servono a cercare direttamente dal pannello.
• Filestore e TerabyteZ: gli account degli host di file, per i download diretti.
• TMDB: una chiave gratuita da themoviedb.org, e i film arrivano con locandina, trama e voto invece che con il nome del file.
• Download contemporanei: 3 è un buon compromesso. Su una linea casalinga non alzarlo troppo o si intasa tutto.

Fediverso (collegamento con gli altri domini)

• Nome: come ti vedono gli altri domini.
• Semi: gli indirizzi da cui partire per conoscere gli altri. Lascia vuoto e usa quelli di fabbrica.
• Domini con cui federarti subito: puoi lasciare vuoto e decidere dopo dal pannello, con calma.

07Il codice di Telegram

L’unico passo che non può essere automatico, e solo la prima volta.

Se hai indicato il numero di telefono, verso la fine l’installatore chiede a Telegram di mandarti il codice e aspetta che tu lo scriva. Arriva dentro Telegram, non per SMS: guarda nella chat «Telegram».

• Se hai la verifica in due passaggi, dopo il codice viene chiesta la password.
• Se sbagli, si può riprovare: non ricomincia niente.
• Puoi anche saltare e collegare l’account dopo, dal pannello, alla voce Impostazioni → Telegram.

08La cassetta degli attrezzi

L’installazione lascia un comando che si chiama come il servizio — normalmente xfsbot — e che risponde in italiano.

I cataloghi dei metadati

Sono gli elenchi da cui il bot pesca titoli, copertine e trame di libri, fumetti e anime. Sono già dentro il .run: circa 84 MB che l’installatore copia in /opt/xfsbot/metadata_tools senza chiedere niente e senza scaricare niente. Non devi fare nulla per averli.

Ogni tanto però i cataloghi crescono, e non ha senso reinstallare tutto per aggiornare due file di dati. In quel caso si prendono da soli:

curl -fLO https://filestorexfs.com/scarica/cataloghi_metadati.zip
sudo unzip -o cataloghi_metadati.zip -d /opt/xfsbot/metadata_tools
sudo chown -R xfsbot:xfsbot /opt/xfsbot/metadata_tools
sudo systemctl restart xfsbot

09Aggiornare

Dalla seconda volta in poi non ti viene chiesto niente: le risposte sono già scritte e vengono rilette da sole.

La strada breve

scp xfsbot-installer-ubuntu.run root@IL.TUO.SERVER:/root/
ssh -t root@IL.TUO.SERVER "chmod +x /root/xfsbot-installer-ubuntu.run && \
    /root/xfsbot-installer-ubuntu.run --aggiorna"

--aggiorna vuol dire: le risposte le sai già, non chiedere niente a nessuno. Rilegge tutto da /opt/xfsbot/.env, sostituisce il programma e riavvia il servizio.

La strada dal pannello

Quando esce una versione nuova, il pannello lo dice da solo (una pallina accanto a Impostazioni). Nella scheda Aggiornamenti premi «scarica e verifica»: il pacchetto scende sul server, viene confrontato con l’impronta firmata, e poi ti viene mostrato il comando esatto da incollare, con un pulsante per copiarlo. Sarà qualcosa del genere:

sudo /opt/xfsbot/aggiornamenti/xfsbot-installer-ubuntu.run --aggiorna

Il pannello non lo lancia da solo perché il bot gira come utente normale, senza i permessi di amministratore: è una scelta di sicurezza, non una mancanza. Un programma che scarica da internet e può installare come root è esattamente la cosa che non vogliamo avere sulla macchina.

Cosa NON viene toccato

• La configurazione (.env), con tutte le tue risposte.
• Le chiavi del pannello e del seeder: non vengono rigenerate, quindi non ti ritrovi scollegato da tutte le sessioni.
• La sessione di Telegram: nessun codice da riscrivere.
• La banca dati, gli utenti, i file scaricati, la cronologia.

10Porte, HTTPS e firewall

L’installatore apre da solo quello che serve, se trova ufw o firewalld. Ecco cosa apre e perché.

HTTPS con un dominio

Se hai risposto con un dominio, l’installatore mette Caddy e il certificato arriva da solo in una decina di secondi. Perché funzioni, il dominio deve già puntare all’IP del server (record A) prima di installare: se il DNS non è ancora propagato, il certificato non può essere emesso. Si rimedia dopo con sudo systemctl restart caddy.

Per sapere se il DNS è a posto senza indovinare, c’è xfsbot dottore: la sezione IL DOMINIO confronta il record A del tuo nome con l’IP vero di questa macchina, e poi prova a rientrare dalla porta principale per vedere se il pannello risponde davvero da fuori.

11Trucchi e cose da sapere

Una scrivania grafica sul server (VNC)

Serve raramente, ma quando serve fa comodo: per esempio per fare il login su un forum protetto da Cloudflare con un browser vero. L’installazione lascia pronto:

sudo /opt/xfsbot/script/setup-vnc.sh

Installa una scrivania XFCE leggera raggiungibile via VNC. Non è obbligatoria e non viene installata da sola.

I forum dietro Cloudflare

Alcuni forum (MirCrew fra questi) mettono davanti un controllo «dimostra di essere umano» che nessun programma può superare da solo. La strada che funziona è fare il login una volta con un browser vero — anche sul tuo computer — ed esportare i cookie nel pannello, alla voce degli scraper. Da lì in poi il bot lavora da solo finché i cookie non scadono.

Dove stanno le cose

Spazio su disco

È il motivo numero uno per cui un’installazione smette di funzionare senza dare spiegazioni. Un controllo ogni tanto costa niente:

df -h /
du -sh /opt/xfsbot/dati/*

Copia di sicurezza in trenta secondi

Se salvi questi due, hai salvato tutto quello che non si può ricreare:

sudo tar czf ~/xfsbot-backup-$(date +%F).tar.gz \
     /opt/xfsbot/.env /opt/xfsbot/dati

Più installazioni sulla stessa macchina

Si può, e non si pestano i piedi: cambia prefisso e cambia porta.

sudo ./xfsbot-installer-ubuntu.run -- -p /opt/xfsbot-prova

Servizio, utente, comando e registro prendono il nome dalla cartella: xfsbot-prova.

12Se qualcosa va storto

Prima di tutto, la domanda giusta al programma giusto:

xfsbot dottore

Controlla servizio, porte, permessi, programmi esterni, spazio, configurazione, e dice cosa non va invece di limitarsi a dire che non va. Poi:

sudo xfsbot ripara

applica i rimedi noti (permessi, librerie, unità systemd, ponti verso i programmi) e riavvia.