Post setup it IT

Configurazione post-installazione

Abilitare il traffico HTTPS

Utilizzo di Cloudflare Full (Strict)

Per prima cosa, è necessario un account Cloudflare. Per crearne uno, vai su https://dash.cloudflare.com/sign-up, inserisci la tua email e password e clicca su crea account.

Ora devi inserire il tuo dominio. Questo deve essere il tuo dominio effettivo (ad esempio, banchopy.com o banchopy.net) e non deve includere alcun hostname specifico del dominio (ad esempio, www.banchopy.com o simili).

Successivamente, devi scegliere il tuo piano. Per noi dovrebbe essere sufficiente il Piano gratuito, ma puoi effettuare un upgrade in seguito se necessario.

Ora dovrai copiare i nameserver richiesti da Cloudflare nel tuo registrar di domini. Una volta fatto, clicca su verifica nameserver.

Una volta completati i passaggi precedenti, dovrai aggiungere alcuni record DNS (record A) affinché i domini necessari puntino all'IP su cui bancho.py è in esecuzione.

Puoi generare i record da importare in Cloudflare utilizzando lo script nella cartella tools.

cd tools && ./generate_cf_dns_records.sh && cd..

Nel dashboard di Cloudflare, clicca su Importa ed Esporta.

Se utilizzi domini gratuiti Freenom come .ml, .ga, .ml, .cf, probabilmente non puoi importare i DNS. Questo perché sono limitati nell'API di Cloudflare a causa di abusi significativi. In tal caso, dovrai aggiungere manualmente i seguenti record DNS:

a.tuodominio.com api.tuodominio.com assets.tuodominio.com c.tuodominio.com c4.tuodominio.com ce.tuodominio.com tuodominio.com i.tuodominio.com osu.tuodominio.com s.tuodominio.com

Poi vai su SSL/TLS > Panoramica e attiva Full (Strict).

Ora dovrai creare certificati generati da Cloudflare. Vai su SSL>TLS > Origin Server e clicca su crea certificato.

Dopo averlo creato, dovrai salvare il contenuto del certificato di origine e della chiave privata in file separati sul tuo client.

nano example.com.pem
# incolla il contenuto del certificato di origine

nano example.com.key
# incolla il contenuto della chiave privata

Utilizzo di un certificato SSL personale

# Dovrai modificare:
# - IL_TUO_INDIRIZZO_EMAIL
# - IL_TUO_DOMINIO

# Genera un certificato SSL per il tuo dominio
sudo certbot certonly \
    --manual \
    --preferred-challenges=dns \
    --email IL_TUO_INDIRIZZO_EMAIL \
    --server https://acme-v02.api.letsencrypt.org/directory \
    --agree-tos \
    -d *.IL_TUO_DOMINIO

Abilitare i dati di geolocalizzazione di Cloudflare

Devi andare sul dashboard di Cloudflare e accedere a Regole > Regole di trasformazione. Dopo di che, clicca su trasformazioni gestite e attiva aggiungi intestazioni di posizione del visitatore.

Aggiungere un sito web

bancho.py è un backend: non include un sito web. Per abbinarne uno:

• bancho-web.ts (consigliato) — un frontend moderno in React + TypeScript costruito sulla api v2 di bancho.py, con classifiche, profili dei giocatori, pagine delle beatmap, clan, ricerca dei giocatori e registrazione e accesso dal sito (con supporto captcha opzionale). Mantenuto dal team di bancho.py.
• guweb (alternativa) — lo storico frontend in python mantenuto dalla community, che comunica direttamente con il database di bancho.py.

Aggiornare il tuo server

Per aggiornare la tua istanza all'ultima versione di bancho.py:

git pull

# ricostruisci l'immagine dell'applicazione con il nuovo codice
make build

# riavvia con la nuova immagine
make run  # oppure `make run-bg` per l'esecuzione in background

Le nuove migrazioni del database vengono applicate automaticamente al successivo avvio del server. I tuoi dati (MySQL, Redis, replay, screenshot, avatar) risiedono fuori dall'immagine dell'applicazione e vengono preservati tra un aggiornamento e l'altro.