webvm

Webvm

Ce référentiel héberge le code source de https://webvm.io, une machine virtuelle Linux qui s'exécute dans votre navigateur.

Essayez le nouvel environnement graphique Alpine / Xorg / i3: https://webvm.io/alpine.html

WebVM est un environnement virtuel sans serveur exécutant entièrement le côté client dans HTML5 / WebAssembly. Il est conçu pour être compatible Linux ABI. Il gère une distribution Debian non modifiée, y compris de nombreuses chaînes d'outils de développement indigènes.

WebVM est propulsé par le moteur de virtualisation HEREPX et permet l'exécution sûre et side-client de binaires x86 sur n'importe quel navigateur. Cheerpx comprend un compilateur JIT x86-to-webassembly, un système de fichiers basé sur des blocs virtuels et un émulateur Linux Syscall.

Activer la mise en réseau

Les navigateurs modernes ne fournissent pas d'API pour utiliser directement TCP ou UDP. WebVM fournit une prise en charge de mise en réseau en intégrant avec TailScale, un réseau VPN qui prend en charge WebSockets en tant que couche de transport.

• Ouvrez le panneau "Networking" de la barre latérale
• Cliquez sur "Connecter à TailScale" dans le panneau
• Connectez-vous à TailScale (créez un compte si vous n'en avez pas)
• Cliquez sur "Connexion" lorsque vous avez invité par TailScale
• Si vous n'êtes pas familier avec TailScale ou si vous souhaitez des informations supplémentaires, voir WebVM et TailScale.

Fourche, déployer, personnaliser

• Fourk le référentiel.
• Activez les pages GitHub dans les paramètres.
  • Cliquez sur Settings .
  • Accédez à la section Pages .
  • Sélectionnez Github Actions comme source.
    • Si vous utilisez un domaine personnalisé, assurez-vous que Enforce HTTPS est activée.
• Exécutez le workflow.
  • Cliquez sur Actions .
  • Accepter l'invite. Ceci n'est requis qu'une seule fois pour permettre des actions pour votre fourchette.
  • Cliquez sur le workflow nommé Deploy .
  • Cliquez sur Run workflow , puis à une fois de plus, Run workflow dans le menu.
• Après quelques secondes, un nouveau flux de travail Deploy commencera, cliquez dessus pour voir les détails.
• Une fois le workflow terminé, ce qui prend quelques minutes, il affichera l'URL sous le travail deploy_to_github_pages .

Vous pouvez désormais personnaliser dockerfiles/debian_mini pour répondre à vos besoins, ou faire un nouveau dockerfile à partir de zéro. Utilisez le paramètre Path to Dockerfile Workflow pour le sélectionner.

Déploiement local

D'un git clone local

• Téléchargez l'image debian_mini ext2 depuis https://github.com/leaningtech/webvm/releases/
  • Vous pouvez également créer le vôtre en sélectionnant l'option "Télécharger GitHub Release" Workflow
  • Placer l'image dans le dossier racine du référentiel
• Modifier config_github_terminal.js
  • Décommente les valeurs par défaut pour CMD , ARGS , ENV et CWD
  • Remplacez IMAGE_URL par l'URL (absolue ou relative) pour l'image EXT2. Par exemple "/debian_mini_20230519_5022088024.ext2"
• Build webvm à l'aide de npm , la sortie sera placée dans le répertoire build
  • npm install
  • npm run build
• Démarrer Nginx, il pointe automatiquement vers le répertoire build qui vient d'être créé
  • nginx -p . -c nginx.conf
• Visitez http://127.0.0.1:8081 et profitez de votre webvm local

Exemple Personnalisation: Python3 REPL

Le flux de travail Deploy prend en compte le CMD spécifié dans le dockerfile. Pour créer un REP, vous pouvez simplement appliquer ce correctif et déployer.

 diff --git a/dockerfiles/debian_mini b/dockerfiles/debian_mini
index 2878332..1f3103a 100644
--- a/dockerfiles/debian_mini
+++ b/dockerfiles/debian_mini
@@ -15,4 +15,4 @@ WORKDIR /home/user/
 # We set env, as this gets extracted by Webvm. This is optional.
 ENV HOME="/home/user" TERM="xterm" USER="user" SHELL="/bin/bash" EDITOR="vim" LANG="en_US.UTF-8" LC_ALL="C"
 RUN echo 'root:password' | chpasswd
- CMD [ "/bin/bash" ]
+ CMD [ "/usr/bin/python3" ]

Bogues et problèmes

Veuillez utiliser des problèmes pour signaler tout bogue. Ou venez dire bonjour / partager vos commentaires sur Discord.

Plus de liens

• Webvm: machines virtuelles x86 sans serveur dans le navigateur
• WebVM: Virtualisation Linux dans WebAssembly avec un réseautage complet via TailScale
• Mini.webvm: votre propre boîte Linux de Dockerfile, virtualisée dans le navigateur via webassembly
• Référence GitHub Pages Déploiement: mini.webvm
• Création de l'impossible: virtualisation x86 dans le navigateur avec webassembly talk at JSNation 2022

Grâce à...

Ce projet dépend de:

• Cheerpx, fabriqué par des technologies penchées pour la virtualisation x86 et l'émulation Linux
• xterm.js, https://xtermjs.org/, pour avoir fourni l'émulateur de terminal basé sur le Web
• TailScale, pour le composant de réseautage
• Lwip, pour la pile TCP / IP, compilé pour le Web via Cheerp

Versioning

WebVM dépend de la technologie de virtualisation de Cheerpx x86-to-webassembly, qui est incluse dans le projet via NPM.

Le package NPM est mis à jour à chaque version.

Chaque version est immuable, si une version spécifique fonctionne bien pour vous aujourd'hui, elle continuera de fonctionner pour toujours.

Licence

WebVM est publié sous la licence Apache, version 2.0.

Vous êtes invités à utiliser, modifier et redistribuer le contenu de ce référentiel.

Le déploiement public Cheerpx est fourni tel quel et est libre à utiliser pour l'exploration technologique, les tests et l'utilisation par les particuliers. Toute autre utilisation par les organisations, y compris à but non lucratif, universitaire et le secteur public, nécessite une licence. Le téléchargement d'une version de Cheerpx dans le but de l'héberger ailleurs n'est pas autorisé sans licence commerciale.

En savoir plus sur les licences Cheerpx

Si vous souhaitez construire un produit au-dessus de cheerpx / webvm, veuillez nous contacter: [email protected]