Näin hostaatte Ghost®in Managed VPS:llä: julkaisunne omalla palvelimellanne

Mitä Ghost tekee

Ghost on ammattimainen avoimen lähdekoodin julkaisualusta, joka on kirjoitettu Node.js:lle. Se kokoaa yhteen paikkaan sen, minkä itsenäinen julkaisu usein kokoaa useista työkaluista.

• Julkaiseminen: artikkelit, sivut, muokattavat teemat, sisäänrakennetut hakukoneoptimoinnin toiminnot ja oma verkkotunnus.
• Jäsenet: rekisteröityminen ja kirjautuminen sähköpostitse lähetettävällä linkillä ilman salasanaa sekä jäsenen tason mukaan rajattu sisältö.
• Maksulliset tilaukset: sivustoonne liitetty Stripe-tili tilausvaihtoehtojenne myymiseen.
• Uutiskirjeet: jokainen artikkeli voi lähteä sähköpostitse maksuttomille tai maksaville jäsenillenne tai segmentille, yhdellä tai useammalla uutiskirjeellä.
• Rajapinnat: natiivi REST-rajapinta räätälöidyn sivuston tai omien työkalujenne liittämiseen.

Dokumentaation mukaan tuotteella on omassa hostauksessa samat toiminnot. Sen ympärillä oleva jää teille: uutiskirjeiden lähetys, verkkoanalytiikka, CDN ja sivuston täydelliset varmuuskopiot.

MIT-lisenssi ja tavaramerkki

Ghost julkaistaan MIT-lisenssillä. Se sallii ohjelman käyttämisen, kopioimisen, muokkaamisen, yhdistämisen, julkaisemisen, jakelun, alilisensoinnin ja myymisen yhdellä ehdolla: tekijänoikeusmerkintä ja lisenssin teksti säilytetään jokaisessa kopiossa. Voitte siis ajaa Ghostia yrityksessä, mukauttaa sitä ja julkaista sillä asiakkaillenne ilman ostettavaa lisenssiä.

Lisenssi kattaa koodin. Nimi ja logo kuuluvat Ghost Foundationille ja sen tavaramerkkikäytännölle: lukekaa se, jos rakennatte tarjouksen ohjelmiston ympärille. Ghost on Ghost Foundationin rekisteröity tavaramerkki.

This publication is independent of and not affiliated with, authorized, sponsored, or approved by Ghost Foundation. Suomeksi: tämä julkaisu on riippumaton Ghost Foundationista, eikä se ole sidoksissa siihen eikä sen valtuuttama, sponsoroima tai hyväksymä.

Ghost-CLI vai Docker Compose: kaksi virallista menetelmää

Projekti dokumentoi kaksi tietä tuotantoon. Ghost-CLI on asennus, jota se virallisesti suosittelee, ja Docker Compose on ”preview”, jonka se kertoo olevan aivan uusi. Se kertoo myös etenevänsä kohti tätä Docker-työkalustoa sen sijaan, että kehittäisi Ghost-CLI:tä, ja tarjoaa ohjatun toiminnon siirtymiseen toisesta toiseen.

Ennen aloittamista: verkkotunnus ja palvelin

Osoittakaa verkkotunnus palvelimeen ennen asennusta: varmenne asennetaan käyttöönoton aikana. Simafrin VPS:llä kävijät saapuvat portteihin 80 ja 443 palvelimen verkkotunnuksella, A- ja AAAA-tietueilla. Sivuston osoite kirjoitetaan kokonaan protokollineen, kuten https://example.com: IP-osoite aiheuttaa virheitä.

Edellä mainitun muistin lisäksi projekti ei ilmoita levyn eikä kuorman tarvetta: koko riippuu liikenteestänne, kuvistanne ja medioistanne. Managed VPS -palvelimella kuvailkaa meille julkaisunne, niin suosittelemme sopivaa kokoa.

Ghostin asennus Ghost-CLI:llä Ubuntulla

Ghost-CLI:tä käytetään käyttäjällä, joka ei ole root ja jonka nimi ei ole ghost, koska tämä nimi on ristiriidassa työkalun kanssa. Luokaa se root-tililtä korvaten user valitsemallanne nimellä:

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

Nginx ja MySQL

Päivittäkää järjestelmä, asentakaa Nginx (vähintään 1.9.5 SSL:ää varten) ja MySQL. Rivi ufw avaa HTTP:n ja HTTPS:n, jos tämä palomuuri on käytössä:

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

Ubuntun uusissa versioissa MySQL:n root-tili todentautuu socketilla, mitä Ghost ei tue. Antakaa sille salasana:

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

Node.js ja Ghost-CLI

Ghost vaatii Node.js 22:n: versiot 20, 21, 23 ja sitä uudemmat eivät ole tuettuja. Projekti pyytää asentamaan sen koko järjestelmään tällä tavalla:

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

Asennuksen käynnistäminen

Ghost asennetaan omaan kansioonsa, tietyllä omistajalla ja tietyin oikeuksin. Korvatkaa sitename valitsemallanne nimellä:

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

Komento esittää sitten kysymyksensä, ja projekti suosittelee vastaamaan kyllä jokaiseen ehdotettuun vaiheeseen:

• Blog URL: sivuston tarkka osoite, https:// mukaan lukien.
• MySQL: localhost isännäksi, root ja edellä asetettu salasana, sitten tietokannan nimi, jonka Ghost-CLI luo.
• Set up a ghost MySQL user: Ghostin tietokantaan rajattu MySQL-tili.
• Set up NGINX ja Set up SSL: Nginxin asetukset ja Let’s Encrypt -varmenne, joka kysyy sähköpostiosoitetta.
• Set up systemd ja Start Ghost: palvelu, joka pitää Ghostin käynnissä, ja sen käynnistys.

Sivusto vastaa nyt, ja osoite https://example.com/ghost kehottaa luomaan omistajan tilin. Jos asennus keskeytyy, ghost setup jatkaa määritystä; jos se epäonnistuu, ghost uninstall siivoaa paremmin kuin kansion poistaminen. ghost doctor tarkistaa järjestelmän milloin tahansa.

Ghostin asennus Docker Composella (preview)

Projekti esittelee tämän menetelmän ”previewna”: sen mielestä se on aivan uusi. Juuri sillä voi hostata itse verkkoanalytiikan ja ActivityPubin.

Hakekaa palvelimella, jolle Docker on asennettu, virallinen työkalusto kansioon /opt/ghost ja kopioikaa sen kaksi esimerkkitiedostoa:

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

Täyttäkää tiedostoon .env nämä arvot:

• DOMAIN: sivuston verkkotunnus, esimerkiksi example.com.
• ADMIN_DOMAIN: erillinen verkkotunnus ylläpitoa varten, jos haluatte.
• DATABASE_ROOT_PASSWORD ja DATABASE_PASSWORD: kaksi salasanaa, jotka on luotu komennolla openssl rand -hex 32. Ne lukitaan kertaheitolla: kun tietokanta on alustettu, niiden vaihtaminen rikkoo yhteyden.
• Osio SMTP Email: releenne, jota käsitellään jäljempänä.

Poistakaa tiedostossa caddy/Caddyfile kommentit siitä lohkosta, joka vastaa tilannettanne: www-osoitteen uudelleenohjaus paljaaseen verkkotunnukseen tai päinvastoin, tai erillinen ylläpidon verkkotunnus. Käynnistäkää sitten Ghost ja viimeistelkää käyttöönotto osoitteessa /ghost:

docker compose pull
docker compose up -d

• Portit: vain Caddy julkaisee portteja, 80 ja 443, muutettavissa muuttujilla HTTP_PORT ja HTTPS_PORT, jos Ghost asetetaan toisen käänteisen välityspalvelimen taakse. MySQL pysyy konttien sisäisessä verkossa.
• Tiedot: lähetetyt tiedostot ovat kansiossa data/ghost ja tietokanta kansiossa data/mysql, kaksi paikkaa, jotka voi säätää tiedostossa .env.
• IPv6: repositorio ottaa sen käyttöön valinnaisesti, koska se vaatii Dockerin ja Composen uudempia versioita. Lisätkää silloin -f compose.yml -f compose.ipv6.yml komentoihinne docker compose up.

Verkkoanalytiikka ja ActivityPub

Analytiikka vaatii Tinybird-tilin, ulkoisen palvelun. Kirjautukaa kansiosta /opt/ghost, ottakaa sen asetukset käyttöön ja hakekaa tunnukset, jotka liimataan tiedostoon .env, osioon ”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 toimii heti projektin hostaamalla palvelulla, joka on maksuton sen dokumentaation julkaisemien käyttörajojen puitteissa. Hostataksenne oman, poistakaa kommentit riviltä ACTIVITYPUB_TARGET=activitypub:8080. Ottakaa sitten tiedostossa .env käyttöön haluamanne profiili tai profiilit ja käynnistäkää kontit uudelleen:

COMPOSE_PROFILES=analytics,activitypub

docker compose pull
docker compose up -d

ActivityPubia varten projekti pyytää luomaan uudelleen myös Ghostin ja Caddyn komennolla docker compose up -d --force-recreate ghost caddy.

Siirtyminen Ghost-CLI:stä Docker Composeen

Kloonauksen ja määrityksen jälkeen bash scripts/migrate.sh kopioi kansion content, tuo tietokannan MySQL-konttiin ja käynnistää Caddyn Nginxin tilalle. Se ehdottaa Nginxin pysäyttämistä, mikä vie sivuston pois verkosta: vastatkaa ei, jos palvelimella pyörii muita sivustoja. Se ei poista mitään tietoja. bash recovery_instructions.sh palauttaa alkuperäisen sivuston, jos keskeytätte siirron.

HTTPS ja ylläpidon verkkotunnus

Ghostin ylläpidon on kuljettava HTTPS:n kautta, ja projekti suosittelee HTTPS:ää koko sivustolle: ilman sitä tunnukset ja salasanat kulkevat selkokielisinä. Docker Composella Caddy huolehtii siitä. Ghost-CLI:llä asennus asentaa varmenteen, ja yksi komento tekee sen jälkikäteen:

ghost setup ssl

Ghost-CLI:llä asennetun sivuston osoitteen vaihtamiseksi ghost config url https://example.com päivittää asetukset ja ghost restart ottaa ne käyttöön.

Projekti neuvoo myös erillistä ylläpidon verkkotunnusta, joka pienentää hyökkäyspintaa. Polku pysyy /ghost/. Ghost-CLI:n puolella se ilmoitetaan tiedostossa config.production.json:

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

Docker Composen puolella täyttäkää ADMIN_DOMAIN, poistakaa kommentit sen lohkosta Caddyfilessa ja ajakaa docker compose up -d --force-recreate ghost caddy. Tämäkin verkkotunnus tarvitsee omat A- ja AAAA-tietueensa.

MySQL 8, tuotannon tietokanta

MySQL 8 on ainoa tietokanta, jota projekti tukee tuotannossa. Ghost-CLI asennetaan MySQL 8.0:n tai 8.4:n kanssa, ja Compose-tiedosto toimittaa MySQL 8.0 -imagen.

• SQLitestä: projekti suosittelee täydellistä uudelleenasennusta MySQL 8:lle.
• MariaDB:stä: se suosittelee painokkaasti siirtymistä MySQL 8:aan.
• Tarkistaminen: ghost config database.client sivuston kansiossa kertoo käytetyn tietokannan.

Sähköpostit ja uutiskirjeet

Ghost erottaa kaksi lähetystä, jotka eivät kulje samaa reittiä. Se on tärkein asia säätää asennuksen jälkeen.

SMTP-rele transaktiosähköposteille

Dokumentaatio luokittelee tämän asetuksen tuotannossa vaadituksi. Ghost lähettää myös koodin sähköpostitse, kun se havaitsee kirjautumisen uudelta laitteelta: säätäkää tämä rele ennen tiiminne kutsumista.

Simafrin VPS:llä lähetys kulkee todennetun SMTP-releen kautta portissa 587: käyttöön sopii jo omistamanne sähköpostitilin osoite tai 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 ja requireTLS: Ghost lähettää Nodemailerilla, jonka dokumentaatio pyytää asettamaan secure-arvon false portissa 587, jolloin yhteys siirtyy sen jälkeen STARTTLS:ään. requireTLS kieltäytyy lähettämästä, jos siirtyminen epäonnistuu. Repositorion esimerkkitiedosto ilmoittaa portin 465 ja secure=true: korvatkaa nämä kaksi riviä.
• Lähettäjän osoite: from sisältää todellisen ja luetun osoitteen, mikä parantaa projektin mukaan toimitusvarmuutta, ja lähetysverkkotunnuksen SPF-, DKIM- ja DMARC-tietueet täydentävät asetuksen.
• Testaus: kutsukaa tiimin jäsen ylläpidosta ja varmistakaa, että viesti saapuu perille.

Mailgun uutiskirjeille

SMTP-rele ei kata uutiskirjeitä. Dokumentaation mukaan massalähetystä ei tehdä SMTP:llä, ja Mailgun on tällä hetkellä ainoa massalähetyspalvelu, jota Ghost tukee. Luotte oman Mailgun-tilinne ja syötätte sen API-avaimet Ghostin asetuksiin.

Jos ette lähetä artikkeleitanne sähköpostitse, ette tarvitse Mailgun-tiliä: nämä asetukset ohitetaan. Jos pidätte toisesta uutiskirjetyökalusta, projekti ehdottaa synkronoimaan jäsenenne siihen, esimerkiksi Zapierilla tai sen integraatio-oppailla.

Ghostin varmuuskopiointi ja palautus

Ghost tarjoaa kolme kopiointitasoa, eivätkä ne sisällä samaa. Sivuston rakentamiseksi uudelleen identtisenä projekti pyytää varmuuskopioimaan suoraan tietokannan ja kansion content.

Vienti löytyy kohdasta ”Settings”, ”Advanced”, ”Import/Export”, välilehti ”Export”, painike ”All data”. Täydellistä kopiota varten Ghost-CLI:llä MySQL-tili ja siirrettävä tietokannan nimi ovat tiedostossa 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/

Docker Composella virallinen työkalusto säilyttää sisällön kansiossa data/ghost. Dump noudattaa MySQL-imagen antamaa muotoa, ja root-salasana on jo kontissa. Säilyttäkää myös kopio tiedostoista .env ja 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

Palauttaminen

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

Kopioikaa nämä tiedostot palvelimen ulkopuolelle komennolla rsync tai scp ja tehkää palautuskokeilu testikoneella. Jos aloitatte uudelleen viennistä, jossa on maksavia jäseniä, yhdistäkää sama Stripe-tili ennen jäsentenne tuontia.

Ghostin päivittäminen

Projekti julkaisee päivityksiä joka viikko ja muistuttaa, että julkisen verkkopalvelimen on pysyttävä ajan tasalla. Lukekaa julkaisutiedot ja ajakaa sitten menetelmänne komento.

Ghost-CLI:llä

ghost check-update
ghost backup
ghost update

• Paluu: ghost update --rollback palaa edelliseen versioon, jos päivitys menee pieleen.
• Kansio content pysyy paikallaan päivitysten aikana.
• Pääversiot tulevat 12-18 kuukauden välein ja rikkovat yhteensopivuuden: dokumentaatio pyytää varmuuskopioita, muutosten lukemista ja teeman yhteensopivuuden tarkistamista.
• Node.js: vaihtakaa se erikseen Ghostista ja ajakaa sitten ghost update [version] --force nykyisellä versiollanne, koska sen binääririippuvuudet on käännetty tietylle Node.js-versiolle.

Docker Composella

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

Viimeinen rivi, valinnainen, poistaa vanhat imaget. Jättäkää GHOST_VERSION kommentoiduksi tiedostossa .env: version kiinnittäminen estää nämä päivityskomennot.

Instanssinne vahvistaminen ja kasvattaminen

Dokumentaatio antaa useita asetuksia tuotantopalvelimelle:

• MySQL: ajakaa mysql_secure_installation onnistuneen Ghost-CLI-asennuksen jälkeen.
• Palomuuri: UFW-säännöt SSH:lle, Nginxille, HTTP:lle ja HTTPS:lle, ilman muuta palomuuria rinnalla.
• SSH: kirjautuminen vain avaimella, ilman salasanaa ja ilman root-tiliä.
• Tiimi: kaksivaiheinen tunnistautuminen tehdään pakolliseksi kaikille kirjautumisille kohdassa ”Settings”, ”Staff”.

Kuormaa varten projekti asettaa CDN:n ja välimuistikerroksen Ghostin eteen. Se täsmentää, ettei klusterointia eikä sharding-jakoa tueta: yksi instanssi palvelee sivustoa, ja välimuisti vastaanottaa liikenteen.

Kuka tekee mitä Managed VPS:llä

Oma hostaus vaatii palvelimen ylläpitoa sovelluksen lisäksi. Managed VPS -palvelimella tiimimme huolehtivat palvelimesta ja seuraavat instanssianne proaktiivisesti; Ghost pysyy teidän ohjelmananne asetuksineen ja tietoineen.

Jos haluatte tiimiemme toimivan itse sovelluksessa, tämä palvelu laskutetaan tuntiveloituksella tai kiinteällä hinnalla, ja arvio annetaan ennen toimenpidettä.