ben/wiki
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Amélioration de la documentation de Hackademy Linux

Browse Source
This commit is contained in:
ben
2025-11-04 22:07:27 +01:00
parent 3c01244a36
commit a57fe3b041
8 changed files with 44 additions and 60 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
hackademy.mdwn
View File

@@ -6,11 +6,13 @@ Basé sur un environnement Linux émulé dans le navigateur, Hackademy Linux per
La plateforme est personnalisable directement via l'URL afin de s'adapter à plusieurs scénarios et cas d'usage. La plateforme est personnalisable directement via l'URL afin de s'adapter à plusieurs scénarios et cas d'usage.
[[!note "Ce projet est en cours de développement et peut être très instable."]] [[!note "Hackademy Linux est entièrement exécuté dans le navigateur via l'émulateur [v86](https://github.com/copy/v86). Le système de fichiers de la machine virtuelle est stocké dans la mémoire vive du navigateur. Actuellement, il n'est pas possible de sauvegarder l'état de la machine virtuelle ; un rechargement de la page réinitialise l'environnement. Aucune donnée n'est envoyée sur un serveur, tout se passe en local dans votre navigateur."]]
[[!caution "Ce projet est en cours de développement et peut être très instable."]]
## Accès ## Accès
Hackademy Linux est disponible à l'URL : [linux.hackade.org](https://linux.hackade.org) Hackademy Linux est disponible à l’adresse : [linux.hackade.org](https://linux.hackade.org)
Les identifiants pour se connecter sont "__user__" comme utilisateur et "__hackademy__" comme mot de passe. Les identifiants pour se connecter sont "__user__" comme utilisateur et "__hackademy__" comme mot de passe.
@@ -27,7 +29,11 @@ Il est également possible de se connecter sans s'identifier avec l'URL: [linux.
* Accès au navigateur depuis la VM avec [host_browser](host_browser). * Accès au navigateur depuis la VM avec [host_browser](host_browser).
* [Gestionnaire de paquets](packages). * [Gestionnaire de paquets](packages).
## Applications
* [Lab d'utilisation de Git](https://linux.hackade.org/?autologin=user&custom_init=IyEvYmluL3NoIC1sCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCBnaXQK)
* [Lab d'utilisation de DuckDB](https://linux.hackade.org/?autologin=user&custom_init=IyEvYmluL3NoIC1sCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCBkdWNrZGIK)
* [Lab d'utilisation de GnuPG](https://linux.hackade.org/?autologin=user&custom_init=IyEvYmluL3NoIC1sCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCBnbnVwZzIK)
## Scénarios
.. à venir ..

8
hackademy/file_transfert.mdwn
View File

@@ -1,15 +1,15 @@
# Transfert de fichiers # Transfert de fichiers
Zmodem et [Trzsz](https://trzsz.github.io/go) sont supporté pour échanger des fichiers avec la VM. [Zmodem](https://en.wikipedia.org/wiki/ZMODEM) et [Trzsz](https://trzsz.github.io/go) sont supporté pour échanger des fichiers avec la machine virtuelle.
## Zmodem ## Zmodem
Il est disponible sur toutes les images et avec tous les navigateurs, grâce aux commandes __sz__ et __rz__. Il est disponible sur l'image __Core__ et fonctionne avec tous les navigateurs, grâce aux commandes __sz__ (send) et __rz__ (receive).
## Trzsz ## Trzsz
L'outil est disponible à partir de l'image "Minimal" avec les commandes __trz__ et __tsz__. L'outil est disponible à partir de l'image __Minimal__ ou avec __opkg__ avec les commandes __tsz__ (send) et __tzz__ (receive).
Il a l'avantage de fonctionner au sein de tmux et d'afficher une progression. Il a l'avantage de fonctionner dans une console tmux et d'afficher une progression.
Fonctionne qu'avec un nombre réduit de navigateurs (voir [compatibilité](https://developer.mozilla.org/en-US/docs/Web/API/Window/showOpenFilePicker#browser_compatibility)). Fonctionne qu'avec un nombre réduit de navigateurs (voir [compatibilité](https://developer.mozilla.org/en-US/docs/Web/API/Window/showOpenFilePicker#browser_compatibility)).

5
hackademy/host_browser.mdwn
View File

@@ -1,7 +1,8 @@
# host_browser # host_browser
Un canal de communication existe entre la machine virtuelle et le navigateur afin que la VM puisse interagir avec le navigateur. Un canal de communication existe afin qu'il soit possible d'interagir avec le navigateur depuis le shell.
La virtio_console est utilisée via le périphérique /dev/hvc0.
`host_browser` est disponible dans l'image __Core__ et permet d'utiliser ce canal.
``` ```
Usage: host_browser [-h] Usage: host_browser [-h]

51
hackademy/images.mdwn
View File

@@ -1,47 +1,12 @@
# Images # Images
[[!note "Les images sont en cours développements"]] [[!caution "Les images sont en cours développements"]]
## Core [[!table class="table" data="""
Nom de l'image | Paramètres URL | Taille | Contenu |
Core | [disk=core](https://linux.hackade.org/?disk=core) | bzImage: 3M, initramfs: 1,7M | util_linux, lrzsz, opkg |
Minimal | [disk=minimal](https://linux.hackade.org/?disk=minimal) | squashfs overlay: 4,5M | \+ shell config, trzsz |
Basic | [disk=basic](https://linux.hackade.org/?disk=basic) | squashfs overlay: 9,5M | \+ sudo, tmux, vim |
Normal | [disk=normal](https://linux.hackade.org/?disk=normal) | squashfs overlay: 9,7M | \+ strace |
"""]]
Accessible avec le paramètre [disk=core](https://linux.hackade.org/?disk=core) c'est l'image la plus petite possible. Elle comprends le noyau Linux (3,0M) et l'initramfs (1,7M).
Les paquets suivants sont disponibles:
* util_linux
* lrzsz
* opkg
## Minimal
Taille: 4,5M
C'est l'image par défaut si aucune image n'est paramétrée. C'est un overlay au-dessus de Core qui ajoute les éléments suivants:
* La configuration du shell pour les utilisateurs root et user
* l'outil trzsz
## Basic
Taille: 9,5M
Accessible avec le paramètre [disk=basic](https://linux.hackade.org/?disk=basic) c'est un overlay au dessus de Core qui ajoute les éléments suivants:
* La configuration du shell pour les utilisateurs root et user
* trzsz
* sudo
* tmux
* vim
## Normal
Taille: 9,7M
Accessible avec le paramètre [disk=normal](https://linux.hackade.org/?disk=normal) c'est un overlay au dessus de Core qui ajoute les éléments suivants:
* La configuration du shell pour les utilisateurs root et user
* trzsz
* sudo
* tmux
* vim
* strace

14
hackademy/packages.mdwn
View File

@@ -2,6 +2,16 @@
Il est possible d'ajouter des paquets avec le gestionnaire __opkg__. Il est possible d'ajouter des paquets avec le gestionnaire __opkg__.
[[!note "La création des paquets est en cours de développement"]] [[!caution "La création des paquets est en cours de développement"]]
[Listes des paquets](https://linux.hackade.org/Packages.txt) [URL de fichier Packages](https://linux.hackade.org/Packages.txt)
[[!table class="table" data="""
Paquet | Version | Origine | Test |
DuckDB | 1.4.1 | Custom | OK |
Trzsz | 1.1.8 | Custom | OK |
Git | 2.50.1 | Buildroot | OK |
Tmux | 3.5 | Buildroot | OK |
Vim | 9.1 | Buildroot | OK |
GnuPG | 2.4.8 | Buildroot | OK |
"""]]

8
hackademy/url.mdwn
View File

@@ -15,11 +15,11 @@ La sélection de l'image se fait avec le paramètre __disk__. Les images disponi
## Login automatique ## Login automatique
Le paramètre __autoLogin__ permet de se connecter directement à la VM au lancement. Trois options sont possibles : rien, user ou root. Par défaut l'autologin n'est pas activé. Le paramètre __autoLogin__ permet de se connecter directement à la machine virtuelle au lancement. Trois options sont possibles : rien, user ou root. Par défaut l'autologin n'est pas activé.
## Démarrage automatique ## Démarrage automatique
Le paramètre __autostart__ permet d'indiquer si au chargement de la page, la VM doit démarrer. Par défaut le démarrage est automatique. Le paramètre __autostart__ permet d'indiquer si au chargement de la page, la machine virtuelle doit démarrer. Par défaut le démarrage est automatique.
## Script d'initialisation personnalisé ## Script d'initialisation personnalisé
@@ -38,10 +38,10 @@ Lorsque __custom_init__ est paramétré, __autostart__ est automatiquement désa
Exemple avec le script suivant: Exemple avec le script suivant:
```sh ```sh
#!/bin/sh #!/bin/sh -l
echo "Here's an example of the custom_init functionality." echo "Here's an example of the custom_init functionality."
opkg update && opkg install tmux opkg update && opkg install tmux
``` ```
[https://linux.hackade.org/?custom_init=IyEvYmluL3NoCgplY2hvI...](https://linux.hackade.org/?custom_init=IyEvYmluL3NoCgplY2hvICJIZXJlJ3MgYW4gZXhhbXBsZSBvZiB0aGUgY3VzdG9tX2luaXQgZnVuY3Rpb25hbGl0eS4iCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCB0bXV4Cg) [https://linux.hackade.org/?custom_init=IyEvYmluL3NoCgplY2hvI...](https://linux.hackade.org/?custom_init=IyEvYmluL3NoIC1sCmVjaG8gIkhlcmUncyBhbiBleGFtcGxlIG9mIHRoZSBjdXN0b21faW5pdCBmdW5jdGlvbmFsaXR5LiIKb3BrZyB1cGRhdGUgJiYgb3BrZyBpbnN0YWxsIHRtdXgK)

2
wiki/shell/commands/DuckDB.mdwn
View File

@@ -1,6 +1,6 @@
# DuckDB dans un script shell # DuckDB dans un script shell
[Lab Hackademy Linux](https://linux.hackade.org/?custom_init=IyEvYmluL3NoCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCBkdWNrZGIK) [Expérimentez DuckDB dans votre navigateur avec Hackademy Linux](https://linux.hackade.org/?autologin=user&custom_init=IyEvYmluL3NoIC1sCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCBkdWNrZGIK)
## Créer une base de donnée: ## Créer une base de donnée:

2
wiki/shell/commands/Git.mdwn
View File

@@ -1,5 +1,7 @@
# Git # Git
[Expérimentez Git dans votre navigateur avec Hackademy Linux](https://linux.hackade.org/?autologin=user&custom_init=IyEvYmluL3NoIC1sCm9wa2cgdXBkYXRlICYmIG9wa2cgaW5zdGFsbCBnaXQK)
## Exécuter git depuis un autre répertoire que celui du dépôt: ## Exécuter git depuis un autre répertoire que celui du dépôt:
``` ```