Mitināt Ghost® Managed VPS serverī: jūsu publikācija jūsu serverī

Ko dara Ghost

Ghost ir profesionāla un atvērta publicēšanas platforma, uzrakstīta Node.js videi. Tā vienuviet apvieno to, ko neatkarīga publikācija bieži saliek no vairākiem rīkiem.

• Publicēšana: raksti, lapas, pielāgojamas tēmas, iebūvētas meklētājprogrammu optimizācijas funkcijas un domēns uz jūsu vārda.
• Dalībnieki: reģistrēšanās un pieteikšanās ar e-pastā nosūtītu saiti, bez paroles, un saturs, kas rezervēts atkarībā no katra dalībnieka līmeņa.
• Maksas abonementi: Stripe konts, kas pieslēgts jūsu vietnei, lai pārdotu savus plānus.
• Jaunumu vēstules: katru rakstu var nosūtīt pa e-pastu jūsu bezmaksas vai maksas dalībniekiem, vai segmentam, ar vienu vai vairākiem izdevumiem.
• API: dzimtais REST API, lai pieslēgtu pēc pasūtījuma veidotu vietni vai savus rīkus.

Saskaņā ar dokumentāciju produktam ir tās pašas funkcijas arī mitināšanā savā serverī. Tas, kas ap to, paliek jums: jaunumu vēstuļu sūtīšana, tīmekļa analītika, CDN un pilnas vietnes rezerves kopijas.

MIT licence un preču zīme

Ghost tiek izplatīts ar MIT licenci. Tā atļauj programmatūru izmantot, kopēt, mainīt, apvienot, publicēt, izplatīt, apakšlicencēt un pārdot ar vienu nosacījumu: katrā kopijā saglabāt autortiesību norādi un licences tekstu. Tāpēc Ghost varat darbināt uzņēmumā, pielāgot un publicēt tajā saviem klientiem, nepērkot nekādu licenci.

Licence aptver kodu. Nosaukums un logotips pieder Ghost Foundation un ir pakļauti tās preču zīmju politikai: izlasiet to, ja veidojat piedāvājumu ap programmatūru. Ghost ir Ghost Foundation reģistrēta preču zīme.

This publication is independent of and not affiliated with, authorized, sponsored, or approved by Ghost Foundation. Latviski: šī publikācija ir neatkarīga no Ghost Foundation un nav ne saistīta ar to, ne tās atļauta, ne sponsorēta, ne apstiprināta.

Ghost-CLI vai Docker Compose: divas oficiālās metodes

Projekts dokumentē divus ceļus produkcijai. Ghost-CLI ir instalācija, ko tas oficiāli iesaka, bet Docker Compose ir «preview», ko tas sauc par pavisam jaunu. Tas norāda arī, ka virzās uz šo Docker rīku komplektu, nevis attīsta Ghost-CLI, un nodrošina palīgu pārejai no viena uz otru.

Pirms sākat: domēns un serveris

Pirms instalēšanas novirziet domēnu uz serveri: sertifikāts tiek uzstādīts iestatīšanas laikā. Simafri VPS serverī apmeklētāji nonāk uz portiem 80 un 443, ar servera domēna vārdu, ar A un AAAA ierakstiem. Vietnes adrese jāraksta pilnībā, ar protokolu, piemēram, https://example.com: IP adrese izraisa kļūdas.

Papildus augstāk norādītajai atmiņai projekts nenosauc ne disku, ne slodzi: izmērs ir atkarīgs no jūsu trafika, attēliem un medijiem. Ar Managed VPS aprakstiet mums savu publikāciju, un mēs jums iesakām piemērotu izmēru.

Ghost uzstādīšana ar Ghost-CLI uz Ubuntu

Ghost-CLI lieto ar lietotāju, kas nav root un kura vārds nav ghost, jo šis vārds konfliktē ar rīku. Izveidojiet to no root konta, aizstājot user ar izvēlēto vārdu:

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

Nginx un MySQL

Atjauniniet sistēmu, uzstādiet Nginx (SSL vajadzībām vismaz 1.9.5) un MySQL. Rinda ufw atver HTTP un HTTPS, ja šis ugunsmūris ir aktīvs:

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

Jaunākajās Ubuntu versijās MySQL root konts autentificējas ar ligzdu, ko Ghost neatbalsta. Iestatiet tam paroli:

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

Node.js un Ghost-CLI

Ghost prasa Node.js 22: versijas 20, 21, 23 un jaunākas netiek atbalstītas. Projekts prasa to uzstādīt visai sistēmai šādi:

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

Instalēšanas palaišana

Ghost tiek uzstādīts savā mapē, ar konkrētu īpašnieku un tiesībām. Aizstājiet sitename ar sev tīkamu nosaukumu:

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

Komanda tad uzdod savus jautājumus, un projekts iesaka katrā piedāvātajā solī atbildēt jā:

• Blog URL: precīza vietnes adrese, ar https://.
• MySQL: localhost resursdatoram, root un iepriekš iestatītā parole, pēc tam datubāzes nosaukums, ko izveido Ghost-CLI.
• Set up a ghost MySQL user: MySQL konts, kas ierobežots ar Ghost datubāzi.
• Set up NGINX un Set up SSL: Nginx konfigurācija un Let’s Encrypt sertifikāts, kam vajadzīga e-pasta adrese.
• Set up systemd un Start Ghost: pakalpojums, kas uztur Ghost darbībā, pēc tam tā palaišana.

Vietne tad atbild, un https://example.com/ghost aicina izveidot īpašnieka kontu. Ja instalēšana tiek pārtraukta, ghost setup turpina konfigurēšanu; ja tā neizdodas, ghost uninstall notīra labāk nekā mapes dzēšana. ghost doctor jebkurā laikā pārbauda sistēmu.

Ghost uzstādīšana ar Docker Compose (preview)

Projekts šo metodi pasniedz kā «preview»: tā viņu acīs ir pavisam jauna. Tieši ar to var mitināt savā serverī tīmekļa analītiku un ActivityPub.

Serverī, kur uzstādīts Docker, iegūstiet oficiālo rīku komplektu mapē /opt/ghost un nokopējiet tā divus piemēra failus:

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

Failā .env norādiet šīs vērtības:

• DOMAIN: vietnes domēns, piemēram, example.com.
• ADMIN_DOMAIN: atsevišķs domēns administrēšanai, ja vēlaties.
• DATABASE_ROOT_PASSWORD un DATABASE_PASSWORD: divas paroles, iegūtas ar openssl rand -hex 32. Tās tiek iestatītas uz visiem laikiem: kad datubāze ir inicializēta, to maiņa pārtrauc savienojumu.
• Sadaļa SMTP Email: jūsu relejs, sīkāk aprakstīts zemāk.

Failā caddy/Caddyfile atkomentējiet bloku, kas atbilst jūsu gadījumam: novirzīšana no www uz tukšo domēnu vai otrādi, vai atsevišķs administrēšanas domēns. Pēc tam palaidiet Ghost un pabeidziet iestatīšanu adresē /ghost:

docker compose pull
docker compose up -d

• Porti: tikai Caddy publicē portus, 80 un 443, kurus var mainīt ar HTTP_PORT un HTTPS_PORT, ja Ghost nonāk aiz cita reversā starpniekservera. MySQL paliek konteineru iekšējā tīklā.
• Dati: augšupielādētie faili atrodas mapē data/ghost un datubāze mapē data/mysql, abas vietas ir pielāgojamas failā .env.
• IPv6: repozitorijs to ieslēdz pēc izvēles, jo tam vajadzīgas jaunākas Docker un Compose versijas. Tad pievienojiet -f compose.yml -f compose.ipv6.yml savām komandām docker compose up.

Tīmekļa analītika un ActivityPub

Analītikai vajadzīgs Tinybird konts, ārējs pakalpojums. No mapes /opt/ghost pieslēdzieties, izvietojiet tā konfigurāciju un iegūstiet marķierus, ko ielīmēt failā .env, sadaļā «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 darbojas uzreiz ar projekta mitināto pakalpojumu, kas ir bez maksas lietojuma ierobežojumu ietvaros, kurus publicē tā dokumentācija. Lai mitinātu savu, atkomentējiet ACTIVITYPUB_TARGET=activitypub:8080. Pēc tam failā .env ieslēdziet vajadzīgo profilu vai profilus un restartējiet konteinerus:

COMPOSE_PROFILES=analytics,activitypub

docker compose pull
docker compose up -d

ActivityPub gadījumā projekts prasa no jauna izveidot arī Ghost un Caddy, ar docker compose up -d --force-recreate ghost caddy.

Pāreja no Ghost-CLI uz Docker Compose

Pēc klonēšanas un konfigurēšanas bash scripts/migrate.sh nokopē mapi content, importē datubāzi MySQL konteinerā un startē Caddy Nginx vietā. Tas piedāvā apturēt Nginx, kas vietni padara nepieejamu: atbildiet nē, ja serverī darbojas citas vietnes. Tas neizdzēš nekādus datus. bash recovery_instructions.sh atjauno sākotnējo vietni, ja pārtraucat migrāciju.

HTTPS un administrēšanas domēns

Ghost administrēšanai jānotiek caur HTTPS, un projekts iesaka HTTPS visai vietnei: bez tā identifikatori un paroles ceļo skaidrā tekstā. Ar Docker Compose par to rūpējas Caddy. Ar Ghost-CLI sertifikātu uzstāda instalēšana, un to var izdarīt arī vēlāk ar komandu:

ghost setup ssl

Lai mainītu ar Ghost-CLI uzstādītas vietnes adresi, ghost config url https://example.com atjaunina konfigurāciju, bet ghost restart to piemēro.

Projekts iesaka arī atsevišķu administrēšanas domēnu, kas samazina uzbrukuma virsmu. Ceļš paliek /ghost/. Ghost-CLI pusē to deklarē failā config.production.json:

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

Docker Compose pusē norādiet ADMIN_DOMAIN, atkomentējiet tā bloku Caddyfile un palaidiet docker compose up -d --force-recreate ghost caddy. Arī šim domēnam vajadzīgi A un AAAA ieraksti.

MySQL 8, produkcijas datubāze

MySQL 8 ir vienīgā datubāze, ko projekts atbalsta produkcijā. Ghost-CLI uzstādās ar MySQL 8.0 vai 8.4, un Compose fails nodrošina MySQL 8.0 attēlu.

• No SQLite: projekts iesaka pilnīgu pārinstalēšanu uz MySQL 8.
• No MariaDB: tas stingri iesaka migrāciju uz MySQL 8.
• Lai pārbaudītu: ghost config database.client, vietnes mapē, norāda izmantoto datubāzi.

E-pasti un jaunumu vēstules

Ghost izšķir divus sūtījumus, kas neiet pa vienu un to pašu ceļu. Tas ir svarīgākais, kas jāiestata pēc instalēšanas.

SMTP relejs darījumu e-pastiem

Dokumentācija šo konfigurāciju klasificē kā obligātu produkcijā. Ghost sūta e-pastā arī kodu, kad konstatē pieteikšanos no jaunas ierīces: iestatiet šo releju, pirms ielūdzat savu komandu.

Simafri VPS serverī sūtīšana notiek caur autentificētu SMTP releju, izmantojot portu 587: ar jau esoša pasta konta adresi vai 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 un requireTLS: Ghost sūta ar Nodemailer, kura dokumentācija prasa secure uz false portam 587, savienojumam pēc tam pārejot uz STARTTLS. requireTLS atsaka sūtīšanu, ja šī pāreja neizdodas. Repozitorija piemēra failā norādīts ports 465 un secure=true: aizstājiet šīs divas rindas.
• Sūtītāja adrese: from satur īstu un lasītu adresi, kas pēc projekta domām uzlabo piegādi, un sūtīšanas domēna SPF, DKIM un DMARC ieraksti papildina iestatījumu.
• Pārbaude: ielūdziet komandas locekli no administrēšanas un pārbaudiet saņemšanu.

Mailgun jaunumu vēstulēm

SMTP relejs jaunumu vēstules neaptver. Saskaņā ar dokumentāciju masveida sūtīšana nenotiek ar SMTP, un Mailgun līdz šim ir vienīgais masveida sūtīšanas pakalpojums, ko Ghost atbalsta. Jūs izveidojat savu Mailgun kontu un ievadāt tā API atslēgas Ghost iestatījumos.

Ja savus rakstus nesūtāt pa e-pastu, jums nav vajadzīgs neviens Mailgun konts: šos iestatījumus var ignorēt. Ja dodat priekšroku citam jaunumu vēstuļu rīkam, projekts piedāvā sinhronizēt jūsu dalībniekus uz to, piemēram, ar Zapier vai tā integrācijas ceļvežiem.

Ghost rezerves kopijas un atjaunošana

Ghost piedāvā trīs kopiju līmeņus, un tie nesatur vienu un to pašu. Lai atjaunotu vietni identisku, projekts prasa tieši veidot datubāzes un mapes content rezerves kopiju.

Eksports atrodas sadaļā «Settings», «Advanced», «Import/Export», cilnē «Export», pogā «All data». Pilnai kopijai ar Ghost-CLI MySQL konts un datubāzes nosaukums, kas jāpārņem, ir failā 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/

Ar Docker Compose oficiālais rīku komplekts glabā saturu mapē data/ghost. Dump pārņem MySQL attēla doto formu, un root parole jau ir konteinerā. Glabājiet arī .env un Caddyfile kopiju.

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

Atjaunošana

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

Nokopējiet šos failus ārpus servera ar rsync vai scp un veiciet atjaunošanas mēģinājumu uz testa mašīnas. Ja sākat no eksporta ar maksas dalībniekiem, pieslēdziet to pašu Stripe kontu, pirms importējat savus dalībniekus.

Ghost atjaunināšana

Projekts publicē atjauninājumus katru nedēļu un atgādina, ka publiskam tīmekļa serverim jāpaliek atjauninātam. Izlasiet laidiena piezīmes, pēc tam palaidiet savas metodes komandu.

Ar Ghost-CLI

ghost check-update
ghost backup
ghost update

• Atgriešanās: ghost update --rollback atgriežas pie iepriekšējās versijas, ja atjauninājums neizdodas.
• Mape content atjauninājumu laikā paliek vietā.
• Galvenās versijas iznāk ik pēc 12 līdz 18 mēnešiem un pārtrauc saderību: dokumentācija prasa rezerves kopijas, izmaiņu izlasīšanu un tēmas saderības pārbaudi.
• Node.js: mainiet to atsevišķi no Ghost, pēc tam palaidiet ghost update [version] --force ar savu pašreizējo versiju, jo tā bināro atkarību komponenti tiek kompilēti konkrētai Node.js versijai.

Ar Docker Compose

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

Pēdējā rinda, neobligāta, noņem vecos attēlus. Atstājiet GHOST_VERSION failā .env iekomentētu: versijas fiksēšana bloķē šīs atjaunināšanas komandas.

Instances nostiprināšana un izaugsme

Dokumentācija dod vairākus iestatījumus produkcijas serverim:

• MySQL: pēc sekmīgas Ghost-CLI instalēšanas palaidiet mysql_secure_installation.
• Ugunsmūris: UFW noteikumi SSH, Nginx, HTTP un HTTPS, bez cita ugunsmūra blakus.
• SSH: pieslēgšanās tikai ar atslēgu, bez paroles un bez root konta.
• Komanda: divfaktoru autentifikāciju padara obligātu visām pieteikšanās reizēm sadaļā «Settings», «Staff».

Slodzei projekts pirms Ghost novieto CDN un kešatmiņas slāni. Tas precizē, ka klasterizācija un sharding netiek atbalstīti: vietni apkalpo viena instance, un kešatmiņa uzņem trafiku.

Kurš ko dara Managed VPS serverī

Mitināšana savā serverī prasa uzturēt serveri papildus lietojumprogrammai. Ar Managed VPS mūsu komandas uzņemas serveri un proaktīvi seko jūsu instancei; Ghost paliek jūsu programmatūra ar saviem iestatījumiem un datiem.

Ja vēlaties, lai mūsu komandas iejaucas pašā lietojumprogrammā, šis pakalpojums tiek rēķināts par stundu vai par fiksētu summu, ar novērtējumu, kas paziņots pirms iejaukšanās.