Installation des Servers¶

Dieses Kapitel beschreibt die Installation des FIRERPA-Servers. Der FIRERPA-Server ist die wichtigste Komponente und der grundlegendste Basisdienst. Sie können zwischen der Installation über eine AUTORUN-APP (unterstützt Autostart), als Magisk-Modul (unterstützt Autostart) oder einer manuellen Installation wählen. Der Schwierigkeitsgrad der Installation entspricht der Reihenfolge der genannten Methoden.

Installation über die APP¶

Wir stellen die einfachste Methode zuerst vor. Diese Installationsmethode ist die unkomplizierteste und erfordert keine zusätzlichen Schritte von Ihnen. Sie müssen lediglich unsere APK für die automatische Installation und den Autostart installieren. Beachten Sie jedoch, dass Ihr Telefon über Root-Rechte (su) verfügen muss. Bei einigen chinesischen Smartphone-Modellen kann das standardmäßige Autostart-Verhalten von APKs deaktiviert sein. In diesem Fall müssen Sie möglicherweise die entsprechenden Einstellungen finden und unserer APK den Autostart erlauben.

Klicken Sie hier, um unsere FIRERPA-Autostart-Anwendung lamda-autorun.apk herunterzuladen. Öffnen Sie nach der Installation die APP, erteilen Sie die Root-Berechtigungen, aktivieren Sie den Autostart-Schalter und starten Sie das Gerät nach Abschluss der Installation neu. Wenn Sie dies erfolgreich abgeschlossen haben, müssen Sie den Rest dieses Kapitels nicht mehr lesen.

Ermitteln der Gerätearchitektur¶

Da FIRERPA mehrere CPU-Architekturen unterstützt, kann eine falsche Server-Version nicht korrekt ausgeführt werden. Daher müssen Sie vor der Installation die Architektur Ihres aktuellen Geräts ermitteln. Sie können dies mit dem folgenden Befehl tun.

getprop ro.product.cpu.abi

Normalerweise gibt dieser Befehl bei modernen, echten Smartphones arm64-v8a aus. Bei Emulatoren wie LDPlayer wird bei der Erstellung eines neuen Emulators zwischen einer 32-Bit- und einer 64-Bit-Version von Android gewählt. Ein 32-Bit-Emulator-System entspricht x86, während ein 64-Bit-System x86_64 entspricht. Einige ältere Xiaomi-Modelle verwenden armeabi-v7a. Bitte merken Sie sich diesen Ausgabewert.

Startkonfigurationsdatei¶

Informationen zum Erstellen der Startkonfiguration finden Sie im Kapitel Konfiguration von properties.local. Entsprechende Anleitungen finden sich auch bei den jeweiligen Funktionen.

Installation über Magisk¶

Wenn Ihr Gerät Magisk verwendet, können Sie die Installation auf die einfachste Weise durchführen, und FIRERPA kann automatisch beim Hochfahren starten. Stellen Sie sicher, dass Ihre Magisk-Version >= 20.4 ist und die Installation nur über die Magisk App unterstützt wird.

Laden Sie nun lamda-magisk-module.zip von der lamda/releases Seite herunter und pushen Sie es nach /sdcard. Öffnen Sie die Magisk App, klicken Sie auf Module -> Vom Speicher installieren, wählen Sie lamda-magisk-module.zip aus und warten Sie einen Moment.

Starten Sie nach dem erfolgreichen Flashen das Gerät neu. Nach dem Neustart sollte FIRERPA automatisch starten. Um jedoch mögliche Abstürze zu vermeiden, startet lamda mit einer Verzögerung von 30 Sekunden anstatt sofort. Dies gibt Ihnen genügend Zeit, das FIRERPA-Modul zu deaktivieren (bitte warten Sie nach dem Start 2 Minuten, bevor Sie sich mit FIRERPA verbinden).

Sie können auch eine benutzerdefinierte Konfiguration vornehmen. Wenn Sie beispielsweise für alle mit diesem Magisk-Modul installierten FIRERPA-Instanzen das API-Dienstzertifikat aktivieren oder möchten, dass sich diese Geräte beim Start automatisch mit einem Proxy verbinden, müssen Sie nur eine properties.local-Datei erstellen oder ein PEM-Zertifikat generieren und es in lamda.pem umbenennen (siehe die Anweisungen zur Verwendung der Tools in tools/). Öffnen Sie anschließend lamda-magisk-module.zip mit einer Komprimierungssoftware und ziehen Sie die von Ihnen erstellten Dateien (lamda.pem oder properties.local) in den common-Ordner, um die automatische Konfiguration beim Start zu ermöglichen.

Nach Abschluss der Installation müssen Sie den folgenden Abschnitt zur manuellen Installation nicht mehr lesen und können ihn überspringen.

Manuelle Installation¶

Da einige ältere Geräte möglicherweise keine .tar.gz-Dateien mit dem systemeigenen tar-Befehl entpacken können, stellen wir busybox als Ergänzung zur Verfügung. Möglicherweise müssen Sie das bereitgestellte busybox ebenfalls herunterladen. Angenommen, die Gerätearchitektur ist arm64-v8a. Verbinden Sie nun das Gerät mit Ihrem Computer und stellen Sie sicher, dass ADB autorisiert ist und Sie erfolgreich zu Root wechseln können.

Laden Sie lamda-server-arm64-v8a.tar.gz und busybox-arm64-v8a von der Release-Seite lamda/releases herunter und pushen Sie die Dateien temporär nach /data/local/tmp.

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

Öffnen Sie danach eine adb shell, führen Sie su aus, um zu Root-Rechten zu wechseln, und führen Sie dann die folgenden Befehle aus:

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

Nachdem alle Befehle fehlerfrei ausgeführt wurden, ist die Installation abgeschlossen. Bitte lesen Sie das Kapitel Starten des Servers, um zu erfahren, wie Sie den Dienst starten.