Ospitare Ghost® su un VPS gestito: la vostra pubblicazione, sul vostro server

Che cosa fa Ghost

Ghost è una piattaforma di pubblicazione professionale e libera, scritta per Node.js. Riunisce in un unico posto ciò che una pubblicazione indipendente assembla spesso a partire da più strumenti.

• La pubblicazione: articoli, pagine, temi personalizzabili, funzioni SEO integrate e dominio a vostro nome.
• I membri: iscrizione e accesso tramite un link inviato per e-mail, senza password, e contenuti riservati in base al livello di ciascun membro.
• Gli abbonamenti a pagamento: un account Stripe collegato al vostro sito per vendere le vostre formule.
• Le newsletter: ogni articolo può partire per e-mail verso i vostri membri gratuiti o a pagamento, oppure verso un segmento, con una o più newsletter.
• Le API: un'API REST nativa, per collegare un sito su misura o i vostri strumenti.

Secondo la documentazione, il prodotto ha le stesse funzioni in self-hosting. Ciò che lo circonda spetta a voi: l'invio delle newsletter, l'analytics web, una CDN e i backup completi del sito.

La licenza MIT e il marchio

Ghost è pubblicato con licenza MIT. Autorizza a usare, copiare, modificare, unire, pubblicare, distribuire, concedere in sublicenza e vendere il software, a una condizione: conservare la nota di copyright e il testo della licenza in ogni copia. Potete quindi far girare Ghost in azienda, adattarlo e pubblicarvi per i vostri clienti, senza alcuna licenza da acquistare.

La licenza copre il codice. Il nome e il logo appartengono a Ghost Foundation e dipendono dalla sua politica sul marchio: leggetela se costruite un'offerta attorno al software. Ghost è un marchio registrato di Ghost Foundation.

This publication is independent of and not affiliated with, authorized, sponsored, or approved by Ghost Foundation. In italiano: questa pubblicazione è indipendente da Ghost Foundation e non è affiliata, autorizzata, sponsorizzata né approvata da essa.

Ghost-CLI o Docker Compose: due metodi ufficiali

Il progetto documenta due strade per la produzione. Ghost-CLI è l'installazione che raccomanda ufficialmente, e Docker Compose è una «preview», che definisce del tutto nuova. Indica anche di avanzare verso questo strumentario Docker anziché far evolvere Ghost-CLI, e fornisce una procedura guidata per passare dall'uno all'altro.

Prima di iniziare: il dominio e il server

Fate puntare il dominio al server prima dell'installazione: il certificato viene installato durante la configurazione. Su un VPS Simafri, i visitatori arrivano sulle porte 80 e 443, con il nome di dominio del server, tramite record A e AAAA. L'indirizzo del sito si scrive per intero, con il suo protocollo, come https://example.com: un indirizzo IP provoca errori.

Oltre alla memoria indicata qui sopra, il progetto non indica né il disco né il carico: la taglia dipende dal vostro traffico, dalle vostre immagini e dai vostri media. Su un VPS gestito, descrivetici la vostra pubblicazione e vi raccomandiamo la taglia adatta.

Installare Ghost con Ghost-CLI su Ubuntu

Ghost-CLI si usa con un utente che non sia root e il cui nome non sia ghost, perché questo nome entra in conflitto con lo strumento. Createlo dall'account root, sostituendo user con il nome scelto:

adduser <user>
usermod -aG sudo <user>
su - <user>

Nginx e MySQL

Aggiornate il sistema, installate Nginx (1.9.5 come minimo per SSL) e MySQL. La riga ufw apre HTTP e HTTPS se questo firewall è attivo:

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install nginx
sudo ufw allow 'Nginx Full'
sudo apt-get install mysql-server

Sulle versioni recenti di Ubuntu, l'account root di MySQL si autentica tramite socket, cosa che Ghost non supporta. Assegnategli una password:

sudo mysql
ALTER USER 'root'@'localhost' IDENTIFIED WITH 'caching_sha2_password' BY '<your-new-root-password>';
FLUSH PRIVILEGES;
exit

Node.js e Ghost-CLI

Ghost richiede Node.js 22: le versioni 20, 21, 23 e successive non sono supportate. Il progetto chiede di installarlo per tutto il sistema, in questo modo:

sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
NODE_MAJOR=22
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list
sudo apt-get update
sudo apt-get install nodejs -y
sudo npm install ghost-cli@latest -g

Avviare l'installazione

Ghost si installa nella propria cartella, con un proprietario e permessi precisi. Sostituite sitename con il nome che preferite:

sudo mkdir -p /var/www/sitename
sudo chown <user>:<user> /var/www/sitename
sudo chmod 775 /var/www/sitename
cd /var/www/sitename
ghost install

Il comando pone allora le sue domande, e il progetto raccomanda di rispondere sì a ogni passaggio proposto:

• Blog URL: l'indirizzo esatto del sito, con https://.
• MySQL: localhost per l'host, root e la password impostata sopra, poi il nome del database, che Ghost-CLI crea.
• Set up a ghost MySQL user: un account MySQL limitato al database di Ghost.
• Set up NGINX e Set up SSL: la configurazione di Nginx e il certificato Let's Encrypt, che richiede un indirizzo e-mail.
• Set up systemd e Start Ghost: il servizio che mantiene Ghost in funzione, poi il suo avvio.

Il sito risponde allora, e https://example.com/ghost vi invita a creare l'account del proprietario. Se l'installazione viene interrotta, ghost setup riprende la configurazione; se fallisce, ghost uninstall pulisce meglio dell'eliminazione della cartella. ghost doctor verifica il sistema in qualsiasi momento.

Installare Ghost con Docker Compose (preview)

Il progetto presenta questo metodo come una «preview»: ai suoi occhi è del tutto nuovo. È l'unico che consente di ospitare in proprio l'analytics web e ActivityPub.

Su un server in cui Docker è installato, scaricate lo strumentario ufficiale in /opt/ghost e copiate i suoi due file di esempio:

git clone https://github.com/TryGhost/ghost-docker.git /opt/ghost && cd /opt/ghost
cp .env.example .env
cp caddy/Caddyfile.example caddy/Caddyfile

Nel file .env, compilate questi valori:

• DOMAIN: il dominio del sito, per esempio example.com.
• ADMIN_DOMAIN: un dominio separato per l'amministrazione, se lo desiderate.
• DATABASE_ROOT_PASSWORD e DATABASE_PASSWORD: due password generate con openssl rand -hex 32. Si fissano una volta per tutte: una volta inizializzato il database, cambiarle interrompe la connessione.
• La sezione SMTP Email: il vostro relay, descritto più avanti.

In caddy/Caddyfile, decommentate il blocco che corrisponde al vostro caso: reindirizzamento da www al dominio senza prefisso, o l'inverso, oppure dominio di amministrazione separato. Avviate poi Ghost e completate la configurazione su /ghost:

docker compose pull
docker compose up -d

• Le porte: solo Caddy pubblica delle porte, 80 e 443, modificabili con HTTP_PORT e HTTPS_PORT se Ghost passa dietro un altro reverse proxy. MySQL resta sulla rete interna dei container.
• I dati: i file caricati vivono in data/ghost e il database in data/mysql, due percorsi regolabili nel .env.
• IPv6: il repository lo attiva su richiesta, perché richiede versioni più recenti di Docker e di Compose. Aggiungete allora -f compose.yml -f compose.ipv6.yml ai vostri comandi docker compose up.

L'analytics web e ActivityPub

L'analytics richiede un account Tinybird, servizio esterno. Da /opt/ghost, accedete, distribuite la sua configurazione e recuperate i token da incollare nel .env, sezione «Tinybird configuration»:

docker compose run --rm tinybird-login
docker compose run --rm tinybird-sync
docker compose run --rm tinybird-deploy
docker compose run --rm tinybird-login get-tokens

ActivityPub funziona subito con il servizio ospitato dal progetto, gratuito entro limiti d'uso che la sua documentazione pubblica. Per ospitare il vostro, decommentate ACTIVITYPUB_TARGET=activitypub:8080. Attivate poi nel .env il profilo o i profili desiderati, poi riavviate i container:

COMPOSE_PROFILES=analytics,activitypub

docker compose pull
docker compose up -d

Per ActivityPub, il progetto chiede di ricreare anche Ghost e Caddy, con docker compose up -d --force-recreate ghost caddy.

Passare da Ghost-CLI a Docker Compose

Dopo la clonazione e la configurazione, bash scripts/migrate.sh copia la cartella content, importa il database nel container MySQL e avvia Caddy al posto di Nginx. Propone di fermare Nginx, il che mette il sito offline: rispondete no se sul server girano altri siti. Non elimina alcun dato. bash recovery_instructions.sh ripristina il sito d'origine se interrompete la migrazione.

HTTPS e dominio di amministrazione

L'amministrazione di Ghost deve passare da HTTPS, e il progetto raccomanda HTTPS per tutto il sito: senza di esso, identificativi e password circolano in chiaro. Con Docker Compose, se ne occupa Caddy. Con Ghost-CLI, l'installazione installa il certificato, e un comando lo fa anche in un secondo momento:

ghost setup ssl

Per cambiare l'indirizzo di un sito installato con Ghost-CLI, ghost config url https://example.com aggiorna la configurazione, e ghost restart la applica.

Il progetto consiglia anche un dominio di amministrazione separato, che riduce la superficie d'attacco. Il percorso resta /ghost/. Lato Ghost-CLI, si dichiara in config.production.json:

"admin": {
  "url": "https://admin.example.com"
}

Lato Docker Compose, compilate ADMIN_DOMAIN, decommentate il suo blocco nel Caddyfile e lanciate docker compose up -d --force-recreate ghost caddy. Anche questo dominio ha bisogno dei suoi record A e AAAA.

MySQL 8, il database di produzione

MySQL 8 è l'unico database che il progetto supporta in produzione. Ghost-CLI si installa con MySQL 8.0 o 8.4, e il file Compose fornisce un'immagine MySQL 8.0.

• Da SQLite: il progetto raccomanda una reinstallazione completa su MySQL 8.
• Da MariaDB: raccomanda vivamente la migrazione a MySQL 8.
• Per verificare: ghost config database.client, nella cartella del sito, indica il database in uso.

Le e-mail e le newsletter

Ghost distingue due invii, che non passano dallo stesso percorso. È il punto più importante da impostare dopo l'installazione.

Il relay SMTP, per le e-mail transazionali

La documentazione classifica questa configurazione come obbligatoria in produzione. Ghost invia anche un codice per e-mail quando rileva un accesso da un nuovo dispositivo: impostate questo relay prima di invitare il vostro team.

Su un VPS Simafri, l'invio passa da un relay SMTP autenticato, sulla porta 587: l'indirizzo di un account di posta che avete già, oppure Simafri Suite.

"mail": {
  "transport": "SMTP",
  "from": "'Acme Support' <support@example.com>",
  "options": {
    "host": "smtp.example.com",
    "port": 587,
    "secure": false,
    "requireTLS": true,
    "auth": {
      "user": "support@example.com",
      "pass": "1234567890"
    }
  }
}

mail__transport=SMTP
mail__options__host=smtp.example.com
mail__options__port=587
mail__options__secure=false
mail__options__requireTLS=true
mail__options__auth__user=support@example.com
mail__options__auth__pass=1234567890
mail__from="'Acme Support' <support@example.com>"

docker compose up -d --force-recreate ghost

• secure e requireTLS: Ghost invia tramite Nodemailer, la cui documentazione richiede secure su false sulla porta 587, con la connessione che passa poi in STARTTLS. requireTLS rifiuta l'invio se questo passaggio fallisce. Il file di esempio del repository indica la porta 465 e secure=true: sostituite queste due righe.
• L'indirizzo di mittente: from contiene un indirizzo reale e letto, il che migliora la recapitabilità secondo il progetto, e i record SPF, DKIM e DMARC del dominio di invio completano l'impostazione.
• La prova: invitate un membro del team dall'amministrazione e verificate la ricezione.

Mailgun, per le newsletter

Il relay SMTP non copre le newsletter. Secondo la documentazione, l'invio massivo non si fa in SMTP e Mailgun è, a oggi, l'unico servizio di invio massivo che Ghost supporta. Create il vostro account Mailgun e inserite le sue chiavi API nelle impostazioni di Ghost.

Se non inviate i vostri articoli per e-mail, non vi serve alcun account Mailgun: queste impostazioni si ignorano. Se preferite un altro strumento di newsletter, il progetto propone di sincronizzare i vostri membri verso di esso, per esempio con Zapier o con le sue guide di integrazione.

Salvare e ripristinare Ghost

Ghost offre tre livelli di copia, e non contengono la stessa cosa. Per ricostruire un sito identico, il progetto chiede di salvare direttamente il database e la cartella content.

L'esportazione si trova in «Settings», «Advanced», «Import/Export», scheda «Export», pulsante «All data». Per la copia completa, con Ghost-CLI, l'account MySQL e il nome del database da riportare sono in config.production.json:

mkdir -p ~/ghost-backups
mysqldump -u ghost_user -p ghost_production > ~/ghost-backups/ghost_backup.sql
cd /var/www/sitename
tar czf ~/ghost-backups/ghost_content_backup.tar.gz content/

Con Docker Compose, lo strumentario ufficiale conserva i contenuti in data/ghost. Il dump riprende la forma data dall'immagine MySQL, e la password root è già nel container. Conservate anche una copia di .env e del Caddyfile.

cd /opt/ghost
mkdir -p ~/ghost-backups
docker compose exec -T db sh -c 'exec mysqldump -uroot -p"$MYSQL_ROOT_PASSWORD" ghost' > ~/ghost-backups/ghost_backup.sql
tar czf ~/ghost-backups/ghost_content_backup.tar.gz data/ghost

Ripristinare

cd /var/www/sitename
ghost stop
mysql -u ghost_user -p ghost_production < ~/ghost-backups/ghost_backup.sql
tar xzf ~/ghost-backups/ghost_content_backup.tar.gz
sudo chown -R ghost:ghost content
ghost restart

cd /opt/ghost
docker compose stop ghost
docker compose exec -T db sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD" ghost' < ~/ghost-backups/ghost_backup.sql
tar xzf ~/ghost-backups/ghost_content_backup.tar.gz
docker compose start ghost

Copiate questi file fuori dal server, con rsync o scp, e fate una prova di ripristino su una macchina di test. Se ripartite da un'esportazione con membri a pagamento, collegate lo stesso account Stripe prima di importare i vostri membri.

Aggiornare Ghost

Il progetto pubblica aggiornamenti ogni settimana e ricorda che un server web pubblico deve restare aggiornato. Leggete le note di rilascio, poi lanciate il comando del vostro metodo.

Con Ghost-CLI

ghost check-update
ghost backup
ghost update

• Il ritorno indietro: ghost update --rollback torna alla versione precedente se un aggiornamento va male.
• La cartella content resta al suo posto durante gli aggiornamenti.
• Le versioni maggiori arrivano ogni 12-18 mesi e rompono la compatibilità: la documentazione chiede backup, la lettura delle modifiche e il controllo della compatibilità del tema.
• Node.js: cambiatelo separatamente da Ghost, poi lanciate ghost update [version] --force con la vostra versione attuale, perché le sue dipendenze binarie sono compilate per una versione precisa di Node.js.

Con Docker Compose

cd /opt/ghost
git pull
docker compose pull
docker compose up -d
docker image prune

L'ultima riga, facoltativa, elimina le vecchie immagini. Lasciate GHOST_VERSION commentato nel .env: fissare una versione blocca questi comandi di aggiornamento.

Rafforzare e far crescere la vostra istanza

La documentazione indica diverse impostazioni per un server in produzione:

• MySQL: lanciate mysql_secure_installation dopo un'installazione Ghost-CLI riuscita.
• Il firewall: regole UFW per SSH, Nginx, HTTP e HTTPS, senza altri firewall accanto.
• SSH: accesso solo con chiave, senza password, e senza account root.
• Il team: l'autenticazione a due fattori si rende obbligatoria per tutti gli accessi in «Settings», «Staff».

Per il carico, il progetto colloca una CDN e uno strato di cache davanti a Ghost. Precisa che il clustering e lo sharding non sono supportati: una sola istanza serve il sito, e la cache assorbe il traffico.

Chi fa che cosa su un VPS gestito

Il self-hosting richiede di occuparsi del server oltre che dell'applicazione. Su un VPS gestito, i nostri team prendono in carico il server e seguono la vostra istanza in modo proattivo; Ghost resta il vostro software, con le sue impostazioni e i suoi dati.

Se preferite che i nostri team intervengano nell'applicazione stessa, questa prestazione si fattura a ore o a forfait, con un preventivo comunicato prima dell'intervento.