Как запустить Ghost CMS локально на Mac и Windows

Ghost — лёгкая и современная платформа для публикации контента. В отличие от некоторых CMS, многие расширенные возможности (SEO, соцсети, платёжные интеграции) реализуются плагинами или встроенными настройками. Для разработки, тестирования тем и плагинов удобно запускать Ghost локально на компьютере.

Это руководство покрывает системные требования, установку Node.js (и nvm — при необходимости), установку ghost-cli и запуск локальной инстанции Ghost на Windows и macOS. Также приведены полезные команды, чеклисты для разных ролей и разделы с типичными проблемами и их решениями.

Основные варианты использования (варианты цели)

• Локальная разработка тем и интеграций
• Тестирование обновлений перед продвижением в продакшен
• Локальный редакционный рабочий процесс и предпросмотр
• Обучение и демонстрация возможностей Ghost

Важно: локальная установка не предназначена для публичного размещения сайта в продакшен без дополнительной настройки безопасности и резервного копирования.

Краткая сводка терминов (1‑строчные определения)

• Node.js: среда выполнения JavaScript вне браузера.
• nvm: менеджер версий Node.js (Node Version Manager).
• npm / yarn: менеджеры пакетов для Node.js.
• ghost-cli: инструмент командной строки для установки и управления Ghost.

Предварительные требования для Ghost CMS

Ghost локально требует:

• Node.js v16 LTS. Это версия с долгосрочной поддержкой и наиболее стабильная для Ghost в указанный период.
• npm (идёт вместе с Node) или yarn — менеджер пакетов.
• Опционально nvm (Node Version Manager), если вы работаете с несколькими версиями Node.
• Место на диске: ориентировочно 1–2 ГБ для приложения и временных файлов.

Совет: используйте LTS-версию Node.js, указанную в документации Ghost, чтобы избежать несовместимостей с зависимостями.

Использование менеджера версий Node (nvm)

Если вы не планируете держать несколько версий Node.js, можно установить Node напрямую и пропустить nvm. Но если вы — разработчик или поддерживаете проекты с разными требованиями по версиям Node, nvm сильно упрощает переключение.

Перед установкой nvm удалите существующие установки Node.js, чтобы избежать конфликтов. На Windows удалите каталоги Nodejs и проверьте глобальные конфиги npm, например файл %AppData%\npm\etc\npmrc — сохраните резервную копию при необходимости.

Важно: при использовании nvm убедитесь, что вы устанавливаете ghost-cli в том окружении Node, в котором будете запускать Ghost.

Установка nvm для Windows

1. Перейдите на страницу релизов nvm-for-windows и скачайте nvm-setup.zip. Запустите установщик.
2. Откройте Командную строку с правами администратора (Win + X → Command Prompt (Admin)).

nvm -v

Если отображается номер версии, nvm установлен. Текущая стабильная версия nvm-for-windows может отличаться — используйте релиз на странице проекта.

Далее установите Node.js 16.x:

nvm install 16.15.0

Пакет будет размещён в “%AppData%\Roaming\nvm” и смещён в Program Files через символьные ссылки. Проверьте версии:

node -v
npm -v

Установка nvm для macOS

Установка nvm через официальный установочный скрипт (bash/zsh):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

Скрипт клонирует репозиторий nvm в ~/.nvm и пытается добавить конфигурацию в профиль (например, ~/.bash_profile или ~/.zshrc). Начиная с macOS 10.15 (Catalina) по умолчанию используется zsh — убедитесь, что у вас есть файл ~/.zshrc.

Если файл отсутствует, создайте его:

touch ~/.zshrc

Запустите установочный скрипт ещё раз и проверьте:

nvm -v
nvm install 16.15.0
node -v
npm -v

Установка ghost-cli

ghost-cli — это инструмент командной строки, который автоматизирует установку, настройку и обслуживание Ghost. Устанавливается глобально через npm или yarn:

npm install ghost-cli@latest -g

При установке npm выполнит аудит пакетов и может сообщить об уязвимостях. После установки рекомендуется запустить автоматическое исправление (если вы согласны с изменениями):

npm audit fix --force

Запустите команду помощи, чтобы проверить установку и увидеть доступныe команды:

ghost help

Ghost CLI создаёт структуру папок, управляет правами доступа и следит за существующими инсталляциями.

Установка Ghost CMS на Windows 10 (локально)

1. Откройте Командную строку или PowerShell.
2. Перейдите в папку пользователя и создайте директорию для Ghost:

cd "C:\Users\[UserName]"
mkdir ghost
cd "C:\Users\[UserName]\ghost"

Замените [UserName] на имя вашей учётной записи.

3. Запустите локальную установку Ghost через ghost-cli:

ghost install local

Во время установки может появиться окно брандмауэра. Разрешите Node.js доступ в приватные сети, чтобы локальная серверная часть смогла принимать соединения. После установки вы получите ссылку для доступа:

http://localhost:2368/ghost/

Откройте её в браузере для начальной настройки.

Заполните форму настройки и откройте админ-панель:

localhost:2368/ghost/#/admin/

Установка Ghost CMS на macOS (локально)

1. В терминале создайте папку и перейдите в неё:

mkdir ghost
cd ghost

2. Запустите локальную установку:

ghost install local

Откройте в браузере ссылку:

http://localhost:2368/ghost/

Полезные команды управления Ghost

• ghost start — запустить процесс Ghost. Если возникли ошибки, попробуйте ghost run для логирования в терминал.
• ghost stop — остановить процесс Ghost.
• ghost ls — показать все запущенные локальные инстанции Ghost.
• ghost restart — перезапустить сайт Ghost.
• ghost update — обновить Ghost до новой версии.
• ghost doctor — проверка системы на наличие ошибок при установке/обновлении.
• ghost log — просмотр логов ошибок сайта.
• ghost version — показать версии ghost-cli и Ghost.
• ghost uninstall — полностью удалить инсталляцию Ghost (запускать из директории установки).

Краткая подсказка: используйте ghost log --tail для наблюдения логов в реальном времени.

Чеклист перед созданием сайта

• Определите цель сайта (блог, издание, платные подписки).
• Выберите темы и плагины, совместимые с текущей версией Ghost.
• План резервного копирования контента и медиа.
• Настройка SEO и аналитики (плагины, схемы, метаданные).
• Миграция контента, если переносите данные из другой CMS.

Важно: локальная установка подходит для разработки и предпросмотра. Для продакшен‑развёртывания потребуется HTTPS, бэкапы, мониторинг и настройка прав доступа.

Отладка: типичные проблемы и решения

1. Ghost не стартует (ошибка процессов): запустите

ghost doctor
ghost log

2. Конфликты версий Node: убедитесь, что активна Node v16 LTS. Если используете nvm, переключитесь:

nvm use 16

3. Ошибки прав доступа на Windows: запустите терминал от имени администратора или настройте права папки установки.

4. Брандмауэр блокирует доступ: разрешите Node.js в приватных сетях.

5. Проблемы с npm-пакетами: удалите node_modules и package-lock.json, затем выполните npm install.

Когда ничего не помогает: убедитесь, что вы устанавливали ghost-cli в том же окружении Node, где запускаете Ghost.

Когда локальная установка не подойдёт (контрпримеры)

• Если нужна постоянная публичная доступность с SSL, балансировкой и бэкапами — лучше использовать управляемый хостинг или настроить продакшен‑сервер.
• Если проект требует интеграций с внешними API в высоконагруженном режиме — локальная среда для этого не предназначена.

Альтернативные подходы

• Использовать Docker-контейнеры с официальным образом Ghost для воспроизводимой среды.
• Разворачивать Ghost на VPS или PaaS (DigitalOcean, Render, Heroku) для публичного доступа.
• Использовать Ghost(Pro) — управляемый SaaS-решение от разработчиков Ghost.

Роль‑ориентированные чеклисты

Разработчик:

• Установить nvm и Node v16.
• Установить ghost-cli и локально запустить Ghost.
• Настроить environment variables и конфигурацию темы.
• Проверить логи и написать тесты для шаблонов.

Контент‑менеджер:

• Настроить админ-панель и права пользователей.
• Импортировать контент (если требуется).
• Проверить SEO-метки и превью для соцсетей.

Системный администратор:

• Планировать бэкапы и миграции в продакшен.
• Настроить HTTPS и мониторинг для продакшен‑инстанции.

Мероприятия по безопасности и приватности

• Локальные инстанции не должны хранить чувствительные данные.
• Для продакшен‑сайтов настройте HTTPS, регулярные бэкапы и обновления зависимостей.
• Проверяйте разрешения файлов и доступ по SSH только для доверенных пользователей.

Диаграмма принятия решения (Mermaid)

flowchart TD
  A[Нужно ли несколько версий Node?] -->|Да| B[Использовать nvm]
  A -->|Нет| C[Установить Node напрямую]
  B --> D[Установить Node v16 LTS через nvm]
  C --> D
  D --> E[Установить ghost-cli глобально]
  E --> F[Запустить ghost install local]
  F --> G{Ghost запускается?}
  G -->|Да| H[Открыть http://localhost:2368/ghost/]
  G -->|Нет| I[Просмотреть логи и ghost doctor]

Критерии приёмки

• Локальная инстанция запускается и доступна по http://localhost:2368/ghost/.
• Доступна админ‑панель и можно создать тестовую публикацию.
• Команда ghost ls показывает активную инстанцию.

Короткая FAQ

Q: Нужен ли Docker для локальной разработки? A: Нет, но Docker обеспечивает изоляцию и воспроизводимость окружения — полезно для команд.

Q: Можно ли запустить Ghost на Node 18? A: Ghost тесно тестируется с конкретными LTS-версиями; используйте рекомендуемую версию (v16) для локальной разработки.

Q: Как экспортировать контент? A: В админке Ghost есть инструмент для экспорта контента в формате JSON.

Итог и следующие шаги

Запуск Ghost локально — быстрый способ начать разрабатывать тему, тестировать интеграции и управлять контентом. Начните с установки Node.js (или nvm), затем установите ghost-cli и выполните ghost install local. После этого настройте тему и процессы бэкапа, если планируете мигрировать в продакшен.

Рекомендации:

• Для командной работы используйте Docker или унифицированный dev‑контейнер.
• Для публичной публикации изучите требования к HTTPS и резервному копированию.

Важно: всегда проводите тестирование обновлений в локальной среде перед применением на продакшен‑сайтах.

Короткая памятка (cheat sheet):

• Установить Node v16: nvm install 16.15.0 или официальный инсталлятор Node.
• Установить ghost-cli: npm install ghost-cli@latest -g.
• Запустить локально: ghost install local.
• Логи: ghost log или ghost log --tail.