115 lines
2.6 KiB
Markdown
115 lines
2.6 KiB
Markdown
# Paramètres URL
|
||
|
||
Hackademy Linux - Paramètres d'URL pour la configuration de la machine virtuelle
|
||
|
||
## Synopsis
|
||
|
||
```
|
||
https://linux.hackade.org/?[OPTION]=[VALEUR]&[OPTION]=[VALEUR]...
|
||
```
|
||
|
||
## Description
|
||
|
||
Hackademy Linux accepte des paramètres dans son URL pour configurer le comportement de la machine virtuelle au lancement.
|
||
|
||
Exemple :
|
||
|
||
```
|
||
https://linux.hackade.org/?disk=practice&autologin=user&autostart=true
|
||
```
|
||
|
||
## Options
|
||
|
||
### disk
|
||
|
||
Sélectionne l'image système à utiliser pour la machine virtuelle.
|
||
|
||
**Valeurs possibles :**
|
||
|
||
- `core` - Image minimale
|
||
- `server` - Image serveur
|
||
- `practice` - Image d’entraînement (par défaut)
|
||
- `play` - Image de jeu
|
||
|
||
**Valeur par défaut :** `practice`
|
||
|
||
### autologin
|
||
|
||
Active la connexion automatique à la machine virtuelle au lancement.
|
||
|
||
**Valeurs possibles :**
|
||
|
||
- (vide) - Pas de connexion automatique
|
||
- `user` - Connexion en tant qu'utilisateur standard
|
||
- `root` - Connexion en tant qu'utilisateur root
|
||
|
||
**Valeur par défaut :** Désactivé
|
||
|
||
### autostart
|
||
|
||
Détermine si la machine virtuelle démarre automatiquement au chargement de la page.
|
||
|
||
**Valeurs possibles :**
|
||
|
||
- `true` - Démarrage automatique
|
||
- `false` - Démarrage manuel
|
||
|
||
**Valeur par défaut :** `true`
|
||
|
||
### custom_init
|
||
|
||
Spécifie un script personnalisé qui sera exécuté en tant que root lors de la séquence de démarrage.
|
||
|
||
**Format :** Le script doit être encodé en base64url.
|
||
|
||
**Comportement :**
|
||
|
||
- Lorsque ce paramètre est défini, `autostart` est automatiquement désactivé
|
||
- Un message affiche le code dans la console avant le démarrage
|
||
|
||
**Encodage du script :**
|
||
|
||
Pour encoder votre script, utilisez les commandes `base64url_encode` et `base64url_decode` au sein de Hackademy Linux, ou la commande suivante :
|
||
|
||
```sh
|
||
cat init_script.sh | base64 -w0 | tr '+/' '-_' | tr -d '='
|
||
```
|
||
|
||
**Exemple :**
|
||
|
||
Script d'origine :
|
||
|
||
```sh
|
||
#!/bin/sh -l
|
||
|
||
echo "Here's an example of the custom_init functionality."
|
||
opkg update && opkg install tmux
|
||
```
|
||
|
||
URL :
|
||
|
||
```
|
||
https://linux.hackade.org/?custom_init=IyEvYmluL3NoIC1sCmVjaG8gIkhlcmUncyBhbiBleGFtcGxlIG9mIHRoZSBjdXN0b21faW5pdCBmdW5jdGlvbmFsaXR5LiIKb3BrZyB1cGRhdGUgJiYgb3BrZyBpbnN0YWxsIHRtdXgK
|
||
```
|
||
|
||
### persistence
|
||
|
||
Active le montage d'un disque persistant dont le contenu est stocké dans le navigateur.
|
||
|
||
**Comportement :**
|
||
|
||
- Crée un périphérique `/dev/sdb`
|
||
- Monté automatiquement dans `/data`
|
||
- Les données persistent au redémarrage de la VM
|
||
- Les données sont conservées tant que l'historique du navigateur n'est pas effacé
|
||
|
||
**Synchronisation des données :**
|
||
|
||
Pour éviter toute perte de données, synchronisez le système de fichiers avant d'arrêter Hackademy :
|
||
|
||
```sh
|
||
sync
|
||
```
|
||
|
||
**Valeur par défaut :** Désactivé
|