Come Self-Hostare Homer su un VPS (Guida Completa)

Homer è un’applicazione web statica leggera che ti consente di creare un cruscotto personalizzato per le tue app self-hosted. Questa guida coprirà i passaggi per self-hostare Homer su un Server Privato Virtuale (VPS). Ti guideremo nell’installazione di Docker, nel pull dell’immagine di Homer e nella configurazione per il tuo utilizzo.

Scegliere un Provider VPS

Prima di immergerci nell’installazione, devi scegliere un provider VPS. Di seguito è riportato un confronto di alcune opzioni popolari che potresti considerare:

Per questa guida, ti consigliamo Hetzner Cloud per la sua convenienza e caratteristiche. Dai un’occhiata al confronto completo dei VPS per ulteriori opzioni.

Requisiti Preliminari

1. Un VPS con almeno 1 GB di RAM e sistema operativo Ubuntu o Debian.
2. Conoscenze di base di SSH e Docker.
3. Un nome di dominio che punta al tuo VPS (opzionale ma consigliato per accedere al tuo cruscotto Homer).

Passo 1: Aggiornare il Tuo VPS

SSH nel tuo VPS:

ssh user@your_vps_ip

Assicurati che il sistema sia aggiornato:

sudo apt update && sudo apt upgrade -y

Passo 2: Installare Docker

Devi installare Docker per eseguire l’applicazione Homer. Ecco come:

Installare Docker

Esegui i seguenti comandi:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce -y

Verificare l’Installazione di Docker

Controlla se Docker è stato installato correttamente:

sudo systemctl start docker
sudo systemctl enable docker
sudo docker --version

Se installato correttamente, dovrebbe essere visualizzata la versione di Docker.

Passo 3: Distribuire Homer

Ora è il momento di distribuire Homer. Crea una directory per Homer:

mkdir -p ~/homer
cd ~/homer

Pull dell’Immagine Docker di Homer

Puoi pullare l’ultima immagine di Homer utilizzando il seguente comando:

sudo docker pull b4bz/homer:latest

Creare un File di Configurazione

Crea un file di configurazione predefinito:

curl -o config.yml https://ghproxy.com/https://raw.githubusercontent.com/b4bz/homer/master/config.yml

Modifica il file config.yml per personalizzare il tuo cruscotto:

nano config.yml

Apporta le modifiche necessarie, concentrandoti sui link e sui titoli delle tue applicazioni self-hosted.

Eseguire il Contenitore Docker di Homer

Ora, è il momento di eseguire il contenitore di Homer:

sudo docker run -d \
  --name homer \
  -p 8080:8080 \
  -v ~/homer/config.yml:/www/assets/config.yml \
  b4bz/homer:latest

Homer sarà accessibile all’indirizzo http://your_vps_ip:8080. Se lo hai mappato a un dominio, utilizza quello invece.

Passo 4: Configurazione del Reverse Proxy (Opzionale)

Per rendere Homer accessibile tramite un URL più gradevole, configura un reverse proxy. Ti consigliamo di utilizzare Nginx o Traefik per questo.

Installare Nginx

sudo apt install nginx -y

Configurare Nginx

Crea un nuovo file di configurazione per Homer:

sudo nano /etc/nginx/sites-available/homer

Aggiungi la seguente configurazione, sostituendo your_domain.com:

server {
    listen 80;
    server_name your_domain.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Abilita la configurazione:

sudo ln -s /etc/nginx/sites-available/homer /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Ora, accedi a Homer attraverso il nome del tuo dominio senza specificare la porta.

FAQ

Posso personalizzare il cruscotto di Homer?

Sì, il cruscotto di Homer è altamente personalizzabile. Puoi modificare il file config.yml per cambiare il nome e l’URL di ciascun link di applicazione. Aggiungi loghi o icone per rappresentare ciascun servizio in modo più visivo. Per configurazioni complesse, fai riferimento alla documentazione di Homer su GitHub.

Cosa devo fare se riscontro problemi durante l’installazione di Docker?

Se riscontri problemi durante l’installazione di Docker, assicurati che il tuo server sia compatibile e che tu abbia l’ultima versione degli aggiornamenti di sistema per Ubuntu o Debian. Controlla la guida ufficiale di risoluzione dei problemi di Docker per errori comuni. Inoltre, impostazioni di firewall personalizzate potrebbero influenzare la connettività: assicurati che sia consentito l’accesso in uscita ai repository di Docker.

Quanto è sicuro self-hostare applicazioni come Homer?

Self-hostare applicazioni richiede misure di sicurezza. Assicurati che il tuo VPS operi con un firewall: UFW è una scelta eccellente per Ubuntu. Aggiorna regolarmente le tue applicazioni e il sistema operativo sottostante per prevenire vulnerabilità. Se esponi il tuo cruscotto a Internet, considera l’implementazione di HTTPS utilizzando Let’s Encrypt per crittografare i trasferimenti di dati.

Seguendo questa guida, puoi self-hostare efficacemente Homer su un VPS, offrendoti un accesso rapido alle tue applicazioni preferite in un cruscotto conveniente. Buon hosting!