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

Lo self-hosting di strumenti di gestione dei container è diventato sempre più popolare tra sviluppatori e appassionati di homelab. Yacht, un’interfaccia moderna e leggera per la gestione di Docker, offre un modo semplificato per controllare container, immagini e reti Docker. Questa guida fornisce un processo passo passo per installare e eseguire Yacht su un VPS, aiutandoti a sfruttare strumenti open-source per i tuoi progetti self-hosted.

Perché Self-Hostare Yacht?

Yacht semplifica la gestione dei container Docker offrendo un’interfaccia visiva, rendendo più facile distribuire, monitorare e risolvere problemi delle applicazioni containerizzate. Ospitare Yacht su un VPS permette di avere una soluzione affidabile, economica e sempre attiva per il tuo ecosistema self-hosted.

Scegliere il VPS Giusto

Seleziona un provider di VPS in base al budget e alla posizione. Le opzioni più comuni includono:

Per una panoramica completa di tutti i provider, consulta il confronto completo dei VPS. Qui, useremo Hetzner Cloud come esempio per il suo rapporto prezzo-prestazioni.

Prerequisiti

• Conoscenza di base del terminal di Linux
• VPS con Ubuntu 22.04 LTS o simile
• Accesso SSH con privilegi di root o sudo
• Nome di dominio (opzionale ma consigliato per SSL)

Passo 1: Preparare il VPS

Connessione via SSH:

ssh root@tuo-vps-ip

Aggiorna il sistema:

apt update && apt upgrade -y

Installa Docker e Docker Compose:

apt install -y docker.io docker-compose
systemctl enable --now docker

Verifica che Docker sia in esecuzione:

docker --version
docker-compose --version

Passo 2: Creare il file Docker Compose per Yacht

Crea una directory per Yacht:

mkdir -p ~/yacht && cd ~/yacht

Crea docker-compose.yml:

version: '3'

services:
  yacht:
    image: selfhostedpro/yacht:latest
    container_name: yacht
    ports:
      - "8080:8080"
    restart: unless-stopped
    environment:
      - TZ=Europe/Berlin

Regola il fuso orario (TZ) secondo necessità.

Passo 3: Avviare il Container Yacht

Avvia il container:

docker-compose up -d

Controlla lo stato del container:

docker ps

Una volta in esecuzione, Yacht sarà accessibile tramite http://tuo-vps-ip:8080.

Passo 4: Configurare Yacht per il Tuo Ambiente

Apri il browser e vai a http://tuo-vps-ip:8080. Vedrai l’interfaccia di Yacht.

• Imposta una password o attiva l’autenticazione.
• Modifica le impostazioni per migliorare la sicurezza, come configurare SSL con un reverse proxy (ad esempio Nginx).

Passo 5: Proteggere la Tua Instanza di Yacht (Consigliato)

Usa Certbot con Nginx per abilitare HTTPS:

1. Installa Nginx:

apt install -y nginx

2. Configura Nginx come reverse proxy:

server {
  listen 80;
  server_name tuo-dominio.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;
  }
}

3. Ottieni SSL:

apt install -y certbot python3-certbot-nginx
certbot --nginx -d tuo-dominio.com

Aggiorna la configurazione di Nginx per supportare SSL e ricarica:

systemctl reload nginx

Ora puoi accedere a Yacht in modo sicuro tramite HTTPS.

Suggerimenti Aggiuntivi

• Fai regolarmente il backup della configurazione di Yacht.
• Mantieni aggiornato l’immagine Docker di Yacht:

docker-compose pull
docker-compose up -d

• Considera di integrare Yacht con altre app self-hosted per l’automazione, come Portainer o Heimdall.

Domande Frequenti

1. Come posso installare Yacht su un VPS usando Docker?

Per installare Yacht usando Docker, crea un file docker-compose.yml che punti all’ultima immagine di Yacht e esegui docker-compose up -d. Questo metodo semplifica la gestione e gli aggiornamenti. Assicurati sempre che il tuo setup Docker sia sicuro e aggiornato, specialmente esposto a internet.

2. Yacht è adatto per gestire più Docker host?

Yacht gestisce i container Docker su un singolo host. Per configurazioni multi-host, considera strumenti come Portainer o Rancher, che possono orchestrare più nodi. Yacht è ideale se gestisci container su un singolo VPS o server homelab.

3. Posso automatizzare gli aggiornamenti di Yacht?

Sì. Esegui il pull dell’immagine più recente e riavvia il container:

docker-compose pull
docker-compose up -d

Puoi automatizzare questa procedura con cron o pipeline CI/CD. Testa sempre gli aggiornamenti in un ambiente di staging prima di applicarli in produzione, per evitare disservizi.

Conclusione

Lo self-hosting di Yacht su un VPS offre una piattaforma potente e leggera per la gestione dei container, ideale per sviluppatori e self-hosters. Scegliendo un VPS economico da provider come Hetzner o Contabo, puoi eseguire Yacht in modo affidabile e conveniente. Segui questa guida per configurare, proteggere e mantenere efficacemente la tua istanza self-hosted di Yacht.

Per ulteriori idee di self-hosting e best practice, esplora la lista awesome-selfhosted e la community r/selfhosted. Buon self-hosting!