Hostati Ghost® na Managed VPS-u: vaša publikacija na vašem poslužitelju

Što radi Ghost

Ghost je profesionalna i slobodna platforma za objavljivanje, napisana za Node.js. Na jednom mjestu okuplja ono što neovisna publikacija često sklapa iz više alata.

• Objavljivanje: članci, stranice, teme koje se mogu prilagoditi, ugrađene SEO funkcije i domena na vaše ime.
• Članovi: registracija i prijava putem poveznice poslane e-poštom, bez lozinke, te sadržaj rezerviran prema razini svakog člana.
• Plaćene pretplate: Stripe račun povezan s vašim web-mjestom za prodaju vaših paketa.
• Newsletteri: svaki članak može otići e-poštom vašim besplatnim ili plaćenim članovima ili nekom segmentu, s jednim ili više biltena.
• API-ji: izvorni REST API, za povezivanje web-mjesta po mjeri ili vaših vlastitih alata.

Prema dokumentaciji, proizvod ima iste funkcije i na vlastitom poslužitelju. Ono što ga okružuje ostaje na vama: slanje newslettera, web-analitika, CDN i potpune sigurnosne kopije web-mjesta.

Licenca MIT i žig

Ghost je objavljen pod licencom MIT. Ona dopušta upotrebu, kopiranje, izmjenu, spajanje, objavljivanje, distribuciju, podlicenciranje i prodaju softvera, uz jedan uvjet: napomena o autorskim pravima i tekst licence moraju ostati u svakoj kopiji. Ghost stoga možete pokretati u tvrtki, prilagođavati ga i u njemu objavljivati za svoje klijente, bez kupnje licence.

Licenca pokriva kod. Naziv i logotip pripadaju zakladi Ghost Foundation i podliježu njezinoj politici žigova: pročitajte je ako gradite ponudu oko softvera. Ghost je registrirani žig zaklade Ghost Foundation.

This publication is independent of and not affiliated with, authorized, sponsored, or approved by Ghost Foundation. Na hrvatskom: ova je publikacija neovisna o zakladi Ghost Foundation i nije povezana s njom, niti ju je ona odobrila, ovlastila ili sponzorirala.

Ghost-CLI ili Docker Compose: dvije službene metode

Projekt dokumentira dva puta za produkciju. Ghost-CLI je instalacija koju službeno preporučuje, a Docker Compose je „preview”, koji naziva sasvim novim. Navodi i da se kreće prema tom Docker alatu, a ne prema daljnjem razvoju Ghost-CLI-ja, te daje čarobnjak za prelazak s jednog na drugi.

Prije početka: domena i poslužitelj

Domenu usmjerite na poslužitelj prije instalacije: certifikat se postavlja tijekom podešavanja. Na Simafri VPS-u posjetitelji stižu na portove 80 i 443, pod nazivom domene poslužitelja, s A i AAAA zapisima. Adresa web-mjesta piše se u cijelosti, s protokolom, poput https://example.com: IP adresa uzrokuje pogreške.

Povrh gore navedene memorije, projekt ne navodi ni disk ni opterećenje: veličina ovisi o vašem prometu, slikama i medijima. Na Managed VPS-u opišite nam svoju publikaciju, a mi vam preporučujemo odgovarajuću veličinu.

Instalacija Ghosta s Ghost-CLI-jem na Ubuntuu

Ghost-CLI koristi se s korisnikom koji nije root i čije ime nije ghost, jer se to ime sukobljava s alatom. Izradite ga iz računa root, zamijenivši user odabranim imenom:

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

Nginx i MySQL

Ažurirajte sustav, instalirajte Nginx (najmanje 1.9.5 za SSL) i MySQL. Redak ufw otvara HTTP i HTTPS ako je taj vatrozid aktivan:

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

Na novijim inačicama Ubuntua račun root u MySQL-u autentificira se putem soketa, što Ghost ne podržava. Dodijelite mu lozinku:

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

Node.js i Ghost-CLI

Ghost traži Node.js 22: inačice 20, 21, 23 i novije nisu podržane. Projekt traži da ga instalirate za cijeli sustav, ovako:

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

Pokretanje instalacije

Ghost se instalira u vlastitu mapu, s točno određenim vlasnikom i pravima. Zamijenite sitename imenom po svom izboru:

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

Naredba tada postavlja pitanja, a projekt preporučuje da na svaki predloženi korak odgovorite potvrdno:

• Blog URL: točna adresa web-mjesta, s https://.
• MySQL: localhost za host, root i lozinka postavljena gore, a zatim naziv baze, koju izrađuje Ghost-CLI.
• Set up a ghost MySQL user: MySQL račun ograničen na bazu Ghosta.
• Set up NGINX i Set up SSL: konfiguracija Nginxa i certifikat Let’s Encrypt, koji traži adresu e-pošte.
• Set up systemd i Start Ghost: usluga koja drži Ghost u radu, a zatim njegovo pokretanje.

Web-mjesto tada odgovara, a https://example.com/ghost poziva vas da izradite račun vlasnika. Ako se instalacija prekine, ghost setup nastavlja konfiguraciju; ako ne uspije, ghost uninstall čisti bolje od brisanja mape. ghost doctor u svakom trenutku provjerava sustav.

Instalacija Ghosta s Docker Composeom (preview)

Projekt ovu metodu predstavlja kao „preview”: u njegovim je očima sasvim nova. Upravo ona omogućuje web-analitiku i ActivityPub na vlastitom poslužitelju.

Na poslužitelju s instaliranim Dockerom preuzmite službeni alat u /opt/ghost i kopirajte njegove dvije datoteke s primjerima:

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

U datoteci .env upišite ove vrijednosti:

• DOMAIN: domena web-mjesta, na primjer example.com.
• ADMIN_DOMAIN: zasebna domena za administraciju, ako želite.
• DATABASE_ROOT_PASSWORD i DATABASE_PASSWORD: dvije lozinke generirane s openssl rand -hex 32. Postavljaju se jednom zauvijek: nakon inicijalizacije baze njihova promjena kvari vezu.
• Odjeljak SMTP Email: vaš relej, podrobnije u nastavku.

U caddy/Caddyfile otkomentirajte blok koji odgovara vašem slučaju: preusmjeravanje s www na golu domenu ili obrnuto, ili zasebna administracijska domena. Zatim pokrenite Ghost i dovršite postavljanje na /ghost:

docker compose pull
docker compose up -d

• Portovi: samo Caddy objavljuje portove, 80 i 443, koji se mogu mijenjati s HTTP_PORT i HTTPS_PORT ako Ghost prelazi iza drugog obrnutog proxyja. MySQL ostaje na unutarnjoj mreži kontejnera.
• Podaci: poslane datoteke žive u data/ghost, a baza u data/mysql, dvije lokacije koje se podešavaju u .env.
• IPv6: repozitorij ga uključuje po izboru, jer traži novije inačice Dockera i Composea. Tada svojim naredbama docker compose up dodajte -f compose.yml -f compose.ipv6.yml.

Web-analitika i ActivityPub

Analitika traži račun Tinybird, vanjsku uslugu. Iz /opt/ghost prijavite se, postavite njezinu konfiguraciju i preuzmite tokene koje treba zalijepiti u .env, odjeljak „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 odmah radi s uslugom koju hostira projekt, besplatnom unutar ograničenja upotrebe koja objavljuje njegova dokumentacija. Da biste hostali vlastiti, otkomentirajte ACTIVITYPUB_TARGET=activitypub:8080. Zatim u .env uključite željene profile i ponovno pokrenite kontejnere:

COMPOSE_PROFILES=analytics,activitypub

docker compose pull
docker compose up -d

Za ActivityPub projekt traži da se ponovno izrade i Ghost i Caddy, s docker compose up -d --force-recreate ghost caddy.

Prelazak s Ghost-CLI-ja na Docker Compose

Nakon kloniranja i konfiguracije, bash scripts/migrate.sh kopira mapu content, uvozi bazu u MySQL kontejner i pokreće Caddy umjesto Nginxa. Predlaže zaustavljanje Nginxa, što web-mjesto stavlja izvan mreže: odgovorite ne ako na poslužitelju rade i druga web-mjesta. Ne briše nikakve podatke. bash recovery_instructions.sh vraća izvorno web-mjesto ako prekinete migraciju.

HTTPS i administracijska domena

Administracija Ghosta mora ići preko HTTPS-a, a projekt preporučuje HTTPS za cijelo web-mjesto: bez njega korisnička imena i lozinke putuju u čistom tekstu. S Docker Composeom Caddy se brine o tome. S Ghost-CLI-jem instalacija postavlja certifikat, a naknadno to radi jedna naredba:

ghost setup ssl

Za promjenu adrese web-mjesta instaliranog s Ghost-CLI-jem, ghost config url https://example.com ažurira konfiguraciju, a ghost restart je primjenjuje.

Projekt savjetuje i zasebnu administracijsku domenu, koja smanjuje površinu napada. Putanja ostaje /ghost/. Uz Ghost-CLI deklarira se u config.production.json:

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

Uz Docker Compose upišite ADMIN_DOMAIN, otkomentirajte njegov blok u Caddyfileu i pokrenite docker compose up -d --force-recreate ghost caddy. I ovoj su domeni potrebni A i AAAA zapisi.

MySQL 8, produkcijska baza

MySQL 8 jedina je baza koju projekt podržava u produkciji. Ghost-CLI instalira se s MySQL-om 8.0 ili 8.4, a Compose datoteka daje sliku MySQL 8.0.

• Sa SQLitea: projekt preporučuje potpunu ponovnu instalaciju na MySQL 8.
• S MariaDB-a: ozbiljno preporučuje migraciju na MySQL 8.
• Za provjeru: ghost config database.client, u mapi web-mjesta, pokazuje koja se baza koristi.

E-pošta i newsletteri

Ghost razlikuje dva slanja, koja ne idu istim putem. To je najvažnija stvar za podešavanje nakon instalacije.

SMTP relej, za transakcijsku e-poštu

Dokumentacija ovu konfiguraciju svrstava među obavezne u produkciji. Ghost šalje e-poštom i kod kada otkrije prijavu s novog uređaja: podesite taj relej prije pozivanja tima.

Na Simafri VPS-u slanje ide preko autentificiranog SMTP releja, na portu 587: adresa računa e-pošte koji već imate ili 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 i requireTLS: Ghost šalje preko Nodemailera, čija dokumentacija traži secure na false na portu 587, pri čemu veza zatim prelazi na STARTTLS. requireTLS odbija slanje ako taj prijelaz ne uspije. Datoteka s primjerom iz repozitorija navodi port 465 i secure=true: zamijenite ta dva retka.
• Adresa pošiljatelja: from nosi stvarnu adresu koja se čita, što prema projektu poboljšava isporučivost, a SPF, DKIM i DMARC zapisi domene slanja upotpunjuju postavku.
• Test: pozovite člana tima iz administracije i provjerite primitak.

Mailgun, za newslettere

SMTP relej ne pokriva newslettere. Prema dokumentaciji, masovno slanje ne ide preko SMTP-a, a Mailgun je danas jedina usluga masovnog slanja koju Ghost podržava. Izradite svoj Mailgun račun i unesite njegove API ključeve u postavke Ghosta.

Ako svoje članke ne šaljete e-poštom, ne treba vam nikakav Mailgun račun: te se postavke zanemaruju. Ako više volite drugi alat za newslettere, projekt predlaže da njemu sinkronizirate svoje članove, na primjer sa Zapierom ili putem njegovih vodiča za integraciju.

Sigurnosno kopiranje i vraćanje Ghosta

Ghost nudi tri razine kopiranja, a ne sadrže isto. Da biste web-mjesto obnovili identično, projekt traži izravno sigurnosno kopiranje baze i mape content.

Izvoz se nalazi u „Settings”, „Advanced”, „Import/Export”, kartica „Export”, gumb „All data”. Za potpunu kopiju, s Ghost-CLI-jem, MySQL račun i naziv baze koje treba preuzeti nalaze se u 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/

S Docker Composeom službeni alat čuva sadržaj u data/ghost. Dump preuzima oblik koji daje MySQL slika, a lozinka root već je u kontejneru. Sačuvajte i kopiju datoteka .env i 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

Vraćanje

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

Te datoteke kopirajte izvan poslužitelja, s rsync ili scp, i napravite probno vraćanje na testnom stroju. Ako krećete od izvoza s plaćenim članovima, prije uvoza članova povežite isti Stripe račun.

Ažuriranje Ghosta

Projekt objavljuje ažuriranja svakog tjedna i podsjeća da javni web-poslužitelj mora ostati ažuran. Pročitajte bilješke o izdanju, a zatim pokrenite naredbu svoje metode.

S Ghost-CLI-jem

ghost check-update
ghost backup
ghost update

• Povratak: ghost update --rollback vraća na prethodnu inačicu ako ažuriranje krene loše.
• Mapa content ostaje na mjestu tijekom ažuriranja.
• Glavne inačice stižu svakih 12 do 18 mjeseci i narušavaju kompatibilnost: dokumentacija traži sigurnosne kopije, čitanje promjena i provjeru kompatibilnosti teme.
• Node.js: mijenjajte ga odvojeno od Ghosta, a zatim pokrenite ghost update [version] --force sa svojom trenutačnom inačicom, jer su njegove binarne ovisnosti kompilirane za određenu inačicu Node.js-a.

S Docker Composeom

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

Posljednji redak, neobavezan, uklanja stare slike. GHOST_VERSION ostavite zakomentiran u .env: fiksiranje inačice blokira te naredbe za ažuriranje.

Učvrstite svoju instancu i pripremite je za rast

Dokumentacija daje nekoliko postavki za poslužitelj u produkciji:

• MySQL: pokrenite mysql_secure_installation nakon uspješne instalacije Ghost-CLI-jem.
• Vatrozid: UFW pravila za SSH, Nginx, HTTP i HTTPS, bez drugog vatrozida pored.
• SSH: prijava samo ključem, bez lozinke i bez računa root.
• Tim: dvofaktorska autentifikacija može se učiniti obaveznom za sve prijave u „Settings”, „Staff”.

Za opterećenje projekt ispred Ghosta postavlja CDN i sloj predmemorije. Navodi da klasteriranje i sharding nisu podržani: web-mjesto poslužuje jedna instanca, a predmemorija upija promet.

Tko što radi na Managed VPS-u

Hostanje na vlastitom poslužitelju traži da uz aplikaciju održavate i poslužitelj. Na Managed VPS-u naši timovi preuzimaju poslužitelj i proaktivno prate vašu instancu; Ghost ostaje vaš softver, sa svojim postavkama i podacima.

Ako želite da naši timovi interveniraju u samoj aplikaciji, ta se usluga naplaćuje po satu ili paušalno, uz procjenu koja vam se priopćuje prije intervencije.