Установка сервера¶
В этой главе описывается установка сервера FIRERPA. Сервер FIRERPA — самый важный компонент и базовый низкоуровневый сервис. Вы можете установить его с помощью нашего приложения (поддерживает автозапуск), модуля Magisk (поддерживает автозапуск) или вручную. Их сложность установки возрастает по порядку.
Важно
По умолчанию в установленном FIRERPA не включена аутентификация, и другие лица могут получить доступ к любому содержимому устройства. Если вы устанавливаете и разворачиваете через приложение, вы можете включить аутентификацию в Конфигурации. При установке другими способами обратитесь к разделу Сертификат сервера, чтобы узнать, как включить сертификат. Если вы решите не включать его, обязательно используйте сервис только в доверенной сети, иначе повышается риск взлома устройства.
Установка через приложение¶
Сначала рассмотрим самый простой способ установки. Этот способ не требует никаких дополнительных действий: достаточно установить наш APK для автоматической установки и автозапуска. Подробную процедуру установки см. в разделе Быстрый старт.
Примечание
Дальнейшее содержимое относится к ручному развёртыванию и предназначено для случаев, когда нужно встроить сервер в ROM или самостоятельно запускать сервис FIRERPA. Если вы уже запустили сервер через приложение и у вас нет таких потребностей, этот раздел можно не читать.
Определение архитектуры устройства¶
Поскольку FIRERPA поддерживает несколько архитектур ЦП, загрузка сервера неправильной версии приведёт к невозможности его выполнения. Поэтому перед установкой необходимо узнать архитектуру текущего устройства. Выполните команду:
getprop ro.product.cpu.abi
На современных реальных телефонах эта команда обычно выводит arm64-v8a; в эмуляторах (например, LDPlayer) при создании эмулятора можно выбрать 32-битную или 64-битную систему Android: 32-битная соответствует x86, 64-битная — x86_64; для некоторых старых моделей Xiaomi — armeabi-v7a. Запомните это значение.
Конфигурация сервиса¶
См. раздел Конфигурация сервиса, чтобы узнать, как настроить параметры запуска сервиса; соответствующие сведения также приводятся в описаниях отдельных функций.
Установка через Magisk¶
Если на вашем устройстве используется Magisk, установку можно выполнить самым простым способом, и FIRERPA сможет автоматически запускаться при включении. Требуется Magisk версии ≥ 20.4, установка поддерживается только в Magisk App.
Скачайте lamda-magisk-module.zip со страницы релизов lamda/releases и поместите его в /sdcard. Откройте Magisk App, последовательно нажмите «Модули» → «Установить из хранилища», выберите lamda-magisk-module.zip и немного подождите.
Совет
Если появляется сообщение об ошибке и установка не удаётся, возможно, zip-архив модуля слишком большой. Откройте этот zip с помощью архиватора, удалите из каталога server файлы серверов для ненужных архитектур и установите заново. Не распаковывайте архив и не пересобирайте его заново.
После успешной прошивки перезагрузите устройство. После перезагрузки сервис FIRERPA запускается не сразу, а через 30 секунд после включения. Подключаться к FIRERPA следует через 1–2 минуты после включения.
Если вы хотите, чтобы при запуске сервиса автоматически устанавливался прокси или выполнялось подключение к FRP-пробросу и т. п., см. Конфигурация сервиса, создайте соответствующий конфигурационный файл в стандартном формате ini, переименуйте его в properties и поместите в папку common внутри zip-файла модуля lamda-magisk-module.zip. Если при установке модуля Magisk необходимо заранее подготовить сертификат сервера, сгенерируйте PEM-сертификат согласно разделу Сертификат сервера, переименуйте его в lamda.pem и также поместите в папку common модуля. Если требуется авторизация встроенного ADB по умолчанию, запишите содержимое вашего локального файла adbkey.pub в файл adb_keys и поместите его в папку common.
Внимание
Рекомендуется открывать lamda-magisk-module.zip с помощью архиватора, не распаковывать архив и не пересобирать его. Обязательно выполняйте операции перетаскиванием непосредственно в архиваторе или строго сохраняйте структуру каталогов внутри модуля, иначе модуль может работать неправильно.
Ручная установка¶
Скачайте последнюю версию lamda-server-arm64-v8a.tar.gz со страницы релизов lamda/releases и с помощью adb push поместите файл во временный каталог устройства /data/local/tmp.
adb push lamda-server-arm64-v8a.tar.gz /data/local/tmp
Затем войдите в adb shell. Если устройство имеет root-права, сначала выполните su для смены пользователя; в противном случае можно выполнять следующие команды от текущего shell-пользователя:
INSTALLDIR=$( [ $(id -u) -eq 0 ] && echo /data/ || echo /data/local/tmp )
echo "Server install directory: $INSTALLDIR/server"
tar -C $INSTALLDIR -xzf /data/local/tmp/lamda-server-arm64-v8a.tar.gz
rm /data/local/tmp/lamda-server-arm64-v8a.tar.gz
Внимание
На некоторых старых устройствах системная команда tar может не распаковывать файлы .tar.gz, поэтому дополнительно предоставляется busybox; возможно, потребуется скачать этот busybox. Скачайте busybox-arm64-v8a со страницы lamda/releases/tag/v10.0, временно поместите файл в /data/local/tmp и распакуйте с помощью /data/local/tmp/busybox-arm64-v8a tar.
Ручной запуск¶
Внимание
FIRERPA, установленный через Magisk или приложение, автоматически запускается при включении устройства.
Подсказка
При первом запуске иногда удалённый рабочий стол может долго загружаться. Если это произошло, сначала попробуйте перезагрузить устройство и снова запустить сервис FIRERPA. Если после долгого ожидания он по-прежнему не работает, сообщите нам об этой проблеме.
Подсказка
Сервис FIRERPA поддерживает запуск от root или shell. Если вам нужны полные возможности, запускайте сервер от root.
Войдите в adb shell и выполните следующую команду от пользователя shell или root в зависимости от ситуации на устройстве. После выполнения дождитесь возврата из команды. Если выводится llllaamDaa started, это означает, что сервис успешно запущен и перешёл в фоновый режим; можно выйти из adb shell и подключиться к сервису FIRERPA. В противном случае воспользуйтесь приведёнными ниже сообщениями об ошибках для диагностики.
sh /data/server/bin/launch.sh
Удаление сервиса¶
FIRERPA очень аккуратно планирует собственные данные и никогда не размещает файлы в произвольных местах системы. Пользователи, устанавливавшие через Magisk, могут просто удалить модуль; пользователи приложения могут воспользоваться функцией удаления в приложении.
Опасно
Используйте эти функции с осторожностью: эти каталоги содержат данные, связанные с использованием сервиса FIRERPA, и операция удаления полностью удалит FIRERPA и все созданные им данные без возможности восстановления.
Перед удалением сначала завершите работу сервиса и подождите не менее 30 секунд, чтобы сервис корректно завершился.
rm -rf /data/server /data/usr # /data/local/tmp/usr
Таким образом FIRERPA будет полностью удалён с вашего устройства. После выполнения рекомендуется перезагрузить устройство.