Как да хоствате Ghost® на Managed VPS: публикацията ви, на ваш сървър

Какво прави Ghost

Ghost е професионална платформа за публикуване със свободен код, написана за Node.js. Тя събира на едно място това, което независимата публикация често сглобява от няколко инструмента.

• Публикуването: статии, страници, персонализируеми теми, вградени функции за SEO и домейн на ваше име.
• Членовете: регистрация и вход с връзка, изпратена по имейл, без парола, и съдържание, запазено според нивото на всеки член.
• Платените абонаменти: акаунт в Stripe, свързан със сайта ви, за да продавате плановете си.
• Бюлетините: всяка статия може да бъде изпратена по имейл до безплатните или платените ви членове, или до сегмент, с един или няколко бюлетина.
• API-тата: роден REST API, за да свържете сайт по поръчка или собствените си инструменти.

Според документацията продуктът има същите функции при самостоятелно хостване. Това, което го заобикаля, остава ваша грижа: изпращането на бюлетините, уеб анализът, CDN и пълните резервни копия на сайта.

Лицензът MIT и марката

Ghost е публикуван с лиценз MIT. Той разрешава да използвате, копирате, променяте, обединявате, публикувате, разпространявате, преотстъпвате и продавате софтуера, при едно условие: да запазите бележката за авторските права и текста на лиценза във всяко копие. Можете следователно да пускате Ghost във фирма, да го приспособявате и да публикувате в него за клиентите си, без да купувате лиценз.

Лицензът покрива кода. Името и логото принадлежат на Ghost Foundation и се уреждат от нейната политика за марката: прочетете я, ако изграждате оферта около софтуера. Ghost е регистрирана марка на Ghost Foundation.

This publication is independent of and not affiliated with, authorized, sponsored, or approved by Ghost Foundation. На български: тази публикация е независима от Ghost Foundation и не е свързана с нея, нито е разрешена, спонсорирана или одобрена от нея.

Ghost-CLI или Docker Compose: два официални метода

Проектът документира два пътя за продукция. Ghost-CLI е инсталирането, което препоръчва официално, а Docker Compose е „preview“, която той нарича съвсем нова. Посочва и че се насочва към този инструментариум с Docker, вместо да развива Ghost-CLI, и предоставя помощник за преминаване от единия към другия.

Преди да започнете: домейнът и сървърът

Насочете домейна към сървъра преди инсталирането: сертификатът се поставя по време на настройването. На VPS на Simafri посетителите пристигат на портове 80 и 443, на името на домейна на сървъра, със записи A и AAAA. Адресът на сайта се пише изцяло, с протокола си, като https://example.com: IP адрес води до грешки.

Освен посочената по-горе памет, проектът не дава числа за диска и натоварването: размерът зависи от трафика, изображенията и медиите ви. На Managed VPS ни опишете публикацията си и ще ви препоръчаме подходящия размер.

Инсталиране на Ghost с Ghost-CLI на Ubuntu

Ghost-CLI се използва с потребител, който не е root и чието име не е ghost, защото това име влиза в конфликт с инструмента. Създайте го от акаунта root, като замените user с избраното име:

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

Nginx и MySQL

Обновете системата, инсталирайте Nginx (най-малко 1.9.5 за SSL) и MySQL. Редът с ufw отваря HTTP и HTTPS, ако тази защитна стена е активна:

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

При новите версии на Ubuntu акаунтът root на MySQL се удостоверява чрез сокет, което Ghost не поддържа. Задайте му парола:

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

Node.js и Ghost-CLI

Ghost изисква Node.js 22: версиите 20, 21, 23 и следващите не се поддържат. Проектът изисква да го инсталирате за цялата система, по този начин:

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

Стартиране на инсталирането

Ghost се инсталира в собствена папка, със собственик и конкретни права. Заменете sitename с името по ваш избор:

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

Командата задава тогава въпросите си, а проектът препоръчва да отговаряте с да на всяка предложена стъпка:

• Blog URL: точният адрес на сайта, с https://.
• MySQL: localhost за хоста, root и паролата, зададена по-горе, после името на базата, която Ghost-CLI създава.
• Set up a ghost MySQL user: акаунт в MySQL, ограничен до базата на Ghost.
• Set up NGINX и Set up SSL: конфигурацията на Nginx и сертификатът Let’s Encrypt, който иска имейл адрес.
• Set up systemd и Start Ghost: услугата, която държи Ghost в работа, после стартирането му.

Сайтът отговаря тогава, а https://example.com/ghost ви кани да създадете акаунта на собственика. Ако инсталирането бъде прекъснато, ghost setup продължава конфигурирането; ако пропадне, ghost uninstall почиства по-добре от изтриването на папката. ghost doctor проверява системата по всяко време.

Инсталиране на Ghost с Docker Compose (preview)

Проектът представя този метод като „preview“: за него той е съвсем нов. Именно той позволява самостоятелно хостване на уеб анализа и на ActivityPub.

На сървър с инсталиран Docker изтеглете официалния инструментариум в /opt/ghost и копирайте двата му примерни файла:

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

Във файла .env въведете тези стойности:

• DOMAIN: домейнът на сайта, например example.com.
• ADMIN_DOMAIN: отделен домейн за администрирането, ако желаете.
• DATABASE_ROOT_PASSWORD и DATABASE_PASSWORD: две пароли, генерирани с openssl rand -hex 32. Те се фиксират веднъж завинаги: след като базата е инициализирана, смяната им разваля връзката.
• Разделът SMTP Email: вашето реле, описано по-долу.

В caddy/Caddyfile разкоментирайте блока, който отговаря на вашия случай: пренасочване от www към голия домейн или обратното, или отделен домейн за администриране. Стартирайте после Ghost и завършете настройването на /ghost:

docker compose pull
docker compose up -d

• Портовете: само Caddy публикува портове, 80 и 443, които се сменят с HTTP_PORT и HTTPS_PORT, ако Ghost мине зад друг обратен прокси. MySQL остава във вътрешната мрежа на контейнерите.
• Данните: изпратените файлове живеят в data/ghost, а базата в data/mysql, две местоположения, настройваеми в .env.
• IPv6: хранилището го включва по избор, защото изисква по-нови версии на Docker и Compose. Добавете тогава -f compose.yml -f compose.ipv6.yml към командите си docker compose up.

Уеб анализът и ActivityPub

Анализът изисква акаунт в Tinybird, външна услуга. От /opt/ghost влезте, разгънете конфигурацията му и вземете токените, които да поставите в .env, раздел „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 работи веднага с услугата, хоствана от проекта, безплатна в рамките на ограниченията за употреба, които публикува документацията ѝ. За да хоствате своя, разкоментирайте ACTIVITYPUB_TARGET=activitypub:8080. Включете после в .env желания профил или профили и стартирайте контейнерите наново:

COMPOSE_PROFILES=analytics,activitypub

docker compose pull
docker compose up -d

За ActivityPub проектът изисква да се създадат наново и Ghost, и Caddy, с docker compose up -d --force-recreate ghost caddy.

Преминаване от Ghost-CLI към Docker Compose

След клонирането и конфигурирането bash scripts/migrate.sh копира папката content, внася базата в контейнера на MySQL и стартира Caddy на мястото на Nginx. Предлага да спре Nginx, което изключва сайта: отговорете не, ако на сървъра работят и други сайтове. Не изтрива никакви данни. bash recovery_instructions.sh възстановява първоначалния сайт, ако прекъснете миграцията.

HTTPS и домейн за администриране

Администрирането на Ghost трябва да минава през HTTPS, а проектът препоръчва HTTPS за целия сайт: без него идентификаторите и паролите се движат в чист вид. С Docker Compose Caddy се грижи за това. С Ghost-CLI инсталирането поставя сертификата, а една команда го прави и впоследствие:

ghost setup ssl

За да смените адреса на сайт, инсталиран с Ghost-CLI, ghost config url https://example.com обновява конфигурацията, а ghost restart я прилага.

Проектът съветва и отделен домейн за администриране, който намалява повърхността за атака. Пътят остава /ghost/. При Ghost-CLI той се декларира в config.production.json:

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

При Docker Compose въведете ADMIN_DOMAIN, разкоментирайте блока му в Caddyfile и изпълнете docker compose up -d --force-recreate ghost caddy. Този домейн също има нужда от свои записи A и AAAA.

MySQL 8, базата за продукция

MySQL 8 е единствената база, която проектът поддържа в продукция. Ghost-CLI се инсталира с MySQL 8.0 или 8.4, а файлът на Compose доставя образ на MySQL 8.0.

• От SQLite: проектът препоръчва пълно преинсталиране върху MySQL 8.
• От MariaDB: той настоятелно препоръчва миграция към MySQL 8.
• За проверка: ghost config database.client, в папката на сайта, показва използваната база.

Имейлите и бюлетините

Ghost различава две изпращания, които не минават по един и същи път. Това е най-важната точка за настройване след инсталирането.

SMTP релето, за транзакционните имейли

Документацията определя тази конфигурация като задължителна в продукция. Ghost изпраща и код по имейл, когато засече вход от ново устройство: настройте това реле, преди да поканите екипа си.

На VPS на Simafri изпращането минава през удостоверено SMTP реле, на порт 587: адресът на пощенски акаунт, който вече имате, или 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 и requireTLS: Ghost изпраща чрез Nodemailer, чиято документация изисква secure да е false на порт 587, като връзката минава след това в STARTTLS. requireTLS отказва изпращането, ако този преход пропадне. Примерният файл на хранилището посочва порт 465 и secure=true: заменете тези два реда.
• Адресът на подателя: from носи реален, четен адрес, което подобрява доставяемостта според проекта, а записите SPF, DKIM и DMARC на домейна за изпращане допълват настройката.
• Тестът: поканете член на екипа от администрирането и проверете получаването.

Mailgun, за бюлетините

SMTP релето не покрива бюлетините. Според документацията масовото изпращане не се прави чрез SMTP и Mailgun е, към днешна дата, единствената услуга за масово изпращане, която Ghost поддържа. Създавате свой акаунт в Mailgun и въвеждате API ключовете му в настройките на Ghost.

Ако не изпращате статиите си по имейл, не ви трябва никакъв акаунт в Mailgun: тези настройки се пренебрегват. Ако предпочитате друг инструмент за бюлетини, проектът предлага да синхронизирате членовете си към него, например със Zapier или с неговите ръководства за интеграция.

Архивиране и възстановяване на Ghost

Ghost предлага три нива на копиране и те не съдържат едно и също. За да възстановите сайт идентично, проектът изисква директно архивиране на базата и на папката content.

Експортът се намира в „Settings“, „Advanced“, „Import/Export“, раздел „Export“, бутон „All data“. За пълното копие, с Ghost-CLI, акаунтът в MySQL и името на базата, които да използвате, са в 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 Compose официалният инструментариум пази съдържанието в data/ghost. Дъмпът следва вида, даден от образа на MySQL, а паролата на root вече е в контейнера. Пазете и копие на .env и на 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

Възстановяване

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

Копирайте тези файлове извън сървъра, с rsync или scp, и направете пробно възстановяване на тестова машина. Ако започвате от експорт с платени членове, свържете същия акаунт в Stripe, преди да внесете членовете си.

Обновяване на Ghost

Проектът публикува обновления всяка седмица и напомня, че публичният уеб сървър трябва да остава актуален. Прочетете бележките към версиите, после изпълнете командата на вашия метод.

С Ghost-CLI

ghost check-update
ghost backup
ghost update

• Връщането назад: ghost update --rollback се връща към предишната версия, ако обновяване мине зле.
• Папката content остава на мястото си по време на обновяванията.
• Основните версии излизат на всеки 12 до 18 месеца и нарушават съвместимостта: документацията изисква резервни копия, прочитане на промените и проверка на съвместимостта на темата.
• Node.js: сменете го отделно от Ghost, после изпълнете ghost update [version] --force с текущата си версия, защото двоичните му зависимости са компилирани за конкретна версия на Node.js.

С Docker Compose

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

Последният ред, по желание, премахва старите образи. Оставете GHOST_VERSION коментиран в .env: фиксирането на версия блокира тези команди за обновяване.

Заздравяване и растеж на инстанцията

Документацията дава няколко настройки за сървър в продукция:

• MySQL: изпълнете mysql_secure_installation след успешно инсталиране с Ghost-CLI.
• Защитната стена: правила на UFW за SSH, Nginx, HTTP и HTTPS, без друга защитна стена наред с нея.
• SSH: вход само с ключ, без парола и без акаунт root.
• Екипът: двуфакторното удостоверяване се прави задължително за всички влизания в „Settings“, „Staff“.

За натоварването проектът поставя CDN и слой за кеширане пред Ghost. Уточнява, че клъстерирането и шардингът не се поддържат: една-единствена инстанция обслужва сайта, а кешът поема трафика.

Кой какво прави на Managed VPS

Самостоятелното хостване изисква да поддържате сървъра освен приложението. На Managed VPS нашите екипи поемат сървъра и следят проактивно вашата инстанция; Ghost остава ваш софтуер, с неговите настройки и данни.

Ако предпочитате нашите екипи да се намесват в самото приложение, тази услуга се фактурира на час или на фиксирана цена, с оферта, съобщена преди намесата.