webvm

Webvm

Este repositório hospeda o código -fonte para https://webvm.io, uma máquina virtual Linux que é executada no seu navegador.

Experimente o novo ambiente gráfico alpino/xorg/i3: https://webvm.io/alpine.html

O WebVM é um ambiente virtual sem servidor, executando totalmente o lado do cliente no HTML5/WebAssembly. Ele foi projetado para ser compatível com o Linux. Ele executa uma distribuição debian não modificada, incluindo muitas cadeias de ferramentas de desenvolvimento nativo.

O WebVM é alimentado pelo mecanismo de virtualização do Cheerpx e permite a execução segura do lado do cliente em binários x86 em qualquer navegador. O Cheerpx inclui um compilador JIT x86-to-webassembly, um sistema de arquivos baseado em bloco virtual e um emulador de Syscall Linux.

Ativar rede de rede

Os navegadores modernos não fornecem APIs para usar diretamente o TCP ou o UDP. O WebVM fornece suporte de rede integrando com a escala TailScale, uma rede VPN que suporta o WebSockets como uma camada de transporte.

• Abra o painel "Networking" da barra lateral
• Clique em "Connect to TailScale" do painel
• Faça login na escala traseira (crie uma conta se não tiver uma)
• Clique em "Conectar" quando solicitado por escala traseira
• Se você não estiver familiarizado com a escala traseira ou deseja informações adicionais, consulte WebVM e escala traseira.

Garfo, implantar, personalizar

• Fork o repositório.
• Ativar páginas do Github nas configurações.
  • Clique nas Settings .
  • Vá para a seção Pages .
  • Selecione Github Actions como fonte.
    • Se você estiver usando um domínio personalizado, certifique -se de que Enforce HTTPS esteja ativada.
• Execute o fluxo de trabalho.
  • Clique em Actions .
  • Aceite o prompt. Isso é necessário apenas uma vez para ativar ações para o seu garfo.
  • Clique no fluxo de trabalho denominado Deploy .
  • Clique em Run workflow e mais uma vez Run workflow no menu.
• Depois de alguns segundos, um novo fluxo de trabalho Deploy será iniciado, clique nele para ver os detalhes.
• Após a conclusão do fluxo de trabalho, o que leva alguns minutos, ele mostrará o URL abaixo do trabalho deploy_to_github_pages .

Agora você pode personalizar dockerfiles/debian_mini para atender às suas necessidades ou fazer um novo Dockerfile do zero. Use o Path to Dockerfile Workflow para selecioná -lo.

Implantação local

De um git clone local

• Faça o download da imagem debian_mini Ext2 em https://github.com/leaningtech/webvm/releases/
  • Você também pode construir o seu próprio, selecionando a opção de fluxo de trabalho "upload github"
  • Coloque a imagem na pasta raiz do repositório
• Editar config_github_terminal.js
  • Descomamento Os valores padrão para CMD , ARGS , ENV e CWD
  • Substitua IMAGE_URL pelo URL (absoluto ou relativo) para a imagem ext2. Por exemplo "/debian_mini_20230519_5022088024.ext2"
• Construir webvm usando npm , a saída será colocada no diretório de build
  • npm install
  • npm run build
• Inicie o nginx, ele aponta automaticamente para o diretório build acabou de criar
  • nginx -p . -c nginx.conf
• Visite http://127.0.0.1:8081 e aproveite seu webvm local

Exemplo de personalização: python3 repl

O fluxo de trabalho Deploy leva em consideração o CMD especificado no Dockerfile. Para criar um REPL, você pode simplesmente aplicar este patch e implantar.

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

Bugs e problemas

Por favor, use problemas para relatar qualquer bug. Ou venha dizer olá / compartilhar seus comentários sobre a discórdia.

Mais links

• Webvm: Máquinas Virtuais X86 sem servidor no navegador
• Webvm: Virtualização do Linux em WebAssembly com redes completas via escala traseira
• Mini.Webvm: sua própria caixa Linux da Dockerfile, virtualizada no navegador via WebAssembly
• Páginas do Github de referência implantação: mini.webvm
• Criação do impossível: x86 Virtualização no navegador com o WebAssembly Talk no jsnation 2022

Graças a ...

Este projeto depende de:

• Cheerpx, fabricado por tecnologias de inclinação para a virtualização x86 e emulação de Linux
• xterm.js, https://xtermjs.org/, por fornecer o emulador de terminal baseado na Web
• Escala traseira, para o componente de rede
• LWIP, para a pilha TCP/IP, compilada para a web via Cheerp

Versão

O WebVM depende da tecnologia de virtualização Cheerpx x86-to-Webassembly, que está incluída no projeto via NPM.

O pacote NPM é atualizado em cada lançamento.

Toda construção é imutável, se uma versão específica funcionar bem para você hoje, continuará funcionando para sempre.

Licença

O WebVM é lançado sob a licença Apache, versão 2.0.

Você pode usar, modificar e redistribuir o conteúdo deste repositório.

A implantação pública de torcida é fornecida como é e é livre para usar para exploração, teste e uso tecnológico por indivíduos. Qualquer outro uso por organizações, incluindo sem fins lucrativos, academia e setor público, requer uma licença. O download de uma compilação Cheerpx com o objetivo de hospedá -lo em outro lugar não é permitido sem uma licença comercial.

Leia mais sobre o licenciamento da Cheerpx

Se você deseja construir um produto em cima do Cheerpx/Webvm, entre em contato: [email protected]