Jak hostować Ghost® na Managed VPS: Państwa publikacja na Państwa serwerze

Co robi Ghost

Ghost to profesjonalna, wolna platforma publikacyjna napisana dla Node.js. Łączy w jednym miejscu to, co niezależna publikacja często składa z kilku narzędzi.

• Publikacja: artykuły, strony, motywy do dostosowania, wbudowane funkcje SEO i domena na Państwa nazwę.
• Członkowie: rejestracja i logowanie linkiem wysłanym e-mailem, bez hasła, oraz treści zastrzeżone według poziomu każdego członka.
• Płatne subskrypcje: konto Stripe podłączone do Państwa strony, aby sprzedawać swoje plany.
• Newslettery: każdy artykuł może wyjść e-mailem do członków bezpłatnych lub płatnych albo do segmentu, w jednym lub kilku biuletynach.
• API: natywne API REST, do podłączenia strony na zamówienie lub własnych narzędzi.

Według dokumentacji produkt ma te same funkcje przy samodzielnym hostingu. To, co go otacza, należy do Państwa: wysyłka newsletterów, analityka webowa, CDN i pełne kopie zapasowe strony.

Licencja MIT i znak towarowy

Ghost jest udostępniany na licencji MIT. Zezwala ona na używanie, kopiowanie, modyfikowanie, łączenie, publikowanie, rozpowszechnianie, sublicencjonowanie i sprzedaż oprogramowania, pod jednym warunkiem: w każdej kopii musi pozostać informacja o prawach autorskich i tekst licencji. Mogą więc Państwo uruchomić Ghost w firmie, dostosować go i publikować w nim dla swoich klientów, bez zakupu licencji.

Licencja obejmuje kod. Nazwa i logo należą do Ghost Foundation i podlegają jej polityce znaków towarowych: proszę ją przeczytać, jeśli budują Państwo ofertę wokół oprogramowania. Ghost jest zastrzeżonym znakiem towarowym Ghost Foundation.

This publication is independent of and not affiliated with, authorized, sponsored, or approved by Ghost Foundation. Po polsku: ta publikacja jest niezależna od Ghost Foundation i nie jest z nią powiązana, przez nią autoryzowana, sponsorowana ani zatwierdzona.

Ghost-CLI czy Docker Compose: dwie oficjalne metody

Projekt dokumentuje dwie drogi do produkcji. Ghost-CLI to instalacja, którą oficjalnie zaleca, a Docker Compose to „preview”, o której mówi, że jest zupełnie nowa. Wskazuje też, że zmierza ku temu narzędziu Docker, zamiast rozwijać Ghost-CLI, i dostarcza kreator do przejścia z jednego na drugie.

Zanim zaczną Państwo: domena i serwer

Domenę proszę skierować na serwer przed instalacją: certyfikat instaluje się w trakcie konfiguracji. Na VPS Simafri odwiedzający docierają na porty 80 i 443, pod nazwą domeny serwera, z rekordami A i AAAA. Adres strony zapisuje się w całości, z protokołem, jak https://example.com: adres IP powoduje błędy.

Poza podaną wyżej pamięcią projekt nie określa ani dysku, ani obciążenia: rozmiar zależy od ruchu, obrazów i mediów. Na Managed VPS wystarczy opisać nam swoją publikację, a polecimy odpowiedni rozmiar.

Instalacja Ghost przez Ghost-CLI na Ubuntu

Ghost-CLI używa się z użytkownikiem, który nie jest rootem, a jego nazwa nie jest ghost, ponieważ ta nazwa koliduje z narzędziem. Proszę utworzyć go z konta root, zastępując user wybraną nazwą:

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

Nginx i MySQL

Proszę zaktualizować system, zainstalować Nginx (co najmniej 1.9.5 dla SSL) i MySQL. Linia ufw otwiera HTTP i HTTPS, jeśli ta zapora jest aktywna:

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

W nowszych wersjach Ubuntu konto root MySQL uwierzytelnia się przez gniazdo, czego Ghost nie obsługuje. Proszę nadać mu hasło:

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

Node.js i Ghost-CLI

Ghost wymaga Node.js 22: wersje 20, 21, 23 i kolejne nie są obsługiwane. Projekt każe zainstalować go dla całego systemu, w ten sposób:

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

Uruchomienie instalacji

Ghost instaluje się we własnym katalogu, z określonym właścicielem i uprawnieniami. Zamiast sitename proszę wpisać wybraną nazwę:

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

Polecenie zadaje wtedy pytania, a projekt zaleca odpowiadać twierdząco na każdy proponowany krok:

• Blog URL: dokładny adres strony, z https://.
• MySQL: localhost jako host, root i hasło ustawione wyżej, a potem nazwa bazy, którą tworzy Ghost-CLI.
• Set up a ghost MySQL user: konto MySQL ograniczone do bazy Ghost.
• Set up NGINX i Set up SSL: konfiguracja Nginx i certyfikat Let’s Encrypt, który wymaga adresu e-mail.
• Set up systemd i Start Ghost: usługa utrzymująca Ghost przy życiu, a potem jego uruchomienie.

Strona odpowiada wtedy, a https://example.com/ghost zaprasza do utworzenia konta właściciela. Jeśli instalacja zostanie przerwana, ghost setup wznawia konfigurację; jeśli się nie powiedzie, ghost uninstall czyści lepiej niż usunięcie katalogu. ghost doctor sprawdza system w każdej chwili.

Instalacja Ghost przez Docker Compose (preview)

Projekt przedstawia tę metodę jako „preview”: w jego oczach jest zupełnie nowa. To ona pozwala samodzielnie hostować analitykę webową i ActivityPub.

Na serwerze z zainstalowanym Dockerem proszę pobrać oficjalne narzędzia do /opt/ghost i skopiować dwa pliki przykładowe:

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

W pliku .env proszę uzupełnić te wartości:

• DOMAIN: domena strony, na przykład example.com.
• ADMIN_DOMAIN: osobna domena administracji, jeśli Państwo sobie życzą.
• DATABASE_ROOT_PASSWORD i DATABASE_PASSWORD: dwa hasła wylosowane poleceniem openssl rand -hex 32. Ustawia się je raz na zawsze: po zainicjowaniu bazy ich zmiana psuje połączenie.
• Sekcja SMTP Email: Państwa przekaźnik, opisany niżej.

W caddy/Caddyfile proszę odkomentować blok odpowiadający Państwa przypadkowi: przekierowanie z www na domenę bez przedrostka albo odwrotnie, lub osobna domena administracji. Następnie proszę uruchomić Ghost i dokończyć konfigurację pod /ghost:

docker compose pull
docker compose up -d

• Porty: porty publikuje wyłącznie Caddy, 80 i 443, zmienne przez HTTP_PORT i HTTPS_PORT, jeśli Ghost trafi za inne odwrotne proxy. MySQL pozostaje w wewnętrznej sieci kontenerów.
• Dane: przesłane pliki znajdują się w data/ghost, a baza w data/mysql, dwa miejsca ustawiane w .env.
• IPv6: repozytorium włącza je opcjonalnie, bo wymaga nowszych wersji Dockera i Compose. Proszę wtedy dodać -f compose.yml -f compose.ipv6.yml do poleceń docker compose up.

Analityka webowa i ActivityPub

Analityka wymaga konta Tinybird, usługi zewnętrznej. Z katalogu /opt/ghost proszę zalogować się, wdrożyć jej konfigurację i pobrać tokeny do wklejenia w .env, w sekcji „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 działa od razu z usługą hostowaną przez projekt, bezpłatną w granicach limitów użycia, które publikuje jej dokumentacja. Aby samodzielnie hostować własną, proszę odkomentować ACTIVITYPUB_TARGET=activitypub:8080. Następnie w .env proszę włączyć wybrany profil lub profile i uruchomić kontenery ponownie:

COMPOSE_PROFILES=analytics,activitypub

docker compose pull
docker compose up -d

W przypadku ActivityPub projekt każe też odtworzyć Ghost i Caddy, poleceniem docker compose up -d --force-recreate ghost caddy.

Przejście z Ghost-CLI na Docker Compose

Po sklonowaniu i konfiguracji bash scripts/migrate.sh kopiuje katalog content, importuje bazę do kontenera MySQL i uruchamia Caddy zamiast Nginx. Proponuje zatrzymanie Nginx, co wyłącza stronę: jeśli na serwerze działają inne strony, proszę odpowiedzieć nie. Nie usuwa żadnych danych. bash recovery_instructions.sh przywraca pierwotną stronę, jeśli przerwą Państwo migrację.

HTTPS i domena administracji

Administracja Ghost musi działać przez HTTPS, a projekt zaleca HTTPS dla całej strony: bez niego identyfikatory i hasła krążą jawnie. W Docker Compose zajmuje się tym Caddy. W Ghost-CLI certyfikat instaluje się przy instalacji, a po fakcie robi to polecenie:

ghost setup ssl

Aby zmienić adres strony zainstalowanej przez Ghost-CLI, ghost config url https://example.com aktualizuje konfigurację, a ghost restart ją stosuje.

Projekt radzi też osobną domenę administracji, która zmniejsza powierzchnię ataku. Ścieżka pozostaje /ghost/. W Ghost-CLI deklaruje się ją w config.production.json:

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

W Docker Compose proszę wpisać ADMIN_DOMAIN, odkomentować jej blok w Caddyfile i uruchomić docker compose up -d --force-recreate ghost caddy. Ta domena również potrzebuje rekordów A i AAAA.

MySQL 8, baza produkcyjna

MySQL 8 to jedyna baza, którą projekt obsługuje w produkcji. Ghost-CLI instaluje się z MySQL 8.0 lub 8.4, a plik Compose dostarcza obraz MySQL 8.0.

• Z SQLite: projekt zaleca pełną ponowną instalację na MySQL 8.
• Z MariaDB: gorąco zaleca migrację do MySQL 8.
• Aby sprawdzić: ghost config database.client, w katalogu strony, wskazuje używaną bazę.

E-maile i newslettery

Ghost rozróżnia dwie wysyłki, które nie idą tą samą drogą. To najważniejsza rzecz do ustawienia po instalacji.

Przekaźnik SMTP, dla e-maili transakcyjnych

Dokumentacja zalicza tę konfigurację do wymaganych w produkcji. Ghost wysyła też kod e-mailem, gdy wykryje logowanie z nowego urządzenia: przekaźnik proszę ustawić przed zaproszeniem zespołu.

Na VPS Simafri wysyłka odbywa się przez uwierzytelniony przekaźnik SMTP, na porcie 587: adres posiadanego już konta pocztowego albo 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 i requireTLS: Ghost wysyła przez Nodemailer, którego dokumentacja każe ustawić secure na false na porcie 587, a połączenie przechodzi potem na STARTTLS. requireTLS odrzuca wysyłkę, jeśli to przejście się nie powiedzie. Plik przykładowy repozytorium wskazuje port 465 i secure=true: proszę zmienić te dwie linie.
• Adres nadawcy: from zawiera adres rzeczywisty i odczytywany, co według projektu poprawia dostarczalność, a rekordy SPF, DKIM i DMARC domeny wysyłkowej dopełniają ustawienia.
• Test: proszę zaprosić członka zespołu z administracji i sprawdzić odbiór.

Mailgun, dla newsletterów

Przekaźnik SMTP nie obejmuje newsletterów. Według dokumentacji wysyłka masowa nie odbywa się przez SMTP, a Mailgun jest obecnie jedyną usługą wysyłki masowej, którą Ghost obsługuje. Zakładają Państwo własne konto Mailgun i wpisują jego klucze API w ustawieniach Ghost.

Jeśli nie wysyłają Państwo artykułów e-mailem, nie potrzebują żadnego konta Mailgun: te ustawienia można pominąć. Jeśli wolą Państwo inne narzędzie do newsletterów, projekt proponuje synchronizację członków do niego, na przykład przez Zapier lub jego przewodniki integracji.

Kopia zapasowa i przywracanie Ghost

Ghost oferuje trzy poziomy kopii i nie zawierają one tego samego. Aby odtworzyć stronę identycznie, projekt każe kopiować bezpośrednio bazę i katalog content.

Eksport znajduje się w „Settings”, „Advanced”, „Import/Export”, zakładka „Export”, przycisk „All data”. Dla pełnej kopii, z Ghost-CLI, konto MySQL i nazwę bazy do przepisania podaje 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/

W Docker Compose oficjalne narzędzie przechowuje treści w data/ghost. Zrzut ma postać podaną przez obraz MySQL, a hasło root jest już w kontenerze. Proszę zachować także kopię .env i 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

Przywracanie

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

Te pliki proszę skopiować poza serwer, przez rsync lub scp, i wykonać próbę przywracania na maszynie testowej. Jeśli wracają Państwo z eksportu z płatnymi członkami, przed importem członków proszę podłączyć to samo konto Stripe.

Aktualizacja Ghost

Projekt publikuje aktualizacje co tydzień i przypomina, że publiczny serwer WWW musi pozostać aktualny. Proszę przeczytać informacje o wydaniu, a następnie uruchomić polecenie swojej metody.

Z Ghost-CLI

ghost check-update
ghost backup
ghost update

• Powrót do poprzedniej wersji: ghost update --rollback wraca do wersji poprzedniej, jeśli aktualizacja pójdzie źle.
• Katalog content pozostaje na miejscu podczas aktualizacji.
• Wersje główne pojawiają się co 12 do 18 miesięcy i łamią zgodność: dokumentacja każe zrobić kopie zapasowe, przeczytać zmiany i sprawdzić zgodność motywu.
• Node.js: proszę zmieniać go osobno od Ghost, a potem uruchomić ghost update [version] --force z Państwa obecną wersją, ponieważ jego zależności binarne są kompilowane pod konkretną wersję Node.js.

Z Docker Compose

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

Ostatnia linia, opcjonalna, usuwa stare obrazy. GHOST_VERSION proszę zostawić zakomentowane w .env: przypięcie wersji blokuje te polecenia aktualizacji.

Utwardzanie i rozwój instancji

Dokumentacja podaje kilka ustawień dla serwera produkcyjnego:

• MySQL: po udanej instalacji Ghost-CLI proszę uruchomić mysql_secure_installation.
• Zapora: reguły UFW dla SSH, Nginx, HTTP i HTTPS, bez innej zapory obok.
• SSH: logowanie wyłącznie kluczem, bez hasła, i bez konta root.
• Zespół: uwierzytelnianie dwuskładnikowe można uczynić obowiązkowym dla wszystkich logowań w „Settings”, „Staff”.

Jeśli chodzi o obciążenie, projekt stawia przed Ghost CDN i warstwę pamięci podręcznej. Zaznacza, że klastrowanie i sharding nie są obsługiwane: stronę obsługuje jedna instancja, a pamięć podręczna absorbuje ruch.

Kto za co odpowiada na Managed VPS

Samodzielny hosting wymaga prowadzenia serwera, oprócz samej aplikacji. Na Managed VPS nasze zespoły przejmują serwer i proaktywnie czuwają nad Państwa instancją; Ghost pozostaje Państwa oprogramowaniem, z Państwa ustawieniami i danymi.

Jeśli wolą Państwo, aby nasze zespoły interweniowały w samej aplikacji, usługa ta jest rozliczana godzinowo lub ryczałtowo, z wyceną przekazaną przed interwencją.