Ghost® hosztolása Managed VPS-en: publikációja a saját szerverén

Mit tud a Ghost

A Ghost egy professzionális, szabad publikációs platform, amelyet Node.js-re írtak. Egy helyen egyesíti azt, amit egy független kiadvány gyakran több eszközből rak össze.

• A publikálás: cikkek, oldalak, testreszabható sablonok, beépített keresőoptimalizálási funkciók és a saját nevén futó domain.
• A tagok: regisztráció és bejelentkezés e-mailben küldött linkkel, jelszó nélkül, valamint tagonként a szintjüknek megfelelő, zárt tartalmak.
• A fizetős előfizetések: a webhelyére kötött Stripe-fiók a csomagjai eladásához.
• A hírlevelek: minden cikk e-mailben elküldhető az ingyenes vagy fizető tagoknak, vagy egy szegmensnek, egy vagy több hírlevéllel.
• Az API-k: egy natív REST API, egyedi webhely vagy saját eszközök csatlakoztatásához.

A dokumentáció szerint a termék saját üzemeltetésben ugyanazokat a funkciókat nyújtja. Ami körülötte van, az Önre marad: a hírlevelek küldése, a webes analitika, egy CDN és a webhely teljes mentései.

Az MIT licenc és a védjegy

A Ghost MIT licenc alatt jelenik meg. Engedélyezi a szoftver használatát, másolását, módosítását, egyesítését, közzétételét, terjesztését, allicencelését és eladását, egyetlen feltétellel: a szerzői jogi megjelölést és a licenc szövegét meg kell tartani minden másolatban. A Ghostot tehát futtathatja vállalkozásában, igazíthatja a saját igényeihez, és publikálhat vele az ügyfelei számára, licenc vásárlása nélkül.

A licenc a kódot fedi le. A név és a logó a Ghost Foundation tulajdona, és a védjegypolitikája alá tartozik: olvassa el, ha a szoftver köré ajánlatot épít. A Ghost a Ghost Foundation bejegyzett védjegye.

This publication is independent of and not affiliated with, authorized, sponsored, or approved by Ghost Foundation. Magyarul: ez a kiadvány független a Ghost Foundationtől, nem áll vele kapcsolatban, és nem is engedélyezte, nem szponzorálta, nem hagyta jóvá.

Ghost-CLI vagy Docker Compose: két hivatalos módszer

A projekt két utat dokumentál az éles környezethez. A Ghost-CLI az a telepítés, amelyet hivatalosan ajánl, a Docker Compose pedig egy „preview”, amelyet teljesen újnak nevez. Azt is közli, hogy inkább ezen a Docker-eszköztáron halad tovább, nem a Ghost-CLI fejlesztésén, és varázslót ad az egyikről a másikra való áttéréshez.

Mielőtt hozzákezd: a domain és a szerver

A telepítés előtt irányítsa a domaint a szerverre: a tanúsítvány a beállítás közben települ. Simafri VPS-en a látogatók a 80-as és a 443-as porton érkeznek, a szerver domainnevén, A és AAAA rekordokkal. A webhely címét teljes egészében, a protokollal együtt kell megadni, például https://example.com: egy IP-cím hibákat okoz.

A fent jelzett memórián túl a projekt sem a lemezigényt, sem a terhelést nem adja meg: a méret a forgalmától, a képeitől és a médiafájljaitól függ. Egy Managed VPS esetén írja le nekünk a publikációját, és mi azt a méretet javasoljuk, amely megfelel.

A Ghost telepítése Ghost-CLI-vel Ubuntun

A Ghost-CLI-t nem root felhasználóval kell használni, akinek a neve nem ghost, mert ez a név ütközik az eszközzel. Hozza létre a root fiókból, a user helyére a választott nevet írva:

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

Nginx és MySQL

Frissítse a rendszert, telepítse az Nginxet (az SSL-hez legalább 1.9.5-ös verzió kell) és a MySQL-t. Az ufw sor megnyitja a HTTP-t és a HTTPS-t, ha ez a tűzfal aktív:

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

Az Ubuntu újabb verzióin a MySQL root fiókja socketen keresztül hitelesít, amit a Ghost nem támogat. Adjon neki jelszót:

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

Node.js és Ghost-CLI

A Ghost Node.js 22-t igényel: a 20-as, a 21-es, a 23-as és az azt követő verziók nem támogatottak. A projekt azt kéri, hogy az egész rendszerre telepítse, így:

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

A telepítés indítása

A Ghost a saját mappájába települ, meghatározott tulajdonossal és jogokkal. A sitename helyére írja a választott nevet:

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

A parancs ezután kérdéseket tesz fel, a projekt pedig azt ajánlja, hogy minden felajánlott lépésre igennel válaszoljon:

• Blog URL: a webhely pontos címe, https:// előtaggal.
• MySQL: localhost a gazdagéphez, root és a fent beállított jelszó, majd az adatbázis neve, amelyet a Ghost-CLI létrehoz.
• Set up a ghost MySQL user: egy MySQL-fiók, amely a Ghost adatbázisára van korlátozva.
• Set up NGINX és Set up SSL: az Nginx beállítása és a Let’s Encrypt-tanúsítvány, amelyhez e-mail-cím kell.
• Set up systemd és Start Ghost: a szolgáltatás, amely a Ghostot futtatva tartja, majd az indítása.

A webhely ekkor válaszol, a https://example.com/ghost címen pedig a tulajdonosi fiók létrehozására hívják. Ha a telepítés megszakad, a ghost setup folytatja a beállítást; ha meghiúsul, a ghost uninstall jobban takarít, mint a mappa törlése. A ghost doctor bármikor ellenőrzi a rendszert.

A Ghost telepítése Docker Compose-zal (preview)

A projekt ezt a módszert „preview”-ként mutatja be: a szemében teljesen új. Ez teszi lehetővé a webes analitika és az ActivityPub önálló üzemeltetését.

Egy olyan szerveren, ahol a Docker telepítve van, töltse le a hivatalos eszköztárat az /opt/ghost mappába, és másolja le a két példafájlját:

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

A .env fájlban adja meg ezeket az értékeket:

• DOMAIN: a webhely domainje, például example.com.
• ADMIN_DOMAIN: külön domain az adminisztrációhoz, ha szeretné.
• DATABASE_ROOT_PASSWORD és DATABASE_PASSWORD: két jelszó, amelyet az openssl rand -hex 32 paranccsal generál. Egyszer s mindenkorra rögzítendők: az adatbázis inicializálása után a módosításuk megszakítja a kapcsolatot.
• Az SMTP Email szakasz: az Ön továbbítója, lejjebb részletezve.

A caddy/Caddyfile fájlban vegye ki a megjegyzésből az Ön esetének megfelelő blokkot: a www átirányítása a „csupasz” domainre vagy fordítva, illetve külön adminisztrációs domain. Ezután indítsa el a Ghostot, majd fejezze be a beállítást a /ghost címen:

docker compose pull
docker compose up -d

• A portok: csak a Caddy tesz közzé portokat, a 80-ast és a 443-ast, amelyek a HTTP_PORT és a HTTPS_PORT változóval módosíthatók, ha a Ghost egy másik fordított proxy mögé kerül. A MySQL a konténerek belső hálózatán marad.
• Az adatok: a feltöltött fájlok a data/ghost, az adatbázis a data/mysql mappában él, két hely, amely a .env fájlban állítható.
• IPv6: a tároló opcióként kapcsolja be, mert a Docker és a Compose újabb verzióit igényli. Ilyenkor adja hozzá a -f compose.yml -f compose.ipv6.yml kapcsolót a docker compose up parancsaihoz.

A webes analitika és az ActivityPub

Az analitikához Tinybird-fiók kell, amely külső szolgáltatás. Az /opt/ghost mappából jelentkezzen be, telepítse a konfigurációját, és szerezze meg a tokeneket, amelyeket a .env fájlba kell illeszteni, a „Tinybird configuration” szakaszba:

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

Az ActivityPub azonnal működik a projekt által üzemeltetett szolgáltatással, amely a dokumentációjában közzétett használati korlátokon belül ingyenes. Ha a saját ActivityPub-szolgáltatását szeretné önállóan üzemeltetni, vegye ki a megjegyzésből az ACTIVITYPUB_TARGET=activitypub:8080 sort. Ezután kapcsolja be a .env fájlban a kívánt profilt vagy profilokat, majd indítsa újra a konténereket:

COMPOSE_PROFILES=analytics,activitypub

docker compose pull
docker compose up -d

Az ActivityPubhoz a projekt azt kéri, hogy a Ghostot és a Caddyt is hozza létre újra, a docker compose up -d --force-recreate ghost caddy paranccsal.

Átállás Ghost-CLI-ről Docker Compose-ra

A klónozás és a beállítás után a bash scripts/migrate.sh lemásolja a content mappát, importálja az adatbázist a MySQL-konténerbe, és az Nginx helyett elindítja a Caddyt. Felajánlja az Nginx leállítását, ami offline állapotba teszi a webhelyet: válaszoljon nemmel, ha a szerveren más webhelyek is futnak. Nem töröl semmilyen adatot. A bash recovery_instructions.sh visszaállítja az eredeti webhelyet, ha megszakítja az átállást.

HTTPS és az adminisztrációs domain

A Ghost adminisztrációjának HTTPS-en kell mennie, a projekt pedig az egész webhelyre HTTPS-t ajánl: nélküle az azonosítók és a jelszavak titkosítatlanul közlekednek. Docker Compose-zal ezt a Caddy intézi. A Ghost-CLI-vel a telepítés beállítja a tanúsítványt, és utólag egy parancs is elvégzi:

ghost setup ssl

Egy Ghost-CLI-vel telepített webhely címének módosításához a ghost config url https://example.com frissíti a konfigurációt, a ghost restart pedig érvényesíti.

A projekt egy külön adminisztrációs domaint is tanácsol, amely csökkenti a támadási felületet. Az útvonal továbbra is /ghost/ marad. A Ghost-CLI oldalán a config.production.json fájlban kell megadni:

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

A Docker Compose oldalán adja meg az ADMIN_DOMAIN értékét, vegye ki a megjegyzésből a blokkját a Caddyfile-ban, és futtassa a docker compose up -d --force-recreate ghost caddy parancsot. Ennek a domainnek is szüksége van az A és AAAA rekordjaira.

MySQL 8, az éles adatbázis

A MySQL 8 az egyetlen adatbázis, amelyet a projekt éles környezetben támogat. A Ghost-CLI MySQL 8.0-val vagy 8.4-gyel települ, a Compose-fájl pedig egy MySQL 8.0 image-et biztosít.

• SQLite-ról: a projekt teljes újratelepítést javasol MySQL 8-ra.
• MariaDB-ről: határozottan a MySQL 8-ra való áttérést ajánlja.
• Az ellenőrzéshez: a ghost config database.client a webhely mappájában megmutatja a használt adatbázist.

Az e-mailek és a hírlevelek

A Ghost két küldést különböztet meg, amelyek nem ugyanazon az úton mennek. Ez a legfontosabb beállítandó dolog a telepítés után.

Az SMTP-továbbító, a tranzakciós e-mailekhez

A dokumentáció ezt a konfigurációt éles környezetben kötelezőnek minősíti. A Ghost e-mailben kódot is küld, amikor új eszközről történő bejelentkezést észlel: állítsa be ezt a továbbítót, mielőtt meghívja a csapatát.

Simafri VPS-en a küldés egy hitelesített SMTP-továbbítón keresztül megy, a 587-es porton: egy meglévő levelezési fiók címével, vagy a Simafri Suite-tal.

"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

• A secure és a requireTLS: a Ghost a Nodemailerrel küld, amelynek dokumentációja a 587-es porton a secure értékét false-ra kéri, a kapcsolat ezután STARTTLS-re vált. A requireTLS megtagadja a küldést, ha ez az áttérés meghiúsul. A tároló példafájlja a 465-ös portot és a secure=true értéket jelzi: cserélje le ezt a két sort.
• A feladó címe: a from valódi, olvasott címet tartalmaz, ami a projekt szerint javítja a kézbesíthetőséget, a küldő domain SPF-, DKIM- és DMARC-rekordjai pedig kiegészítik a beállítást.
• A teszt: hívja meg a csapat egy tagját az adminisztrációból, és ellenőrizze, megérkezik-e a levél.

Mailgun, a hírlevelekhez

Az SMTP-továbbító nem fedi le a hírleveleket. A dokumentáció szerint a tömeges küldés nem SMTP-vel történik, és a Mailgun jelenleg az egyetlen tömeges küldő szolgáltatás, amelyet a Ghost támogat. Létrehozza a Mailgun-fiókját, és megadja az API-kulcsait a Ghost beállításaiban.

Ha nem küldi el a cikkeit e-mailben, nincs szüksége Mailgun-fiókra: ezeket a beállításokat figyelmen kívül hagyhatja. Ha egy másik hírlevél-eszközt részesít előnyben, a projekt azt javasolja, hogy szinkronizálja hozzá a tagjait, például a Zapierrel vagy az integrációs útmutatóival.

A Ghost mentése és visszaállítása

A Ghost három szintű másolatot kínál, és ezek nem ugyanazt tartalmazzák. Egy webhely azonos újraépítéséhez a projekt azt kéri, hogy közvetlenül az adatbázist és a content mappát mentse.

Az export a „Settings”, „Advanced”, „Import/Export” menüben található, az „Export” lapon, az „All data” gombbal. A teljes másolathoz Ghost-CLI esetén a MySQL-fiók és az átveendő adatbázisnév a config.production.json fájlban van:

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/

Docker Compose esetén a hivatalos eszköztár a tartalmat a data/ghost mappában tartja. A dump a MySQL image által megadott formát követi, a root jelszó pedig már a konténerben van. Őrizzen másolatot a .env fájlról és a Caddyfile-ról is.

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

Visszaállítás

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

Másolja ezeket a fájlokat a szerveren kívülre, az rsync vagy az scp segítségével, és végezzen próbavisszaállítást egy tesztgépen. Ha fizető tagokat tartalmazó exportból indul újra, a tagok importálása előtt csatlakoztassa ugyanazt a Stripe-fiókot.

A Ghost frissítése

A projekt hetente ad ki frissítéseket, és emlékeztet rá, hogy egy nyilvános webszervernek naprakésznek kell maradnia. Olvassa el a kiadási megjegyzéseket, majd futtassa a módszerének megfelelő parancsot.

Ghost-CLI-vel

ghost check-update
ghost backup
ghost update

• A visszalépés: a ghost update --rollback az előző verzióra tér vissza, ha egy frissítés rosszul sül el.
• A content mappa a helyén marad a frissítések alatt.
• A főverziók 12-18 havonta érkeznek, és megtörik a kompatibilitást: a dokumentáció mentéseket, a változások elolvasását és a sablon kompatibilitásának ellenőrzését kéri.
• Node.js: a Ghosttól külön módosítsa, majd futtassa a ghost update [version] --force parancsot a jelenlegi verziójával, mert a bináris függőségei egy adott Node.js-verzióra vannak lefordítva.

Docker Compose-zal

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

Az utolsó, elhagyható sor eltávolítja a régi image-eket. Hagyja megjegyzésben a GHOST_VERSION sort a .env fájlban: egy verzió rögzítése blokkolja ezeket a frissítési parancsokat.

A példány megerősítése és növekedése

A dokumentáció több beállítást ad egy éles szerverhez:

• MySQL: egy sikeres Ghost-CLI-telepítés után futtassa a mysql_secure_installation parancsot.
• A tűzfal: UFW-szabályok az SSH-hoz, az Nginxhez, a HTTP-hez és a HTTPS-hez, más tűzfal nélkül mellette.
• SSH: csak kulccsal való bejelentkezés, jelszó nélkül és root fiók nélkül.
• A csapat: a kétlépcsős hitelesítés a „Settings”, „Staff” menüben tehető kötelezővé minden bejelentkezéshez.

A terheléshez a projekt egy CDN-t és egy gyorsítótár-réteget helyez a Ghost elé. Leszögezi, hogy a klaszterezés és a sharding nem támogatott: egyetlen példány szolgálja ki a webhelyet, a gyorsítótár pedig felfogja a forgalmat.

Ki mit csinál egy Managed VPS-en

A saját üzemeltetés az alkalmazás mellett a szerver gondozását is megköveteli. Egy Managed VPS esetén csapataink átveszik a szervert, és proaktívan követik a példányát; a Ghost továbbra is az Ön szoftvere marad, a beállításaival és az adataival.

Ha inkább azt szeretné, hogy csapataink magában az alkalmazásban avatkozzanak be, ez a szolgáltatás óradíjban vagy átalánydíjban számlázódik, a beavatkozás előtt közölt árajánlattal.