webvm

Webvm

In diesem Repository wird der Quellcode für https://webvm.io, eine linux -virtuelle Maschine, die in Ihrem Browser ausgeführt wird, veranstaltet.

Probieren Sie die neue grafische Umgebung von Alpine/Xorg/i3 aus: https://webvm.io/alpine.html

WebVM ist eine serverlose virtuelle Umgebung, die in HTML5/WebAssembly vollständig clientseitig ausführt. Es ist als linux abi-kompatibel gestaltet. Es führt eine unmodifizierte Debian -Verteilung aus, darunter viele Toolchains für native Entwicklung.

WebVM wird von der Cheerpx-Virtualisierungs-Engine betrieben und ermöglicht eine sichere, sandkäfige Client-Seite-Ausführung von X86-Binärdateien auf jedem Browser. Chefx enthält einen JIT-Compiler von X86-to-WebaSembly, ein virtuelles blockbasiertes Dateisystem und einen Linux-Syscall-Emulator.

Networking aktivieren

Moderne Browser bieten keine APIs zur direkten Verwendung von TCP oder UDP. WebVM bietet Networking -Unterstützung durch Integration in TailScale, ein VPN -Netzwerk, das WebSockets als Transportschicht unterstützt.

• Öffnen Sie das "Networking" -Panel von der Seitenleiste
• Klicken Sie von der Panel "Verbindung zu Tailscale" herstellen
• Melden Sie sich bei Heckscale an (erstellen Sie ein Konto, wenn Sie keine haben)
• Klicken Sie auf "Verbinden", wenn Sie von Tailscale aufgefordert werden
• Wenn Sie mit Tailscale nicht vertraut sind oder zusätzliche Informationen wünschen, siehe WebVM und Tailcale.

Gabel, bereitstellen, anpassen

• Geben Sie das Repository auf.
• Aktivieren Sie GitHub -Seiten in Einstellungen.
  • Klicken Sie auf Settings .
  • Gehen Sie zum Abschnitt Pages .
  • Wählen Sie Github Actions als Quelle.
    • Wenn Sie eine benutzerdefinierte Domäne verwenden, stellen Sie sicher, Enforce HTTPS aktiviert ist.
• Führen Sie den Workflow aus.
  • Klicken Sie auf Actions .
  • Akzeptieren Sie die Eingabeaufforderung. Dies ist nur einmal erforderlich, um Aktionen für Ihre Gabel zu ermöglichen.
  • Klicken Sie auf den Workflow mit dem Namen Deploy .
  • Klicken Sie auf Run workflow und dann noch einmal Run workflow .
• Nach einigen Sekunden startet ein neuer Deploy -Workflow. Klicken Sie darauf, um Details anzuzeigen.
• Nach Abschluss des Workflows, der ein paar Minuten dauert, wird die URL unter dem Auftrag desto deploy_to_github_pages angezeigt.

Sie können jetzt dockerfiles/debian_mini an Ihre Bedürfnisse anpassen oder eine neue Dockerfile von Grund auf neu erstellen. Verwenden Sie den Path to Dockerfile -Workflow -Parameter, um ihn auszuwählen.

Lokale Bereitstellung

Von einem lokalen git clone

• Laden Sie das Bild debian_mini ext2 von https://github.com/leaningtech/webvm/releases herunter
  • Sie können auch Ihre eigenen erstellen, indem Sie die Option "Workflow -Option" Github Release hochladen "auswählen
  • Platzieren Sie das Bild im Repository -Root -Ordner
• Bearbeiten config_github_terminal.js
  • Überzeugen Sie die Standardwerte für CMD , ARGS , ENV und CWD
  • Ersetzen Sie IMAGE_URL durch die URL (absolut oder relativ) für das Ext2 -Bild. Zum Beispiel "/debian_mini_20230519_5022088024.ext2"
• Build WebVM mit npm wird die Ausgabe im build -Verzeichnis platziert
  • npm install
  • npm run build
• Starten Sie Nginx, und zeigt automatisch auf das gerade erstellte build -Verzeichnis
  • nginx -p . -c nginx.conf
• Besuchen Sie http://127.0.0.1:8081 und genießen Sie Ihr lokales WebVM

Beispielanpassung: Python3 Repl

Der Deploy berücksichtigt die in der Dockerfile angegebene CMD . Um eine Wiederholung zu erstellen, können Sie diesen Patch einfach anwenden und bereitstellen.

 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" ]

Fehler und Probleme

Bitte verwenden Sie Probleme, um einen Fehler zu melden. Oder kommen Sie Hallo und teilen Sie Ihr Feedback zu Discord.

Weitere Links

• WebVM: serverlose x86 virtuelle Maschinen im Browser
• Webvm: Linux -Virtualisierung in der WebAssembly mit vollem Netzwerk über Tailscale
• Mini.Webvm: Ihre eigene Linux -Box von Dockerfile, virtualisiert im Browser über WebAssembly
• Referenzgithub -Seiten Bereitstellung: mini.webvm
• Basteln Sie das Unmögliche: X86 -Virtualisierung im Browser mit WebAssembly -Talk bei JSNation 2022

Dank...

Dieses Projekt hängt von:

• Cheerpx, hergestellt von Leaning Technologies für X86 Virtualisierung und Linux -Emulation
• Xterm.js, https://xtermjs.org/ für die Bereitstellung des webbasierten Terminalemulators
• Tailscale für die Netzwerkkomponente
• LWIP, für den TCP/IP -Stack, kompiliert für das Web über den Chef

Versioning

WebVM hängt von der Virtualisierungstechnologie von Cheerpx X86-zu-WebaSembly ab, die über NPM im Projekt enthalten ist.

Das NPM -Paket wird bei jeder Version aktualisiert.

Jeder Build ist unveränderlich, wenn eine bestimmte Version heute gut für Sie funktioniert, funktioniert sie für immer weiter.

Lizenz

WebVM wird unter der Apache -Lizenz, Version 2.0, veröffentlicht.

Sie können den Inhalt dieses Repositorys gerne verwenden, ändern und umverteilen.

Der öffentliche Cheerpx-Einsatz wird als IS bereitgestellt und kann von Einzelpersonen für technologische Erkundungen, Tests und Verwendung von Einzelpersonen verwendet werden . Jede andere Verwendung durch Organisationen, einschließlich gemeinnütziger Organisation, Wissenschaft und öffentlicher Sektor, erfordern eine Lizenz. Das Herunterladen eines Cheerpx -Builds, um ihn an anderer Stelle zu hosten, ist ohne kommerzielle Lizenz nicht zulässig.

Lesen Sie mehr über Chefx -Lizenzierung

Wenn Sie ein Produkt über Chefx/WebVM erstellen möchten, wenden Sie sich bitte an [email protected]