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

Hvad Ghost gør

Ghost er en professionel og fri publiceringsplatform, skrevet til Node.js. Den samler på ét sted, hvad en uafhængig publikation ofte sætter sammen af flere værktøjer.

• Publiceringen: artikler, sider, tilpasselige temaer, indbyggede funktioner til søgemaskineoptimering og et domæne i dit navn.
• Medlemmerne: tilmelding og login via et link sendt pr. e-mail, uden adgangskode, og indhold forbeholdt efter hvert medlems niveau.
• De betalte abonnementer: en Stripe-konto knyttet til dit website til salg af dine abonnementsformer.
• Nyhedsbrevene: hver artikel kan sendes pr. e-mail til dine gratis eller betalende medlemmer eller til et segment, med ét eller flere nyhedsbreve.
• API'erne: et indbygget REST-API til at forbinde et skræddersyet website eller dine egne værktøjer.

Ifølge dokumentationen har produktet de samme funktioner i selvhosting. Det, der omgiver det, er dit eget ansvar: afsendelse af nyhedsbreve, webanalyse, et CDN og komplette backup af websitet.

MIT-licensen og varemærket

Ghost udgives under MIT-licensen. Den tillader at bruge, kopiere, ændre, sammenflette, udgive, distribuere, underlicensiere og sælge softwaren på én betingelse: at bevare copyright-meddelelsen og licensteksten i enhver kopi. Du kan altså køre Ghost i din virksomhed, tilpasse den og udgive for dine kunder med den uden at skulle købe en licens.

Licensen dækker koden. Navnet og logoet tilhører Ghost Foundation og hører under dets varemærkepolitik: læs den, hvis du bygger et tilbud op omkring softwaren. Ghost er et registreret varemærke tilhørende Ghost Foundation.

This publication is independent of and not affiliated with, authorized, sponsored, or approved by Ghost Foundation. På dansk: denne publikation er uafhængig af Ghost Foundation og er hverken tilknyttet, godkendt, sponsoreret eller bekræftet af den.

Ghost-CLI eller Docker Compose: to officielle metoder

Projektet dokumenterer to veje til produktion. Ghost-CLI er den installation, det officielt anbefaler, og Docker Compose er en «preview», som det selv kalder helt ny. Det oplyser også, at det bevæger sig mod dette Docker-værktøj frem for at videreudvikle Ghost-CLI, og det leverer en guide til at gå fra den ene til den anden.

Før du begynder: domænet og serveren

Lad domænet pege på serveren før installationen: certifikatet installeres under opsætningen. På en Simafri VPS kommer de besøgende ind på port 80 og 443, under serverens domænenavn, med A- og AAAA-records. Websitets adresse skrives fuldt ud, med sin protokol, som https://example.com: en IP-adresse giver fejl.

Ud over den hukommelse, der er angivet ovenfor, opgiver projektet hverken disk eller belastning: størrelsen afhænger af din trafik, dine billeder og dine medier. På en Managed VPS beskriver du blot din publikation for os, og vi anbefaler den størrelse, der passer.

Installér Ghost med Ghost-CLI på Ubuntu

Ghost-CLI bruges med en bruger, der ikke er root, og hvis navn ikke er ghost, fordi dette navn er i konflikt med værktøjet. Opret den fra root-kontoen, og erstat user med det valgte navn:

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

Nginx og MySQL

Opdatér systemet, og installér Nginx (mindst 1.9.5 til SSL) og MySQL. Linjen med ufw åbner HTTP og HTTPS, hvis denne firewall er 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å nyere versioner af Ubuntu godkendes MySQL's root-konto via socket, hvilket Ghost ikke understøtter. Giv den en adgangskode:

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

Node.js og Ghost-CLI

Ghost kræver Node.js 22: versionerne 20, 21, 23 og senere understøttes ikke. Projektet beder om at installere den for hele systemet på denne måde:

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

Start installationen

Ghost installeres i sin egen mappe, med en bestemt ejer og bestemte rettigheder. Erstat sitename med det navn, du vælger:

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

Kommandoen stiller derefter sine spørgsmål, og projektet anbefaler at svare ja til hvert foreslået trin:

• Blog URL: websitets præcise adresse, med https://.
• MySQL: localhost som vært, root og den adgangskode, der blev sat ovenfor, derefter databasens navn, som Ghost-CLI opretter.
• Set up a ghost MySQL user: en MySQL-konto, der er begrænset til Ghosts database.
• Set up NGINX og Set up SSL: Nginx-konfigurationen og certifikatet fra Let's Encrypt, som kræver en e-mailadresse.
• Set up systemd og Start Ghost: tjenesten, der holder Ghost kørende, og derefter dens opstart.

Websitet svarer nu, og https://example.com/ghost inviterer dig til at oprette ejerens konto. Hvis installationen afbrydes, genoptager ghost setup konfigurationen; hvis den fejler, rydder ghost uninstall bedre op end at slette mappen. ghost doctor kontrollerer systemet når som helst.

Installér Ghost med Docker Compose (preview)

Projektet præsenterer denne metode som en «preview»: den er helt ny i dets øjne. Det er den, der gør det muligt selv at hoste webanalyse og ActivityPub.

På en server, hvor Docker er installeret, henter du det officielle værktøj i /opt/ghost og kopierer dets to eksempelfiler:

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

I filen .env angiver du disse værdier:

• DOMAIN: websitets domæne, for eksempel example.com.
• ADMIN_DOMAIN: et separat domæne til administrationen, hvis du ønsker det.
• DATABASE_ROOT_PASSWORD og DATABASE_PASSWORD: to adgangskoder trukket med openssl rand -hex 32. De fastlægges én gang for alle: når databasen er initialiseret, ødelægger det forbindelsen at ændre dem.
• Afsnittet SMTP Email: dit relay, beskrevet nærmere længere nede.

I caddy/Caddyfile fjerner du kommentarmarkeringen fra den blok, der svarer til dit tilfælde: omdirigering fra www til det nøgne domæne eller omvendt, eller separat administrationsdomæne. Start derefter Ghost, og afslut opsætningen på /ghost:

docker compose pull
docker compose up -d

• Portene: kun Caddy publicerer porte, 80 og 443, som kan ændres med HTTP_PORT og HTTPS_PORT, hvis Ghost kommer bag en anden reverse proxy. MySQL forbliver på containernes interne netværk.
• Dataene: de uploadede filer ligger i data/ghost og databasen i data/mysql, to placeringer, der kan indstilles i .env.
• IPv6: repositoryet slår det til som valgmulighed, fordi det kræver nyere versioner af Docker og Compose. Tilføj i så fald -f compose.yml -f compose.ipv6.yml til dine kommandoer docker compose up.

Webanalyse og ActivityPub

Analysen kræver en Tinybird-konto, en ekstern tjeneste. Fra /opt/ghost logger du ind, udruller dens konfiguration og henter de tokens, der skal indsættes i .env, afsnittet «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 fungerer straks med den tjeneste, projektet selv hoster, gratis inden for brugsgrænser, som dens dokumentation offentliggør. For selv at hoste din egen fjerner du kommentarmarkeringen fra ACTIVITYPUB_TARGET=activitypub:8080. Slå derefter den eller de ønskede profiler til i .env, og start containerne igen:

COMPOSE_PROFILES=analytics,activitypub

docker compose pull
docker compose up -d

Til ActivityPub beder projektet om også at genskabe Ghost og Caddy, med docker compose up -d --force-recreate ghost caddy.

Fra Ghost-CLI til Docker Compose

Efter kloningen og konfigurationen kopierer bash scripts/migrate.sh mappen content, importerer databasen i MySQL-containeren og starter Caddy i stedet for Nginx. Det foreslår at stoppe Nginx, hvilket tager websitet offline: svar nej, hvis andre websites kører på serveren. Det sletter ingen data. bash recovery_instructions.sh genopretter det oprindelige website, hvis du afbryder migreringen.

HTTPS og administrationsdomæne

Ghosts administration skal gå via HTTPS, og projektet anbefaler HTTPS for hele websitet: uden det sendes loginoplysninger og adgangskoder i klartekst. Med Docker Compose klarer Caddy det. Med Ghost-CLI installerer installationen certifikatet, og en kommando gør det bagefter:

ghost setup ssl

For at ændre adressen på et website installeret med Ghost-CLI opdaterer ghost config url https://example.com konfigurationen, og ghost restart anvender den.

Projektet anbefaler også et separat administrationsdomæne, som mindsker angrebsfladen. Stien forbliver /ghost/. Med Ghost-CLI angives det i config.production.json:

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

Med Docker Compose angiver du ADMIN_DOMAIN, fjerner kommentarmarkeringen fra dens blok i Caddyfile og kører docker compose up -d --force-recreate ghost caddy. Dette domæne har også brug for sine A- og AAAA-records.

MySQL 8, produktionsdatabasen

MySQL 8 er den eneste database, som projektet understøtter i produktion. Ghost-CLI installeres med MySQL 8.0 eller 8.4, og Compose-filen leverer et MySQL 8.0-image.

• Fra SQLite: projektet anbefaler en fuld nyinstallation på MySQL 8.
• Fra MariaDB: det anbefaler kraftigt migrering til MySQL 8.
• For at kontrollere: ghost config database.client, i websitets mappe, viser, hvilken database der bruges.

E-mails og nyhedsbreve

Ghost skelner mellem to former for afsendelse, som ikke går samme vej. Det er det vigtigste punkt at få sat op efter installationen.

SMTP-relayet, til transaktionelle e-mails

Dokumentationen klassificerer denne konfiguration som påkrævet i produktion. Ghost sender også en kode pr. e-mail, når det registrerer et login fra en ny enhed: indstil dette relay, før du inviterer dit team.

På en Simafri VPS går afsendelsen gennem et autentificeret SMTP-relay på port 587: adressen på en mailkonto, du allerede 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 og requireTLS: Ghost sender via Nodemailer, hvis dokumentation kræver secure sat til false på port 587, hvor forbindelsen derefter skifter til STARTTLS. requireTLS afviser afsendelsen, hvis dette skift fejler. Repositoryets eksempelfil angiver port 465 og secure=true: erstat disse to linjer.
• Afsenderadressen: from bærer en rigtig adresse, der bliver læst, hvilket ifølge projektet forbedrer leveringen, og afsenderdomænets SPF-, DKIM- og DMARC-records fuldender indstillingen.
• Testen: inviter et medlem af teamet fra administrationen, og kontrollér, at invitationen modtages.

Mailgun, til nyhedsbreve

SMTP-relayet dækker ikke nyhedsbreve. Ifølge dokumentationen sker masseudsendelse ikke via SMTP, og Mailgun er i dag den eneste tjeneste til masseudsendelse, som Ghost understøtter. Du opretter din Mailgun-konto og indtaster dens API-nøgler i Ghosts indstillinger.

Hvis du ikke sender dine artikler pr. e-mail, har du ikke brug for nogen Mailgun-konto: disse indstillinger kan ignoreres. Hvis du foretrækker et andet nyhedsbrevsværktøj, foreslår projektet at synkronisere dine medlemmer til det, for eksempel med Zapier eller dets integrationsguider.

Backup og gendannelse af Ghost

Ghost tilbyder tre niveauer af kopi, og de indeholder ikke det samme. For at genopbygge et website identisk beder projektet om at tage backup direkte af databasen og mappen content.

Eksporten findes under «Settings», «Advanced», «Import/Export», fanen «Export», knappen «All data». Til den komplette kopi, med Ghost-CLI, står MySQL-kontoen og databasens navn, som skal overføres, 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 opbevarer det officielle værktøj indholdet i data/ghost. Dumpet følger den form, MySQL-imaget giver, og root-adgangskoden findes allerede i containeren. Behold også en kopi af .env og 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

Gendan

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

Kopiér disse filer væk fra serveren med rsync eller scp, og lav en prøvegendannelse på en testmaskine. Hvis du starter forfra fra en eksport med betalende medlemmer, skal du tilslutte den samme Stripe-konto, før du importerer dine medlemmer.

Opdatér Ghost

Projektet udgiver opdateringer hver uge og minder om, at en offentlig webserver skal holdes opdateret. Læs versionsnoterne, og kør derefter kommandoen for din metode.

Med Ghost-CLI

ghost check-update
ghost backup
ghost update

• Vejen tilbage: ghost update --rollback vender tilbage til den forrige version, hvis en opdatering går galt.
• Mappen content bliver, hvor den er, under opdateringerne.
• Hovedversionerne kommer hver 12. til 18. måned og bryder kompatibiliteten: dokumentationen beder om backup, gennemlæsning af ændringerne og kontrol af temaets kompatibilitet.
• Node.js: skift den separat fra Ghost, og kør derefter ghost update [version] --force med din nuværende version, for dens binære afhængigheder er kompileret til en bestemt version af Node.js.

Med Docker Compose

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

Den sidste linje, som er valgfri, fjerner de gamle images. Lad GHOST_VERSION stå som kommentar i .env: at fastlåse en version blokerer disse opdateringskommandoer.

Styrk din instans og lad den vokse

Dokumentationen giver flere indstillinger til en server i produktion:

• MySQL: kør mysql_secure_installation efter en vellykket Ghost-CLI-installation.
• Firewallen: UFW-regler for SSH, Nginx, HTTP og HTTPS, uden en anden firewall ved siden af.
• SSH: login kun med nøgle, uden adgangskode og uden root-konto.
• Teamet: tofaktorgodkendelse gøres obligatorisk for alle logins under «Settings», «Staff».

Til belastningen placerer projektet et CDN og et cachelag foran Ghost. Det præciserer, at clustering og sharding ikke understøttes: én enkelt instans betjener websitet, og cachen tager trafikken.

Hvem gør hvad på en Managed VPS

Selvhosting kræver, at du holder serveren ud over selve applikationen. På en Managed VPS tager vores teams sig af serveren og følger din instans proaktivt; Ghost forbliver din software, med dens indstillinger og data.

Hvis du foretrækker, at vores teams griber ind i selve applikationen, faktureres den ydelse pr. time eller som fast pris, med et overslag oplyst før indgrebet.