# Установка сервера

В этой главе описывается, как установить сервер FIRERPA. Сервер FIRERPA является самым важным и базовым компонентом. Вы можете выбрать установку через приложение AUTORUN APP (с поддержкой автозапуска при загрузке), в виде модуля Magisk (с поддержкой автозапуска при загрузке) или ручную установку. Сложность установки соответствует порядку их перечисления.

```{important}
При установке по умолчанию в FIRERPA не включена аутентификация, что позволяет другим пользователям получать доступ к любому содержимому на устройстве. Обратите внимание на раздел о включении сертификатов службы и выборочно включите их. Если вы не включите сертификаты, обязательно используйте FIRERPA только в доверенных сетях.
```

```{attention}
По соображениям безопасности мы не рекомендуем размещать какие-либо связанные файлы, такие как сервер или конфигурации, в каталоге /data/local.
```

## Установка через приложение (APP)

Самый простой способ мы опишем в первую очередь. Этот метод установки является самым легким и не требует от вас никаких лишних действий. Вам нужно всего лишь установить наш APK для автоматической установки и автозапуска. Однако следует учесть, что вашему телефону необходимы root-права (su), и на некоторых моделях китайских телефонов поведение автозапуска APK по умолчанию может быть запрещено. В этом случае вам может потребоваться найти соответствующие настройки и разрешить автозапуск нашего APK.

Нажмите, чтобы скачать наше приложение для автозапуска FIRERPA [lamda-autorun.apk](https://lamda-assets.s3.bitiful.net/release/latest/lamda-autorun.apk). После установки откройте приложение, предоставьте root-права, включите переключатель автозапуска и дождитесь завершения установки, после чего перезагрузите устройство. Если вы успешно выполнили эти шаги, вам не нужно читать оставшуюся часть этой главы.

## Определение архитектуры устройства

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

```bash
getprop ro.product.cpu.abi
```

Обычно для современных реальных телефонов эта команда выводит `arm64-v8a`. Для эмуляторов, таких как LDPlayer, при создании нового эмулятора выбирается 32-битная или 64-битная версия Android. 32-битная система эмулятора соответствует `x86`, а 64-битная — `x86_64`. Некоторые старые модели Xiaomi используют `armeabi-v7a`. Запомните полученное значение.

## Файл конфигурации запуска

Пожалуйста, обратитесь к главе `Конфигурация properties.local` за информацией о том, как составить конфигурацию запуска. Соответствующая информация также будет представлена в разделах, посвященных различным функциям.

## Установка через Magisk

Если на вашем устройстве используется Magisk, вы можете выполнить установку самым простым способом, и FIRERPA будет **запускаться автоматически при загрузке системы**. Убедитесь, что версия Magisk >= 20.4, и установка поддерживается только через **приложение Magisk**.

Теперь скачайте `lamda-magisk-module.zip` со страницы релизов [lamda/releases](https://github.com/firerpa/lamda/releases) и скопируйте его в `/sdcard`. Откройте приложение Magisk, нажмите Модули -> Установить из хранилища, выберите lamda-magisk-module.zip и немного подождите.

```{tip}
Если в процессе установки возникает какая-либо ошибка ERROR и установка не завершается корректно, возможно, это связано с большим размером нашего архивного модуля. Используйте программу-архиватор, чтобы открыть архив и удалить файлы сервера для ненужных архитектур из каталога server, а затем повторите установку. Не распаковывайте и не сжимайте архив заново, выполняйте операции непосредственно в архиваторе.
```

После успешной установки модуля перезагрузите устройство. После перезагрузки FIRERPA должен запуститься автоматически. Однако, чтобы избежать возможных сбоев, lamda запускается через 30 секунд после загрузки, а не немедленно. У вас будет достаточно времени, чтобы отключить модуль FIRERPA (пожалуйста, подключайтесь к FIRERPA через 2 минуты после загрузки устройства).

Вы также можете настроить конфигурацию по своему усмотрению. Например, если вы хотите, чтобы все установленные с помощью этого модуля Magisk серверы FIRERPA использовали сертификаты службы API, или чтобы эти устройства автоматически подключались к прокси при запуске, вам нужно всего лишь создать файл `properties.local` или сгенерировать PEM-сертификат и переименовать его в `lamda.pem` (см. инструкции по использованию инструментов в `tools/`). Затем с помощью **программы-архиватора** откройте `lamda-magisk-module.zip` и перетащите ваши файлы (`lamda.pem` или `properties.local`) в папку `common`, чтобы они автоматически применялись при запуске.

```{attention}
Не распаковывайте и не сжимайте архив заново. Выполняйте операции перетаскивания непосредственно в программе-архиваторе, иначе модуль не будет работать корректно.
```

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

## Ручная установка

Поскольку некоторые старые устройства могут не поддерживать распаковку файлов с расширением .tar.gz с помощью системной команды `tar`, мы предоставляем `busybox` в качестве дополнения. Возможно, вам потребуется также скачать предоставленный busybox. Предположим, что архитектура вашего устройства — `arm64-v8a`. Подключите устройство к компьютеру, убедитесь, что ADB авторизован и можно переключиться в режим root.

Со страницы релизов [lamda/releases](https://github.com/firerpa/lamda/releases)
скачайте `lamda-server-arm64-v8a.tar.gz` и `busybox-arm64-v8a`, а затем временно скопируйте файлы в /data/local/tmp.

```{tip}
Здесь мы только описываем, как вручную распаковать и установить сервер. Процесс запуска описан в другой главе.
```

```bash
adb push lamda-server-arm64-v8a.tar.gz /data/local/tmp
adb push busybox-arm64-v8a /data/local/tmp
```

После завершения войдите в `adb shell`, выполните `su` для переключения на пользователя root, а затем выполните следующие команды:

```bash
chmod 755 /data/local/tmp/busybox-arm64-v8a

/data/local/tmp/busybox-arm64-v8a tar -C /data -xzf /data/local/tmp/lamda-server-arm64-v8a.tar.gz

rm /data/local/tmp/lamda-server-arm64-v8a.tar.gz
rm /data/local/tmp/busybox-arm64-v8a
```

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