webvm

Webvm

Repositori ini meng -host kode sumber untuk https://webvm.io, mesin virtual Linux yang berjalan di browser Anda.

Coba Lingkungan Grafis Alpine/Xorg/I3 yang baru: https://webvm.io/alpine.html

WebVM adalah lingkungan virtual tanpa server yang menjalankan sepenuhnya sisi klien di HTML5/WebAssembly. Ini dirancang untuk menjadi kompatibel Linux Abi. Ini menjalankan distribusi Debian yang tidak dimodifikasi termasuk banyak alat pengembangan asli.

WebVM ditenagai oleh mesin virtualisasi Cheerpx, dan memungkinkan eksekusi binari x86 sisi klien yang aman dan sandbox di browser apa pun. Cheerpx mencakup kompiler JIT x86-to-webassembly, sistem file berbasis blok virtual, dan emulator Syscall Linux.

Aktifkan jaringan

Browser modern tidak menyediakan API untuk secara langsung menggunakan TCP atau UDP. WebVM menyediakan dukungan jaringan dengan mengintegrasikan dengan TailScale, jaringan VPN yang mendukung WebSockets sebagai lapisan transportasi.

• Buka panel "jaringan" dari batang samping
• Klik "Hubungkan ke Tailscale" dari panel
• Masuk ke Tailscale (Buat akun jika Anda tidak memilikinya)
• Klik "Hubungkan" saat diminta oleh TailScale
• Jika Anda tidak terbiasa dengan tailscale atau ingin informasi tambahan, lihat WebVM dan Tailscale.

Garpu, penyebaran, sesuaikan

• Garpu repositori.
• Aktifkan halaman github dalam pengaturan.
  • Klik pada Settings .
  • Pergi ke bagian Pages .
  • Pilih Github Actions sebagai sumber.
    • Jika Anda menggunakan domain kustom, pastikan Enforce HTTPS diaktifkan.
• Jalankan alur kerja.
  • Klik Actions .
  • Terima prompt. Ini hanya diperlukan sekali untuk mengaktifkan tindakan untuk garpu Anda.
  • Klik pada alur kerja bernama Deploy .
  • Klik Run workflow dan kemudian sekali lagi Run workflow di menu.
• Setelah beberapa detik, alur kerja Deploy baru akan dimulai, klik untuk melihat detailnya.
• Setelah alur kerja selesai, yang membutuhkan beberapa menit, itu akan menunjukkan URL di bawah pekerjaan deploy_to_github_pages .

Anda sekarang dapat menyesuaikan dockerfiles/debian_mini sesuai dengan kebutuhan Anda, atau membuat DockerFile baru dari awal. Gunakan parameter Path to Dockerfile Workflow untuk memilihnya.

Penempatan lokal

Dari git clone lokal

• Unduh gambar debian_mini ext2 dari https://github.com/leaningtech/webvm/releases/
  • Anda juga dapat membangun sendiri dengan memilih opsi alur kerja "Unggah Rilis GitHub"
  • Tempatkan gambar di folder root repositori
• Edit config_github_terminal.js
  • Unkcomment Nilai default untuk CMD , ARGS , ENV dan CWD
  • Ganti IMAGE_URL dengan URL (absolut atau relatif) untuk gambar Ext2. Misalnya "/debian_mini_20230519_5022088024.ext2"
• Bangun WebVM Menggunakan npm , Output akan ditempatkan di Direktori build
  • npm install
  • npm run build
• Mulai nginx, secara otomatis menunjuk ke direktori build yang baru saja dibuat
  • nginx -p . -c nginx.conf
• Kunjungi http://127.0.0.1:8081 dan nikmati webvm lokal Anda

Contoh Kustomisasi: Python3 repl

Alur kerja Deploy memperhitungkan CMD yang ditentukan dalam Dockerfile. Untuk membangun replikan, Anda cukup menerapkan tambalan ini dan menggunakan.

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

Bug dan masalah

Harap gunakan masalah untuk melaporkan bug apa pun. Atau datang untuk menyapa / bagikan umpan balik Anda tentang perselisihan.

Lebih banyak tautan

• WebVM: Mesin virtual server-less x86 di browser
• WebVM: Virtualisasi Linux di WebAssembly dengan jaringan penuh melalui TailScale
• Mini.webvm: Kotak Linux Anda sendiri dari DockerFile, tervirtualisasi di browser melalui WebAssembly
• Referensi Penyebaran Halaman GitHub: mini.webvm
• Crafting the Impossible: x86 Virtualisasi di browser dengan WebAssembly Talk di JSNation 2022

Berkat...

Proyek ini tergantung pada:

• Cheerpx, dibuat dengan cenderung teknologi untuk virtualisasi x86 dan emulasi linux
• xterm.js, https://xtermjs.org/, untuk menyediakan emulator terminal berbasis web
• Tailscale, untuk komponen jaringan
• LWIP, untuk tumpukan TCP/IP, disusun untuk web melalui Cheerp

Versi

WebVM tergantung pada teknologi virtualisasi Cheerpx x86-to-Webassembly, yang termasuk dalam proyek melalui NPM.

Paket NPM diperbarui pada setiap rilis.

Setiap bangunan tidak dapat diubah, jika versi tertentu bekerja dengan baik untuk Anda hari ini, itu akan terus bekerja selamanya.

Lisensi

WebVM dirilis di bawah lisensi Apache, versi 2.0.

Anda dipersilakan untuk menggunakan, memodifikasi, dan mendistribusikan kembali konten repositori ini.

Penyebaran Cheerpx Publik disediakan AS-IS dan bebas digunakan untuk eksplorasi teknologi, pengujian dan penggunaan oleh individu. Penggunaan lain oleh organisasi, termasuk nirlaba, akademisi dan sektor publik, membutuhkan lisensi. Mengunduh build cheerpx untuk tujuan menjadi hosting di tempat lain tidak diizinkan tanpa lisensi komersial.

Baca lebih lanjut tentang lisensi Cheerpx

Jika Anda ingin membangun produk di atas Cheerpx/WebVM, silakan hubungi: [email protected]