Hosta Ghost® på en Managed VPS: din publikation, på din egen server

Det Ghost gör

Ghost är en professionell och fri publiceringsplattform, skriven för Node.js. Den samlar på ett ställe det som en oberoende publikation ofta får ihop av flera olika verktyg.

• Publiceringen: artiklar, sidor, anpassningsbara teman, inbyggda funktioner för sökmotoroptimering och en domän i ditt eget namn.
• Medlemmarna: registrering och inloggning via en länk som skickas med e-post, utan lösenord, och innehåll som är reserverat efter varje medlems nivå.
• De betalda prenumerationerna: ett Stripe-konto kopplat till din webbplats för att sälja dina planer.
• Nyhetsbreven: varje artikel kan skickas med e-post till dina gratis- eller betalande medlemmar, eller till ett segment, med ett eller flera nyhetsbrev.
• API:erna: ett inbyggt REST-API, för att koppla en skräddarsydd webbplats eller dina egna verktyg.

Enligt dokumentationen har produkten samma funktioner vid självhosting. Det som omger den får du ordna själv: utskicket av nyhetsbreven, webbanalysen, ett CDN och de fullständiga säkerhetskopiorna av webbplatsen.

MIT-licensen och varumärket

Ghost publiceras under MIT-licensen. Den tillåter att använda, kopiera, ändra, sammanfoga, publicera, distribuera, vidarelicensiera och sälja programvaran, på ett villkor: upphovsrättsmeddelandet och licenstexten ska finnas kvar i varje kopia. Du kan alltså köra Ghost i ditt företag, anpassa det och publicera åt dina kunder, utan att köpa någon licens.

Licensen täcker koden. Namnet och logotypen tillhör Ghost Foundation och omfattas av dess varumärkespolicy: läs den om du bygger ett erbjudande kring programvaran. Ghost är ett registrerat varumärke som tillhör Ghost Foundation.

This publication is independent of and not affiliated with, authorized, sponsored, or approved by Ghost Foundation. På svenska: den här publikationen är oberoende av Ghost Foundation och är varken knuten till, auktoriserad av, sponsrad av eller godkänd av dem.

Ghost-CLI eller Docker Compose: två officiella metoder

Projektet dokumenterar två vägar för produktion. Ghost-CLI är den installation som det officiellt rekommenderar, och Docker Compose är en ”preview”, som det själv kallar helt ny. Det anger också att det rör sig mot den Docker-baserade verktygsuppsättningen snarare än att vidareutveckla Ghost-CLI, och det tillhandahåller en guide för att byta från det ena till det andra.

Innan du börjar: domänen och servern

Peka domänen mot servern före installationen: certifikatet installeras under uppsättningen. På en VPS från Simafri kommer besökarna in på port 80 och 443, under serverns domännamn, med A- och AAAA-poster. Webbplatsens adress skrivs fullständigt, med sitt protokoll, som https://example.com: en IP-adress ger fel.

Utöver minnet som anges ovan anger projektet varken disk eller belastning: storleken beror på din trafik, dina bilder och din media. På en Managed VPS beskriver du din publikation, så rekommenderar vi lämplig storlek.

Installera Ghost med Ghost-CLI på Ubuntu

Ghost-CLI används med en användare som inte är root, och vars namn inte är ghost, eftersom det namnet krockar med verktyget. Skapa den från root-kontot och ersätt user med det valda namnet:

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

Nginx och MySQL

Uppdatera systemet, installera Nginx (minst 1.9.5 för SSL) och MySQL. Raden ufw öppnar HTTP och HTTPS om den brandväggen är aktiv:

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

På nyare versioner av Ubuntu autentiseras MySQL:s root-konto via socket, vilket Ghost inte stöder. Ge det ett lösenord:

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

Node.js och Ghost-CLI

Ghost kräver Node.js 22: versionerna 20, 21, 23 och senare stöds inte. Projektet ber dig installera det för hela systemet, på det här sättet:

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

Starta installationen

Ghost installeras i en egen mapp, med en bestämd ägare och bestämda rättigheter. Ersätt sitename med det namn du vill ha:

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

Kommandot ställer sedan sina frågor, och projektet rekommenderar att svara ja på varje föreslaget steg:

• Blog URL: webbplatsens exakta adress, med https://.
• MySQL: localhost som värd, root och lösenordet som angavs ovan, sedan databasens namn, som Ghost-CLI skapar.
• Set up a ghost MySQL user: ett MySQL-konto som är begränsat till Ghosts databas.
• Set up NGINX och Set up SSL: konfigurationen av Nginx och certifikatet från Let’s Encrypt, som frågar efter en e-postadress.
• Set up systemd och Start Ghost: tjänsten som håller Ghost igång, sedan dess start.

Webbplatsen svarar då, och https://example.com/ghost ber dig skapa ägarens konto. Om installationen avbryts återupptar ghost setup konfigurationen; om den misslyckas städar ghost uninstall bättre än att ta bort mappen. ghost doctor kontrollerar systemet när som helst.

Installera Ghost med Docker Compose (preview)

Projektet presenterar den här metoden som en ”preview”: den är helt ny i dess ögon. Det är den som gör det möjligt att självhosta webbanalys och ActivityPub.

På en server där Docker är installerat hämtar du den officiella verktygsuppsättningen i /opt/ghost och kopierar dess två exempelfiler:

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

Fyll i de här värdena i filen .env:

• DOMAIN: webbplatsens domän, till exempel example.com.
• ADMIN_DOMAIN: en separat domän för administrationen, om du vill.
• DATABASE_ROOT_PASSWORD och DATABASE_PASSWORD: två lösenord framtagna med openssl rand -hex 32. De bestäms en gång för alla: när databasen är initierad bryter en ändring anslutningen.
• Avsnittet SMTP Email: ditt relä, beskrivet längre ned.

I caddy/Caddyfile avkommenterar du blocket som motsvarar ditt fall: omdirigering från www till den nakna domänen, eller tvärtom, eller en separat administrationsdomän. Starta sedan Ghost och slutför uppsättningen på /ghost:

docker compose pull
docker compose up -d

• Portarna: bara Caddy publicerar portar, 80 och 443, som kan ändras med HTTP_PORT och HTTPS_PORT om Ghost hamnar bakom en annan omvänd proxy. MySQL stannar på containrarnas interna nätverk.
• Data: de uppladdade filerna ligger i data/ghost och databasen i data/mysql, två platser som kan ändras i .env.
• IPv6: arkivet aktiverar det som ett alternativ, eftersom det kräver nyare versioner av Docker och Compose. Lägg då till -f compose.yml -f compose.ipv6.yml i dina kommandon docker compose up.

Webbanalys och ActivityPub

Webbanalysen kräver ett Tinybird-konto, en extern tjänst. Från /opt/ghost loggar du in, distribuerar dess konfiguration och hämtar de tokens som ska klistras in i .env, avsnittet ”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 fungerar direkt med tjänsten som projektet själv hostar, kostnadsfri inom de användningsgränser som dess dokumentation publicerar. För att självhosta din egen avkommenterar du ACTIVITYPUB_TARGET=activitypub:8080. Aktivera sedan önskad profil eller önskade profiler i .env och starta om containrarna:

COMPOSE_PROFILES=analytics,activitypub

docker compose pull
docker compose up -d

För ActivityPub ber projektet dig skapa om även Ghost och Caddy, med docker compose up -d --force-recreate ghost caddy.

Byta från Ghost-CLI till Docker Compose

Efter kloningen och konfigurationen kopierar bash scripts/migrate.sh mappen content, importerar databasen i MySQL-containern och startar Caddy i stället för Nginx. Det erbjuder sig att stoppa Nginx, vilket tar webbplatsen offline: svara nej om andra webbplatser körs på servern. Det tar inte bort några data. bash recovery_instructions.sh återställer den ursprungliga webbplatsen om du avbryter migreringen.

HTTPS och administrationsdomänen

Ghosts administration måste gå över HTTPS, och projektet rekommenderar HTTPS för hela webbplatsen: utan det går användarnamn och lösenord i klartext. Med Docker Compose sköter Caddy det. Med Ghost-CLI installerar installationen certifikatet, och ett kommando gör det i efterhand:

ghost setup ssl

För att ändra adressen på en webbplats som installerats med Ghost-CLI uppdaterar ghost config url https://example.com konfigurationen, och ghost restart tillämpar den.

Projektet råder också till en separat administrationsdomän, som minskar angreppsytan. Sökvägen förblir /ghost/. Med Ghost-CLI anges den i config.production.json:

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

Med Docker Compose fyller du i ADMIN_DOMAIN, avkommenterar dess block i Caddyfile och kör docker compose up -d --force-recreate ghost caddy. Den domänen behöver också sina A- och AAAA-poster.

MySQL 8, databasen för produktion

MySQL 8 är den enda databas som projektet stöder i produktion. Ghost-CLI installeras med MySQL 8.0 eller 8.4, och Compose-filen tillhandahåller en MySQL 8.0-avbild.

• Från SQLite: projektet rekommenderar en fullständig nyinstallation på MySQL 8.
• Från MariaDB: det rekommenderar starkt migrering till MySQL 8.
• För att kontrollera: ghost config database.client, i webbplatsens mapp, visar vilken databas som används.

E-post och nyhetsbrev

Ghost skiljer på två utskick, som inte går samma väg. Det är den viktigaste inställningen att göra efter installationen.

SMTP-reläet, för de transaktionella meddelandena

Dokumentationen klassar den här konfigurationen som obligatorisk i produktion. Ghost skickar också en kod med e-post när det upptäcker en inloggning från en ny enhet: ställ in reläet innan du bjuder in ditt team.

På en VPS från Simafri går utskicken via ett autentiserat SMTP-relä, på port 587: adressen till ett e-postkonto som du redan har, eller 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 och requireTLS: Ghost skickar via Nodemailer, vars dokumentation kräver secure satt till false på port 587, där anslutningen sedan övergår till STARTTLS. requireTLS vägrar utskicket om den övergången misslyckas. Arkivets exempelfil anger port 465 och secure=true: ersätt de två raderna.
• Avsändaradressen: from innehåller en riktig adress som läses, vilket enligt projektet förbättrar leveransen, och SPF-, DKIM- och DMARC-posterna för avsändardomänen kompletterar inställningen.
• Testet: bjud in en teammedlem från administrationen och kontrollera att meddelandet kommer fram.

Mailgun, för nyhetsbreven

SMTP-reläet täcker inte nyhetsbreven. Enligt dokumentationen sker massutskick inte via SMTP, och Mailgun är för närvarande den enda tjänst för massutskick som Ghost stöder. Du skapar ditt Mailgun-konto och anger dess API-nycklar i Ghosts inställningar.

Om du inte skickar dina artiklar med e-post behöver du inget Mailgun-konto: de inställningarna kan du bortse från. Föredrar du ett annat verktyg för nyhetsbrev föreslår projektet att synkronisera dina medlemmar till det, till exempel med Zapier eller dess integrationsguider.

Säkerhetskopiera och återställa Ghost

Ghost erbjuder tre nivåer av kopior, och de innehåller inte samma sak. För att återskapa en webbplats identiskt ber projektet dig säkerhetskopiera databasen och mappen content direkt.

Exporten finns under ”Settings”, ”Advanced”, ”Import/Export”, fliken ”Export”, knappen ”All data”. För den fullständiga kopian, med Ghost-CLI, står MySQL-kontot och databasens namn att föra över i 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/

Med Docker Compose lagrar den officiella verktygsuppsättningen innehållet i data/ghost. Dumpen följer den form som MySQL-avbilden anger, och root-lösenordet finns redan i containern. Spara också en kopia av .env och av 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

Återställa

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

Kopiera de här filerna utanför servern, med rsync eller scp, och gör ett återställningstest på en testmaskin. Om du utgår från en export med betalande medlemmar kopplar du samma Stripe-konto innan du importerar dina medlemmar.

Uppdatera Ghost

Projektet publicerar uppdateringar varje vecka och påminner om att en publik webbserver måste hållas uppdaterad. Läs versionsanteckningarna och kör sedan kommandot för din metod.

Med Ghost-CLI

ghost check-update
ghost backup
ghost update

• Vägen tillbaka: ghost update --rollback går tillbaka till föregående version om en uppdatering går fel.
• Mappen content ligger kvar under uppdateringarna.
• Huvudversionerna kommer med 12 till 18 månaders mellanrum och bryter kompatibiliteten: dokumentationen ber om säkerhetskopior, att du läser ändringarna och att du kontrollerar temats kompatibilitet.
• Node.js: byt det separat från Ghost och kör sedan ghost update [version] --force med din nuvarande version, eftersom dess binära beroenden kompileras för en bestämd version av Node.js.

Med Docker Compose

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

Den sista raden, valfri, tar bort de gamla avbilderna. Låt GHOST_VERSION vara utkommenterad i .env: en fast version blockerar de här uppdateringskommandona.

Stärka och låta din instans växa

Dokumentationen ger flera inställningar för en server i produktion:

• MySQL: kör mysql_secure_installation efter en lyckad installation med Ghost-CLI.
• Brandväggen: UFW-regler för SSH, Nginx, HTTP och HTTPS, utan någon annan brandvägg vid sidan av.
• SSH: inloggning enbart med nyckel, utan lösenord, och utan root-konto.
• Teamet: tvåfaktorsautentisering görs obligatorisk för alla inloggningar under ”Settings”, ”Staff”.

För belastningen placerar projektet ett CDN och ett cachelager framför Ghost. Det anger att klustring och sharding inte stöds: en enda instans serverar webbplatsen, och cachen tar upp trafiken.

Vem gör vad på en Managed VPS

Att självhosta innebär att sköta servern utöver applikationen. På en Managed VPS tar våra team hand om servern och följer din instans proaktivt; Ghost förblir din programvara, med sina inställningar och sina data.

Om du föredrar att våra team ingriper i själva applikationen faktureras den tjänsten per timme eller som fast pris, med en offert som lämnas före ingreppet.