Шаг 3: Команды терминала

На этом этапе вам необходимо подключиться к серверу через SSH и выполнить набор специальных команд. Эти команды подготовят ваш сервер, установят и обновят важные компоненты, которые необходимы для стабильной и быстрой работы вашего обменника.

Как открыть терминал и подключиться к серверу по SSH?

Важно:

На этом этапе необходимо подключиться к серверу через SSH под пользователем root, так как именно root имеет полный доступ к системе и может выполнять все необходимые команды. Это критично для корректной установки и настройки компонентов, обеспечивающих стабильную и быструю работу обменника.

Перед началом: проверьте, что FastPanel PHP 8.4 установлен

В FastPanel должен быть установлен PHP 8.4 и доступен путь: /opt/php84/bin/php

Проверка: /opt/php84/bin/php -v

Если команда не найдена — сначала установите PHP 8.4 в FastPanel.

---

Этап 0: Проверка и установка sudo (если отсутствует)

Иногда на "чистых" серверах sudo может отсутствовать. Сначала проверяем и при необходимости ставим.

if ! command -v sudo >/dev/null 2>&1; then
  apt update -y
  apt install -y sudo
fi

Этап 1: Обновление системы и установка компонентов

Что будет сделано

• Обновление системы и пакетов

• Установка Redis (кэширование и очереди)

• Установка Supervisor (автозапуск и контроль процессов)

• Установка инструментов сборки (нужны для EV)

• Установка базовых утилит (curl, git, openssl и т.п.)

Команды для выполнения:

sudo apt update -y
sudo apt upgrade -y

sudo apt install -y \
  curl ca-certificates gnupg git lsb-release openssl unzip \
  redis-server supervisor \
  build-essential pkg-config libevent-dev

Важно при установке пакетов

Если появится вопрос: Do you want to continue? [Y/n] — ответьте Y и нажмите Enter.

Этап 2: Сделать PHP 8.4 (FastPanel) основным для CLI

В FastPanel PHP 8.4 находится по пути: /opt/php84/bin/php

Сделаем так, чтобы команда php в терминале использовала именно PHP 8.4.

Команды

if [ ! -x /opt/php84/bin/php ]; then
  echo "Ошибка: не найден /opt/php84/bin/php. Установите PHP 8.4 в FastPanel."
  exit 1
fi

sudo update-alternatives --install /usr/bin/php php /opt/php84/bin/php 84 >/dev/null 2>&1 || true
sudo update-alternatives --set php /opt/php84/bin/php >/dev/null 2>&1 || true

php -v | head -n 1

Этап 3: Установка ionCube Loader 15

• Loader подключаем первым через файл: /opt/php84/conf.d/00-ioncube.ini

• Скачивание: IPv4 + fallback ZIP, если tar.gz не скачался.

Команды

sudo mkdir -p /usr/local/src
cd /usr/local/src
sudo rm -rf ioncube >/dev/null 2>&1 || true
sudo rm -f ioncube_loaders_lin_x86-64.tar.gz ioncube_loaders_lin_x86-64.zip >/dev/null 2>&1 || true

IONCUBE_TAR_URL="https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz"
IONCUBE_ZIP_URL="https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.zip"
IONCUBE_DST_DIR="/usr/local/ioncube"
IONCUBE_SO="$IONCUBE_DST_DIR/ioncube_loader_lin_8.4.so"
IONCUBE_INI="/opt/php84/conf.d/00-ioncube.ini"

download_ok=0
curl -4 -fSL "$IONCUBE_TAR_URL" --connect-timeout 10 --max-time 600 --retry 5 --retry-delay 2 \
  -o ioncube_loaders_lin_x86-64.tar.gz && download_ok=1 || download_ok=0

if [ "$download_ok" -eq 1 ] && [ -s ioncube_loaders_lin_x86-64.tar.gz ]; then
  sudo tar -xzf ioncube_loaders_lin_x86-64.tar.gz
else
  curl -4 -fSL "$IONCUBE_ZIP_URL" --connect-timeout 10 --max-time 600 --retry 5 --retry-delay 2 \
    -o ioncube_loaders_lin_x86-64.zip

  if [ ! -s ioncube_loaders_lin_x86-64.zip ]; then
    echo "Ошибка: ionCube zip не скачался или пустой."
    exit 1
  fi

  sudo unzip -o ioncube_loaders_lin_x86-64.zip -d /usr/local/src >/dev/null
fi

if [ ! -f "/usr/local/src/ioncube/ioncube_loader_lin_8.4.so" ]; then
  echo "Ошибка: не найден /usr/local/src/ioncube/ioncube_loader_lin_8.4.so"
  exit 1
fi

sudo mkdir -p "$IONCUBE_DST_DIR"
sudo cp -f "/usr/local/src/ioncube/ioncube_loader_lin_8.4.so" "$IONCUBE_SO"

echo "zend_extension=$IONCUBE_SO" | sudo tee "$IONCUBE_INI" >/dev/null

# Если в php-cli.ini было старое подключение — комментируем
if [ -f /opt/php84/etc/php-cli.ini ]; then
  sudo sed -i 's/^\s*zend_extension\s*=.*ioncube.*$/; &/i' /opt/php84/etc/php-cli.ini || true
  sudo sed -i 's/^\s*zend_extension_ts\s*=.*ioncube.*$/; &/i' /opt/php84/etc/php-cli.ini || true
fi

php -v | grep -i "ionCube" || true

Этап 4: Установка расширения EV

• Мы ставим EV не в системный PHP, а в FastPanel PHP 8.4 (/opt/php84).

• Для EV обязательно нужен модуль sockets. Если sockets не загружен, EV не запустится (ошибка socket_ce).

Команды

PHP84_BIN="/opt/php84/bin/php"
PHP84_PECL="/opt/php84/bin/pecl"
PHP84_PHPIZE="/opt/php84/bin/phpize"
PHP84_PHP_CONFIG="/opt/php84/bin/php-config"

EV_INI_CONF_D="/opt/php84/conf.d/20-ev.ini"
PHP84_CLI_INI="/opt/php84/etc/php-cli.ini"
PHP84_FPM_INI="/opt/php84/etc/php-fpm.ini"

if [ ! -x "$PHP84_BIN" ] || [ ! -x "$PHP84_PECL" ] || [ ! -x "$PHP84_PHPIZE" ] || [ ! -x "$PHP84_PHP_CONFIG" ]; then
  echo "Ошибка: в /opt/php84/bin отсутствуют php / pecl / phpize / php-config. Проверь установку PHP 8.4 в FastPanel."
  exit 1
fi

# Проверяем sockets (иначе EV не загрузится)
if ! "$PHP84_BIN" -m 2>/dev/null | grep -qi '^sockets$'; then
  echo "Ошибка: модуль sockets не загружен в FastPanel PHP 8.4."
  echo "Включите sockets в FastPanel (PHP 8.4 → Extensions → sockets) и повторите установку EV."
  exit 1
fi

sudo apt update -y
sudo apt install -y build-essential pkg-config libevent-dev

# Чистая переустановка EV под PHP 8.4
sudo "$PHP84_PECL" uninstall ev >/dev/null 2>&1 || true

export PHP_PEAR_PHP_BIN="$PHP84_BIN"
export PHP_PEAR_PHPIZE_BIN="$PHP84_PHPIZE"
export PHP_PEAR_PHP_CONFIG_BIN="$PHP84_PHP_CONFIG"
export PHPIZE="$PHP84_PHPIZE"
export PHP_CONFIG="$PHP84_PHP_CONFIG"

sudo "$PHP84_PECL" channel-update pecl.php.net || true
printf "\n" | sudo "$PHP84_PECL" install ev

# Подключаем EV: через conf.d + дополнительно в ini для CLI/FPM (на случай особенностей сборки)
echo "extension=ev.so" | sudo tee "$EV_INI_CONF_D" >/dev/null

if [ -f "$PHP84_CLI_INI" ]; then
  sudo grep -qiE '^\s*extension\s*=\s*ev\.so\s*$' "$PHP84_CLI_INI" || echo "extension=ev.so" | sudo tee -a "$PHP84_CLI_INI" >/dev/null
fi

if [ -f "$PHP84_FPM_INI" ]; then
  sudo grep -qiE '^\s*extension\s*=\s*ev\.so\s*$' "$PHP84_FPM_INI" || echo "extension=ev.so" | sudo tee -a "$PHP84_FPM_INI" >/dev/null
fi

# Перезапуск FPM (если сервис существует)
sudo systemctl restart php84-fpm >/dev/null 2>&1 || true
sudo systemctl restart php8.4-fpm >/dev/null 2>&1 || true
sudo systemctl restart php-fpm >/dev/null 2>&1 || true

# Проверка: EV загружен?
/opt/php84/bin/php -m | grep -i '^ev$' || echo "Внимание: EV установлен (ev.so есть), но не загружен. Проверьте вывод: /opt/php84/bin/php --ini"

Важно при установке EV

Если появится вопрос: Enable internal debugging in ev [no]: — просто нажмите Enter.

---

Этап 3: Настройка лимитов открытых файлов (limits.conf)

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

1. Откройте терминал сервера и выполните следующую команду для открытия конфигурационного файла:

sudo nano /etc/security/limits.conf

1. В открывшемся редакторе файла перейдите в самый низ и добавьте следующие строки (замените слово имя_пользователя на фактическое имя вашего пользователя сервера):

www-data        soft    nofile  10000
www-data        hard    nofile  10000
имя_пользователя soft   nofile  10000
имя_пользователя hard   nofile  10000

Здесь:

• www-data — стандартный пользователь веб-сервера.

• soft и hard — типы лимитов.

  • soft — рекомендуемый предел (может временно превышаться).

  • hard — жёсткий предел (нельзя превышать).

• nofile — количество одновременно открытых файлов.

Значение 10000 оптимально для большинства веб-приложений и серверов.

Как сохранить изменения

На Mac и Linux (редактор nano):

• Нажмите комбинацию клавиш Control + O для сохранения файла.

• Затем подтвердите сохранение, нажав Enter.

• Для выхода из редактора нажмите Control + X.

На Windows (редактор nano в WSL, Git Bash и аналогичных):

• Нажмите комбинацию клавиш Ctrl + O для сохранения файла.

• Затем нажмите Enter для подтверждения.

• Закройте редактор, нажав Ctrl + X.

---

Этап 4: Подробная настройка веб-сервера Nginx

На этом этапе вы настроите веб-сервер Nginx таким образом, чтобы он мог без перебоев работать с большим количеством одновременно подключенных пользователей и эффективно справлялся с повышенной нагрузкой.

Эта настройка особенно важна, так как по умолчанию сервер имеет достаточно низкие ограничения на количество одновременных подключений, что может привести к ошибкам и проблемам в работе обменника при увеличении числа посетителей и запросов.

1. Откройте конфигурационный файл Nginx

Сначала подключитесь к серверу через SSH.

Затем в терминале введите следующую команду:

sudo nano /etc/nginx/nginx.conf

• sudo — выполнение команды с правами администратора.

• nano — текстовый редактор в терминале.

• /etc/nginx/nginx.conf — это основной файл настроек веб-сервера Nginx.

После выполнения этой команды откроется конфигурация веб-сервера.

2. Внесите важные изменения в конфигурацию

В открывшемся файле найдите строчку:

pid /var/run/nginx.pid;

Эта строчка показывает, где хранится файл, в котором записан ID процесса Nginx. Вам нужно вставить настройки сразу после этой строки, чтобы изменения были максимально эффективны и правильно применялись сервером.

Удалите стандартный блок настроек, который выглядит так:

events {
    worker_connections  1024;
}

Стандартное значение ограничивает сервер 1024 одновременными подключениями. Для современных сайтов это значение обычно недостаточно, особенно под высокой нагрузкой.

Вместо удалённого блока добавьте новый блок, указанный ниже:

worker_rlimit_nofile 10000;

events {
    worker_connections 10000;
    multi_accept on;
}

Подробное описание новых параметров:

• worker_rlimit_nofile 10000

  Это ограничение количества одновременно открытых файлов, доступных для каждого рабочего процесса Nginx.

  Веб-серверу необходимо открывать файлы для каждого подключения (каждого запроса или каждого пользователя). Чем больше это число, тем больше одновременных подключений сервер сможет корректно обработать. Значение 10000 является оптимальным в большинстве случаев.

• worker_connections 10000

  Указывает максимальное количество одновременных подключений, которое сможет обрабатывать каждый отдельный рабочий процесс Nginx. Большое значение необходимо, чтобы сервер не отказывал в подключениях при высокой нагрузке и потоке пользователей.

• multi_accept on

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

После того, как вы добавили указанные строки, сделайте следующее:

Как сохранить изменения

На Mac и Linux (редактор nano):

• Нажмите комбинацию клавиш Control + O для сохранения файла.

• Затем подтвердите сохранение, нажав Enter.

• Для выхода из редактора нажмите Control + X.

На Windows (редактор nano в WSL, Git Bash и аналогичных):

• Нажмите комбинацию клавиш Ctrl + O для сохранения файла.

• Затем нажмите Enter для подтверждения.

• Закройте редактор, нажав Ctrl + X.

3. Перезапустите веб-сервер Nginx

Теперь изменения нужно применить, перезапустив сервер Nginx.

Для этого выполните команду:

sudo systemctl restart nginx

Эта команда перезапустит веб-сервер, и все сделанные вами изменения вступят в силу сразу после этого.

---

Этап 5: Настройка стабильной работы проекта с Supervisor и PM2

Для обеспечения стабильной работы вашего обменника даже при сбоях или перезагрузке сервера необходимо настроить специальные инструменты автоматического управления приложениями:

• Supervisor — это инструмент, который следит за фоновыми процессами вашего Laravel-приложения (например, очереди задач, отправка уведомлений, мониторинг производительности). Supervisor автоматически перезапускает процессы, если они вдруг остановились, гарантируя бесперебойную работу вашего сайта.

• PM2 — это инструмент, который управляет работой вашего Angular frontend-приложения. PM2 обеспечивает автоматический перезапуск приложения при сбоях, мониторинг использования ресурсов и удобное ведение журналов (логов).

Обязательно выполните инструкции по ссылкам ниже для настройки каждого компонента:

Настройка SupervisorНастройка PM2

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

Совет

Обязательно убедитесь, что выполнили инструкции полностью и без ошибок, так как от этого зависит надёжность работы вашего обменника.

---

Этап 6: Установка корректных прав доступа на файлы проекта

Правильная настройка прав доступа необходима для безопасной работы вашего backend-приложения (Laravel). Корректно выставленные права позволяют вашему пользователю управлять всеми файлами проекта, выполнять команды от своего имени и избегать ошибок прав доступа.

После загрузки файлов на сервер может возникнуть ситуация, когда пользователь сайта (созданный в FastPanel) не имеет прав на редактирование или запуск некоторых файлов или директорий. Данная настройка исправит эту проблему.

Выполните следующую команду в терминале:

sudo chown -R имя_пользователя: путь_к_проекту

Обязательно замените указанные значения на свои:

• имя_пользователя – имя пользователя, созданное в панели управления (например, пользователь FastPanel).

• путь_к_проекту – путь к директории вашего сайта на сервере (например, /var/www/ваш_домен или /var/www/app.ваш_домен).

Как найти путь к проекту и имя пользователя в FastPanel?

Что делает эта команда:

• sudo – выполняет команду с правами администратора.

• chown – изменяет владельца файлов и папок.

• Параметр -R – применяет изменения ко всем файлам и папкам внутри указанной директории.

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

---

Завершающий этап: запуск команд от имени пользователя проекта

На этом этапе необходимо выполнить несколько команд в терминале, которые завершат подготовку вашего проекта и сделают его полностью рабочим и готовым к использованию.

Выполните эти шаги по порядку и внимательно следуйте инструкции ниже.

Шаг 1: Авторизация под пользователем сайта

Сначала авторизуйтесь под пользователем сайта, чтобы все команды выполнялись от его имени, а не от администратора. Это безопасно и правильно для работы приложения.

Введите в терминал следующую команду:

su -l имя_пользователя

Замените имя_пользователя на имя, которое вы создавали в панели FastPanel.

Шаг 2: Переход в директорию сайта

Теперь перейдите в каталог (папку) вашего проекта, чтобы команды запускались именно для него.

Для этого используйте команду:

cd www/app.ваш_домен

Обязательно замените /var/www/app.ваш_домен на полный путь к вашему проекту.

Шаг 3: Запуск дополнительных команд для настройки проекта

Теперь нужно выполнить три команды Laravel, которые завершат подготовку проекта:

Введите каждую команду последовательно и после каждой нажимайте Enter:

php artisan product:apply-update

Важно: если при выполнении этой команды вы увидели любые предупреждения, ошибки или сообщения об отказе доступа (например, проблемы с правами на файлы или ошибки зависимостей), выполните команду повторно. Повторный запуск поможет устранить временные конфликты или неполные изменения, которые могли возникнуть при первом запуске. Если после повторного запуска ошибки сохраняются, обратитесь за технической поддержкой.

php artisan key:generate
php artisan reverb:install

Что делают эти команды:

• php artisan product:apply-update – устанавливает или обновляет базовые компоненты и выполняет все необходимые миграции для работы обменника.

• php artisan key:generate – генерирует уникальный ключ приложения, который будет использоваться для шифрования данных. Это важно для безопасности вашего сайта.

• php artisan reverb:install – настраивает работу сервиса Reverb, который обеспечивает обмен событиями в реальном времени. Это необходимо для работы уведомлений, статусов и других динамических функций на вашем сайте.