К содержимому
BuildNexus

С чего начать

Основное размещение — ваш VPS. Для подключения достаточно IP-адреса, логина и пароля от VPS. Studio установит необходимые компоненты и будет управлять сервисами: отдельно заходить на сервер и устанавливать панель управления не требуется. Как подключить VPS в Studio.
Если сложно подключить сервер через мастер или вручную, выберите облако BuildNexus или обратитесь в техническую поддержку за настройкой вашего VPS или хостинга — 2 500 ₽ разово.

Эта инструкция — для Linux-хостинга с панелью управления, файловым менеджером или FTP. Пример настройки cron показан в Beget. Если вы управляете собственным Linux-сервером с SSH и systemd, используйте руководство для VPS.

1. Проверить, подходит ли площадка

«Программа на Go» — это готовое ядро сайта, написанное на языке программирования Go. Вы загружаете исполняемый файл: он принимает запросы посетителей, формирует страницы и обслуживает встроенную CRM. Устанавливать сам язык Go или изучать его владельцу сайта не требуется. Почему выбран Go и в чём новизна подхода BuildNexus.

Обычному хостингу нужно разрешать запуск своего Linux-бинарника (готового исполняемого файла), дочерние процессы и локальные Unix-сокеты. Для типичного Apache/LiteSpeed используется CGI-фронт bnxfront; данные и активный релиз хранятся вне публичной папки.

Уточните у поддержки хостинга: доступны ли CGI/ExecCGI для собственного бинарника, запись рядом с public_html, запуск дочернего процесса, Unix-сокеты и минутный cron. Один только пункт «PHP» в тарифе этого не гарантирует. Для проверки окружения через install.php дополнительно нужен подходящий PHP; он служит загрузчиком, а само ядро работает на Go.

Подготовьте домен, доступ к файловому менеджеру/FTP, панель CronTab, код места из кабинета BuildNexus и параметры базы, если она нужна вашей редакции. Базу создают отдельно у хостера или на другом совместимом сервере: см. как выбрать и подключить MySQL.

2. Разобраться с доменом и папками

Добавьте домен в разделе сайтов хостинга и направьте его DNS на площадку. Если переносите существующий домен, учитывайте работающую почту и другие записи: перенос NS и изменение A-записи — разные операции.

Типичная раскладка:

SITE/
  public_html/            публичная папка домена
    .htaccess
    cgi-bin/bnxfront
  bnxruntime/             закрытые данные и релизы
    .secure/
    releases/
    current
    sites/

SITE — имя каталога в домашней папке аккаунта. Оно может совпадать с доменом, но это не обязательно. В файловом менеджере включите показ скрытых файлов: .htaccess и .secure иначе не видны.

Runtime и резервные копии не размещайте в доступной посетителям папке. До работы с существующим сайтом сохраните его файлы, конфигурацию и базу.

3. Выбрать способ установки

Вариант A: файловый менеджер или FTP и install.php

  1. Скачайте однофайловый установщик.
  2. Загрузите его в публичную папку именно нужного домена: SITE/public_html/install.php.
  3. Откройте https://ваш-домен/install.php. Установщик проверит окружение, запись и необходимые расширения. При ошибке сначала исправьте её по сообщению проверки или обратитесь в поддержку хостинга.
  4. Завершите распаковку CGI-фронта, затем удалите install.php по предложенной кнопке и продолжите браузерный мастер.

PHP здесь нужен для первоначальной распаковки. Выбор версии PHP не обновляет MySQL и не определяет версию самого Go-ядра.

Вариант B: готовый пакет CGI-фронта

Если используете пакет bnxfront-installer от поставщика, распакуйте его в document root выбранного домена. Должны появиться .htaccess и cgi-bin/bnxfront; фронту нужно право исполнения. Например, при наличии SSH:

chmod 755 ~/SITE/public_html/cgi-bin/bnxfront

Проверьте параметры .htaccess по инструкции пакета. В стандартной раскладке runtime определяется рядом с public_html; для нестандартного размещения администратор задаёт явный путь. Не вставляйте в рабочую конфигурацию незаменённые примеры /home/ACC/....

Пакет фронта не содержит готовый сайт и весь архив ядра. После распаковки завершите установку в браузере.

Вариант C: хостинг с собственным постоянным приложением

Некоторые площадки позволяют запускать постоянный процесс и направлять домен на его локальный порт. Этот вариант требует настройки процесса, reverse proxy и перезапуска средствами хостера. Обычный CGI-сценарий на него автоматически не переключается. Если у вас полноценный VPS, используйте отдельный установщик systemd, а не запускайте процесс вручную наугад.

4. Завершить мастер и подготовить базу

Откройте сайт и пройдите мастер настройки: подключите лицензию кодом места из кабинета, задайте базу для редакции с БД и установите ядро. В зависимости от способа поставки мастер может предложить загрузку лицензии и проверочного файла — используйте комплект от своего поставщика, не чужие ключи из примера.

По умолчанию мастер скачивает выбранный релиз, проверяет контрольную сумму и создаёт стартовый сайт. Вкладка загрузки архива нужна, если у вас заранее есть подходящий архив ядра. Офлайн-архив не отменяет требований к лицензии, базе и окружению.

У базы должны быть собственные имя, пользователь, пароль, адрес и порт. На том же хостинге адрес часто localhost; для внешней базы он другой. Не указывайте адрес phpMyAdmin вместо адреса MySQL. Все варианты, включая Beget MySQL 8.4 и облачную БД, разобраны в едином руководстве по базе.

Сохраните серверный ключ для Studio и данные администратора, если мастер их создаёт. Удалите оставшийся публичный установщик и проверьте HTTPS.

5. Настроить cron в Beget

Для локальной команды нужны Core и внешний public_html/cgi-bin/bnxfront версии 0.9.4 или новее. До обновления обоих бинарников не меняйте прежнее HTTP-задание.

В Beget откройте «Планировщик заданий» → «Мастер заданий», выберите «Произвольная команда» и вставьте:

~/SITE/public_html/cgi-bin/bnxfront --keepalive

Замените только SITE. Путь к bnxruntime фронт найдёт сам. В поле команды пять звёздочек не добавляются: расписание задаётся отдельно.

Укажите «Каждую минуту», «Каждый час», «Каждый день», «Каждый месяц», «В любой день недели». Задайте понятное описание и сохраните задание.

Beget: мастер настройки произвольной команды; данные сайта скрыты

В ручном режиме укажите * во всех пяти полях — минуты, часы, дни, месяцы, дни недели:

Beget: ручная настройка bnxfront --keepalive и пяти звёздочек; данные сайта скрыты

В нижнем блоке «Команды» проверьте сохранённую строку: все пять значений — *, переключатель включён.

Beget: сохранённое минутное задание включено; данные сайта скрыты

На последнем снимке верхняя форма создаёт новое задание. Значения «В указанные минуты: 1» и «В указанные часы: 1» в ней не относятся к сохранённой строке ниже. В узком поле конец команды может быть обрезан: копируйте полную строку из текстового примера.

Запустите команду через проверку или вкладку «Запустить скрипт». Успешный ответ содержит ok: true, core_version, pid и boot_id. При повторном запуске работающего ядра PID и идентификатор сохраняются. После проверки можно добавить >/dev/null, чтобы успешный вывод не отправлялся по почте; ошибки останутся доступны.

Для обычного crontab, где расписание записывается в строке, полный вариант выглядит так:

* * * * * ~/SITE/public_html/cgi-bin/bnxfront --keepalive >/dev/null

На Core 0.9.3 и старее до обновления сохраняйте прежний /health-пинг. При переходе замените старое задание: одновременно держать две строки не нужно. Одна локальная команда поддерживает активность процесса и будит очередь; перезапуск хостером или обновлением всё ещё возможен.

Официальная инструкция Beget по CronTab описывает мастер и просмотр результатов. На наших снимках домен и каталог скрыты, браузер, аккаунт и баланс исключены из кадра.

6. Подключить Studio и проверить результат

В настройках рабочего сервера Studio укажите HTTPS-адрес сайта и серверный ключ. Проверьте соединение, затем опубликуйте проект штатной командой.

Проверьте главную и внутренние страницы, CSS и изображения, вход в CRM при её использовании, тестовую форму, /health и успешное выполнение cron. Сведения о публикации и возврате — в общем руководстве.

Если первый заход после паузы замедляется, проверьте именно выполнение cron и идентификатор процесса. HTTP 200 сам по себе не доказывает, что процесс не перезапускался. Для диагностики служит закрытый .secure/core-lifecycle.jsonl.

7. Если установка не проходит

Признак Что проверить
Permission denied при запуске Право исполнения, владельца и разрешение своих бинарников у хостера
500 или не запускается CGI .htaccess, ExecCGI, архитектуру пакета, журналы хостинга
Бинарник не запускается Совместимость Linux/архитектуры и ограничения процесса у провайдера
Ошибка версии MySQL или collation Версию сервера БД по руководству
Статика возвращает 404 Наличие файлов и настройку маршрутизации/ссылок из пакета
Локальный cron требует обновление Обновлены ли одновременно Core и внешний bnxfront

Если площадка запрещает требуемый запуск или Unix-сокеты, смена версии PHP это не исправит. Выберите совместимый тариф/площадку или размещение на VPS.

Если сложно подключить сервер через мастер или вручную, выберите облако BuildNexus или обратитесь в техническую поддержку за настройкой вашего VPS или хостинга — 2 500 ₽ разово.