Установка и приёмка системы

Примите новую установку, проверьте HTTPS, службы, резервные копии и готовность панели

Что вы получите

Новая система установлена на поддерживаемом чистом сервере штатным Installer, а владелец принял не только страницу входа, но и полный рабочий контур: HTTPS, фоновые службы, резервные копии, Update Agent и панель управления.

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

Разделите ответственность

Участник	Что делает
Владелец	Передаёт домены, лицензию и требования, затем принимает результат
Технический специалист	Проверяет сервер и архивы, выполняет установку, диагностику и восстановление копии
Администратор	Проверяет вход, права, службы и основные экраны панели

Установка изменяет сервер и требует root-доступа. Не передавайте пароль root, лицензионный архив или секреты через GitBook, общий чат и снимки экрана.

Подготовьте чистый сервер и файлы

Текущий production-профиль поддерживает Ubuntu 26.04 на amd64 и arm64, а также Debian 13 на amd64. Debian 13 arm64 требует отдельной приёмки. Сверьте этот список с инструкцией именно к полученному комплекту перед заказом сервера.

FastPanel для установки не требуется. Не устанавливайте её только ради курса и не размещайте на сервере другой рабочий сайт, базу данных или почтовую систему.

Для новой установки нужны:

• iex-installer-linux.zip и опубликованная рядом контрольная сумма;
• iexexchanger_backend_full.zip;
• iexexchanger_frontend_full.zip;
• лицензионный ZIP, выданный для этого проекта;
• реальные домены панели и клиентского сайта;
• E-mail для выпуска TLS-сертификата.

Архивы *_update.zip предназначены для обновления уже установленной системы и не заменяют *_full.zip при первой установке.

Не распаковывайте продуктовые ZIP вручную в каталог работающего сайта и не отключайте проверку контрольных сумм. Backend и frontend должны принадлежать одной поставке, а Installer — подтвердить их назначение и совместимость до изменения сервера.

Выполните установку штатным способом

Технический специалист использует инструкцию из поставки и проходит один последовательный процесс.

1

Проверьте комплект Installer

Сверьте опубликованную SHA-256, распакуйте Installer в отдельный закрытый каталог и повторно проверьте его внутренний SHA256SUMS.

2

Подготовьте защищённую конфигурацию

Создайте install.yaml из примера, укажите реальные домены и параметры проекта и ограничьте доступ к файлу. Не вставляйте его содержимое в обращение поддержки: там могут находиться installation-bound данные.

3

Выполните предварительную проверку

Запустите config validate, затем checklist и plan. Устраните блокирующие ошибки по серверу, DNS, архивам и лицензии до команды установки.

4

Запустите одну установку

Выполните штатную команду install из текущего руководства Installer. Не запускайте второй процесс параллельно и не заменяйте системные пакеты вручную во время выполнения.

5

Продолжите тот же запуск после прерывания

Если процесс прервался, используйте resume с тем же install.yaml, тем же комплектом архивов и той же сборкой Installer. Новый запуск с другими файлами не является продолжением прежней операции.

Installer подготавливает веб-сервер, PHP, Node.js, PostgreSQL, Redis, TLS, firewall, фоновые процессы, расписание, резервное копирование и постоянные инструменты iexctl, Updater и Update Agent. Версии серверного стека задаёт текущий профиль поставки; не подменяйте его произвольными версиями из старой инструкции.

Примите технический результат

После завершения специалист должен подтвердить:

1. verify успешно проверяет установленный релиз и публичные точки;
2. iexctl doctor не показывает необъяснённых критических нарушений;
3. клиентский домен и адрес панели открываются по HTTPS;
4. Frontend, Horizon, Reverb, Pulse и планировщик работают;
5. Update Agent доступен приложению;
6. резервная копия создаётся, проходит проверку и видна в списке снимков;
7. restore-test проверяет восстановимость последней копии во временной изолированной области, не затрагивая рабочие базы;
8. отчёты установки сохранены в закрытом рабочем журнале.

Наличие файла резервной копии без успешной проверки восстановления не считается приёмкой.

Примите систему из панели

1

Войдите по выданному адресу

Смените временный пароль администратора, настройте личную учётную запись и не сохраняйте исходные данные доступа в документации.

2

Проверьте службы

Откройте «Утилиты» — «Службы». Убедитесь, что основные процессы имеют ожидаемое состояние, а Update Agent и резервное копирование отображаются без ошибки связи.

3

Проверьте обновления в режиме просмотра

Откройте «Обновления». Панель должна показать установленную версию, состояние агента и вкладку установленных версий. Загружать новый релиз для этой проверки не нужно.

4

Запустите диагностику

Откройте «Утилиты» — «Диагностика системы» и сохраните первый полный отчёт. Разберите предупреждения до настройки финансового контура.

Не смешивайте установку и обновление

Новая установка

Используются чистый сервер, Installer, два *_full.zip и архив лицензии. Результатом является первый принятый релиз и готовая инфраструктура.

Обновление

Используются два *_update.zip одной поставки. Обновление планируется и выполняется через раздел «Обновления» с обязательной резервной копией и возможностью контролируемого отката.

Этап завершён, если

• использован поддерживаемый чистый сервер;
• FastPanel и другая панель хостинга не установлены как обязательная зависимость;
• контрольные суммы Installer и его комплекта подтверждены;
• backend, frontend и лицензия относятся к одному проекту и правильному типу установки;
• предварительный план не содержит блокирующих ошибок;
• прерванный процесс продолжался теми же файлами, а не запускался заново;
• HTTPS работает на клиентском сайте и панели;
• диагностика служб и iexctl doctor не содержат необъяснённых критических ошибок;
• резервная копия создана, проверена и прошла restore-test;
• панель видит Update Agent и установленную версию;
• секреты и отчёты установки не опубликованы.

После приёмки подготовьте доступы, резервную копию и безопасный режим настройки.