webvm

WebVM

Este repositorio aloja el código fuente para https://webvm.io, una máquina virtual de Linux que se ejecuta en su navegador.

Pruebe el nuevo entorno gráfico Alpine/Xorg/i3: https://webvm.io/alpine.html

WebVM es un entorno virtual sin servidor que se ejecuta completamente el cliente en HTML5/WebAssembly. Está diseñado para ser compatible con Linux ABI. Ejecuta una distribución de Debian no modificada que incluye muchas cadenas de herramientas de desarrollo nativas.

WebVM funciona con el motor de virtualización CheerPX y permite una ejecución segura del lado del cliente de Sandbox de binarios X86 en cualquier navegador. CheerPX incluye un compilador JIT X86 a Webassembly, un sistema de archivos virtual basado en bloques y un emulador Syscall Linux.

Habilitar redes

Los navegadores modernos no proporcionan API para usar directamente TCP o UDP. WebVM proporciona soporte de redes al integrar con TailScale, una red VPN que admite WebSockets como una capa de transporte.

• Abra el panel "Networking" desde la barra lateral
• Haga clic en "Conectar a TailScale" en el panel
• Inicie sesión en TailScale (cree una cuenta si no tiene una)
• Haga clic en "Conectar" cuando se le solicite TailScale
• Si no está familiarizado con TailScale o desea información adicional, consulte WebVM y TailScale.

Bifurcarse, implementar, personalizar

• Bifurca el repositorio.
• Habilite las páginas de GitHub en la configuración.
  • Haga clic en Settings .
  • Ir a la sección Pages .
  • Seleccione Github Actions como fuente.
    • Si está utilizando un dominio personalizado, asegúrese de Enforce HTTPS esté habilitado.
• Ejecute el flujo de trabajo.
  • Haga clic en Actions .
  • Acepte el aviso. Esto se requiere solo una vez para habilitar acciones para su bifurcación.
  • Haga clic en el flujo de trabajo llamado Deploy .
  • Haga clic en Run workflow y luego, una vez más, Run workflow en el menú.
• Después de unos segundos, comenzará un nuevo flujo de trabajo Deploy , haga clic en él para ver los detalles.
• Después de que se complete el flujo de trabajo, que lleva unos minutos, mostrará la URL debajo del trabajo deploy_to_github_pages .

Ahora puede personalizar dockerfiles/debian_mini para satisfacer sus necesidades, o hacer un nuevo Dockerfile desde cero. Use la Path to Dockerfile Workflow Parameter para seleccionarlo.

Despliegue local

De un git clone local

• Descargue la imagen debian_mini ext2 de https://github.com/leaningtech/webvm/releases/
  • También puede construir la suya seleccionando la opción de flujo de trabajo "Subir GitHub"
  • Coloque la imagen en la carpeta raíz del repositorio
• Editar config_github_terminal.js
  • Descopment Los valores predeterminados para CMD , ARGS , ENV y CWD
  • Reemplace IMAGE_URL con la URL (absoluta o relativa) para la imagen Ext2. Por ejemplo "/debian_mini_20230519_5022088024.ext2"
• Build WebVM usando npm , la salida se colocará en el directorio build
  • npm install
  • npm run build
• Iniciar NGINX, apunta automáticamente al directorio build que acaba de crear
  • nginx -p . -c nginx.conf
• Visite http://127.0.0.1:8081 y disfrute de su WebVM local

Ejemplo de personalización: python3 repl

El flujo de trabajo Deploy tiene en cuenta el CMD especificado en DockerFile. Para construir una REPL, simplemente puede aplicar este parche e implementar.

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

Errores y problemas

Utilice problemas para informar cualquier error. O ven a decir hola / comparta sus comentarios sobre Discord.

Más enlaces

• WebVM: máquinas virtuales X86 sin servidor en el navegador
• WebVM: Virtualización de Linux en WebAssembly con redes completas a través de TailScale
• Mini.webvm: su propia caja de Linux de Dockerfile, virtualizada en el navegador a través de WebAssembly
• Implementación de páginas de Github de referencia: Mini.webvm
• Crafting the Impossible: X86 Virtualización en el navegador con WebAssembly Talk en JSNATION 2022

Gracias a...

Este proyecto depende de:

• CheerPX, realizada por Leaning Technologies para la virtualización X86 y la emulación de Linux
• Xterm.js, https://xtermjs.org/, por proporcionar el emulador terminal basado en la web
• Escala de cola, para el componente de redes
• LWIP, para la pila TCP/IP, compilada para la web a través de Cheerp

Versiones

WebVM depende de la tecnología de virtualización de CheerPX X86 a Webassembly, que se incluye en el proyecto a través de NPM.

El paquete NPM se actualiza en cada versión.

Cada construcción es inmutable, si una versión específica funciona bien para usted hoy, seguirá funcionando para siempre.

Licencia

WebVM se lanza bajo la licencia Apache, versión 2.0.

Puede usar, modificar y redistribuir el contenido de este repositorio.

El despliegue público de CheerPX se proporciona AS-IS y es gratuito para la exploración tecnológica, las pruebas y el uso por parte de las personas. Cualquier otro uso de organizaciones, incluidas la organización sin fines de lucro, la academia y el sector público, requiere una licencia. La descarga de una construcción de CheerPX con el fin de alojarlo en otro lugar no está permitido sin una licencia comercial.

Lea más sobre las licencias de CheerPX

Si desea crear un producto además de CheerPX/WebVM, póngase en contacto: [email protected]