webvm

webvm

このリポジトリは、ブラウザで実行されるLinux仮想マシンであるhttps://webvm.ioのソースコードをホストしています。

新しいAlpine/Xorg/i3グラフィカル環境をお試しください：https：//webvm.io/alpine.html

WebVMは、HTML5/WebAssemblyで完全にクライアント側を実行するサーバーのない仮想環境です。 Linux abi互換になるように設計されています。多くのネイティブ開発ツールチェーンを含む、変更されていないDebian分布を実行します。

WebVMは、CheerPX仮想化エンジンを搭載しており、ブラウザでX86バイナリの安全でサンドボックス化されたクライアント側の実行を可能にします。 CheerPXには、X86-to-Webassembly JITコンパイラ、仮想ブロックベースのファイルシステム、Linux Syscallエミュレーターが含まれています。

ネットワーキングを有効にします

最新のブラウザは、TCPまたはUDPを直接使用するAPIを提供しません。 WebVMは、輸送層としてWebSocketをサポートするVPNネットワークであるTailScaleと統合することにより、ネットワークサポートを提供します。

• サイドバーから「ネットワーク」パネルを開きます
• パネルから[テールスケールに接続]をクリックします
• テールスケールにログインします（アカウントがない場合はアカウントを作成します）
• テールスケールでプロンプトされたときは、「接続」をクリックします
• テールスケールに慣れていない場合、または追加情報が必要な場合は、WebVMとテールスケールを参照してください。

フォーク、展開、カスタマイズ

• リポジトリをフォークします。
• 設定でgithubページを有効にします。
  • Settingsをクリックします。
  • Pagesセクションに移動します。
  • ソースとしてGithub Actionsを選択します。
    • カスタムドメインを使用している場合は、 Enforce HTTPSが有効になっていることを確認してください。
• ワークフローを実行します。
  • Actionsをクリックします。
  • プロンプトを受け入れます。これは、フォークのアクションを有効にするために1回だけ必要です。
  • Deployという名前のワークフローをクリックします。
  • Run workflowをクリックして、メニューでRun workflow 。
• 数秒後に新しいDeployワークフローが起動します。クリックして詳細を確認します。
• 数分かかるワークフローが完了すると、 deploy_to_github_pagesジョブの下のURLが表示されます。

これで、 dockerfiles/debian_miniカスタマイズしてニーズに合わせたり、ゼロから新しいDockerFileを作成したりできます。 Path to Dockerfileを使用して選択します。

ローカル展開

ローカルgit cloneから

• https://github.com/leaningtech/webvm/releases/からdebian_mini ext2画像をダウンロード
  • 「アップロードGithubリリース」ワークフローオプションを選択して、独自に作成することもできます
  • 画像をリポジトリルートフォルダーに配置します
• config_github_terminal.jsを編集します
  • CMD 、 ARGS 、 ENV 、 CWDのデフォルト値
  • ext2画像のIMAGE_URLをURL（絶対または相対）に置き換えます。たとえば"/debian_mini_20230519_5022088024.ext2"
• npmを使用してビルドWebVMを使用して、出力がbuildディレクトリに配置されます
  • npm install
  • npm run build
• nginxを起動すると、作成されたばかりのbuildディレクトリを自動的に指します
  • nginx -p . -c nginx.conf
• http://127.0.0.1:8081にアクセスして、地元のWebVMをお楽しみください

カスタマイズの例：Python3 Repl

Deployワークフローでは、DockerFileで指定されたCMDを考慮します。 REPLを作成するには、このパッチを適用して展開するだけです。

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

バグと問題

問題を使用してバグを報告してください。または、Hello / Iscordに関するフィードバックを共有してください。

その他のリンク

• WebVM：ブラウザ内のサーバーレスx86仮想マシン
• WebVM：TailScale経由の完全なネットワークを備えたWebAssemblyのLinux仮想化
• mini.webvm：dockerfileからの独自のLinuxボックス、WebAssembly経由でブラウザで仮想化
• 参照githubページの展開：mini.webvm
• Impossibleを作成する：jsnation 2022でWebAssemblyを使用したブラウザでのx86仮想化

ありがとう...

このプロジェクトは次のことに依存します。

• X86仮想化とLinuxエミュレーションのためのLeaning Technologiesによって作られたCheerpx
• Xterm.js、https://xtermjs.org/、Webベースのターミナルエミュレーターを提供するため
• ネットワークコンポーネント用のテールスケール
• LWIP、TCP/IPスタック用、CheerpでWeb用にコンパイルされました

バージョン化

WebVMは、NPM経由でプロジェクトに含まれるCheerPX X86-to-Webassembly仮想化テクノロジーに依存しています。

NPMパッケージは、すべてのリリースで更新されます。

すべてのビルドは不変であり、特定のバージョンが今日あなたに適している場合、それは永遠に機能し続けるでしょう。

ライセンス

WebVMは、Apacheライセンスバージョン2.0の下でリリースされます。

このリポジトリのコンテンツを使用、変更、再配布することをお勧めします。

Public CheerPXの展開は、そのまま提供されており、個人による技術探査、テスト、使用に自由に使用できます。非営利団体、学界、公共部門を含む組織がその他の使用には、ライセンスが必要です。他の場所でホストする目的でCheerPXビルドをダウンロードすることは、商業ライセンスなしでは許可されていません。

CheerPXライセンスの詳細をご覧ください

Cheerpx/webvmの上に製品を構築したい場合は、ご連絡ください：[email protected]