# Installation du serveur

Ce chapitre explique comment installer le serveur FIRERPA. Le serveur FIRERPA est le composant le plus important et le service de base fondamental. Vous pouvez choisir de l'installer via une application AUTORUN (qui prend en charge le démarrage automatique), un module Magisk (qui prend en charge le démarrage automatique) ou manuellement. La difficulté d'installation correspond à cet ordre.

```{important}
Par défaut, l'installation de FIRERPA n'active aucune authentification, ce qui permet à d'autres personnes d'accéder à n'importe quel contenu sur l'appareil. Veuillez prêter attention à la section sur l'activation des certificats de service pour activer sélectivement les certificats. Si vous ne les activez pas, assurez-vous d'utiliser le service uniquement sur un réseau de confiance.
```

```{attention}
Pour des raisons de sécurité, nous ne recommandons pas de placer des fichiers pertinents, tels que le serveur ou la configuration, dans le répertoire /data/local.
```

## Installation via l'application

Nous commencerons par la méthode la plus simple. Cette méthode d'installation est la plus facile et ne nécessite aucune opération supplémentaire de votre part. Il vous suffit d'installer notre APK d'installation et de démarrage automatique. Cependant, vous devez toujours vous assurer que votre téléphone dispose des permissions root (su). De plus, sur certains modèles de téléphones de fabricants chinois, le comportement de démarrage automatique par défaut de l'APK peut être désactivé. Dans ce cas, vous devrez peut-être trouver les paramètres correspondants et autoriser notre APK à démarrer automatiquement.

Cliquez pour télécharger notre application de démarrage automatique FIRERPA [lamda-autorun.apk](https://lamda-assets.s3.bitiful.net/release/latest/lamda-autorun.apk). Après l'installation, ouvrez l'application, accordez les permissions root, activez le commutateur de démarrage automatique, attendez la fin de l'installation, puis redémarrez l'appareil. Si vous avez réussi, vous n'avez pas besoin de lire le reste de ce chapitre.

## Obtenir l'architecture de l'appareil

Comme FIRERPA prend en charge plusieurs architectures CPU, le téléchargement d'une version incorrecte du serveur empêchera son exécution correcte. Par conséquent, avant l'installation, vous devez obtenir l'architecture de votre appareil actuel. Vous pouvez exécuter la commande suivante pour l'obtenir.

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

Normalement, pour les téléphones modernes, cette commande affichera `arm64-v8a`. Pour les émulateurs comme LDPlayer, vous choisirez une version 32 ou 64 bits d'Android lors de la création d'un nouvel émulateur.
Un système d'émulateur 32 bits correspond à `x86`, tandis qu'un 64 bits correspond à `x86_64`. Certains anciens modèles de Xiaomi sont en `armeabi-v7a`. Veuillez mémoriser cette valeur de sortie.

## Fichier de configuration de démarrage

Veuillez consulter le chapitre `Configuration de properties.local` pour savoir comment rédiger la configuration de démarrage. Des informations pertinentes seront également fournies dans les sections relatives aux différentes fonctionnalités.

## Installation via Magisk

Si votre appareil utilise Magisk, vous pouvez effectuer l'installation de la manière la plus simple, et FIRERPA pourra **démarrer automatiquement au lancement de l'appareil**. Assurez-vous que votre version de Magisk est >= 20.4 et que l'installation se fait uniquement via l'**application Magisk**.

Maintenant, depuis la page des versions [lamda/releases](https://github.com/firerpa/lamda/releases), téléchargez `lamda-magisk-module.zip` et poussez-le (push) vers `/sdcard`. Ouvrez l'application Magisk, cliquez sur Modules -> Installer depuis le stockage, sélectionnez lamda-magisk-module.zip et attendez un instant.

```{tip}
Si une erreur (ERROR) se produit pendant l'installation et que celle-ci ne se déroule pas normalement, c'est peut-être parce que notre archive de module est trop volumineuse. Utilisez un logiciel de compression pour ouvrir l'archive et supprimer les fichiers de serveur pour les architectures dont vous n'avez pas besoin dans le répertoire `server`, puis réessayez l'installation. Ne décompressez pas pour recompresser ensuite ; effectuez l'opération directement dans le logiciel de compression.
```

Après avoir flashé avec succès, veuillez redémarrer l'appareil. Après le redémarrage, FIRERPA devrait démarrer automatiquement. Cependant, pour éviter d'éventuels problèmes de plantage, lamda démarrera après 30 secondes au lieu de démarrer immédiatement. Vous aurez suffisamment de temps pour désactiver le module FIRERPA (veuillez attendre 2 minutes après le démarrage avant de vous connecter et d'utiliser FIRERPA).

Vous pouvez également choisir une configuration personnalisée. Par exemple, si vous souhaitez que tous les FIRERPA installés via ce module Magisk activent le certificat de service de l'interface, ou si vous souhaitez que ces appareils se connectent automatiquement à un proxy au démarrage, il vous suffit de créer un fichier `properties.local` ou de générer un certificat PEM et de le renommer en `lamda.pem` (veuillez consulter la documentation des outils dans `tools/` pour savoir comment l'utiliser). Ensuite, utilisez un **logiciel de compression** pour ouvrir `lamda-magisk-module.zip` et glissez-déposez les fichiers que vous souhaitez configurer (`lamda.pem` ou `properties.local`) dans le dossier `common` pour réaliser une configuration automatique au démarrage.

```{attention}
Veuillez ne pas décompresser puis recompresser. Effectuez l'opération de glisser-déposer directement dans le logiciel de compression, sinon le module ne fonctionnera pas correctement.
```

Une fois l'installation terminée, vous n'avez pas besoin de lire la section suivante sur l'installation manuelle ; vous pouvez la sauter.

## Installation manuelle

Comme certains appareils anciens peuvent ne pas être en mesure de décompresser les fichiers .tar.gz avec la commande `tar` du système, nous fournissons `busybox` en complément. Vous devrez peut-être également télécharger le `busybox` fourni. Sachant maintenant que l'architecture de l'appareil est `arm64-v8a`, connectez l'appareil à votre ordinateur et assurez-vous que l'ADB est autorisé et que vous pouvez passer en mode root normalement.

Depuis la page des versions [lamda/releases](https://github.com/firerpa/lamda/releases),
téléchargez `lamda-server-arm64-v8a.tar.gz` et `busybox-arm64-v8a`, et poussez (push) temporairement les fichiers vers /data/local/tmp.

```{tip}
Nous vous présentons ici uniquement comment décompresser et installer manuellement le serveur. Le processus de démarrage est décrit dans un autre chapitre.
```

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

Une fois terminé, entrez dans `adb shell`, exécutez `su` pour passer à l'identité root, puis exécutez les commandes suivantes :

```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
```

Une fois que toutes les commandes ont été exécutées correctement et sans erreur, l'installation est terminée. Veuillez consulter le chapitre `Démarrage du serveur` pour savoir comment lancer le programme de service.