webvm

WebVM

Этот репозиторий размещает исходный код для https://webvm.io, виртуальной машины Linux, которая работает в вашем браузере.

Попробуйте новую графическую среду Alpine/Xorg/i3: https://webvm.io/alpine.html

WebVM-это виртуальная среда без сервера, работающая полностью на стороне клиента в HTML5/Webassembly. Он разработан, чтобы быть совместимым с ABI Linux. Он управляет немодифицированным дистрибуцией Debian, включая множество нативных инструментов разработки.

WebVM оснащена двигателем виртуализации CERPX и обеспечивает безопасное выполнение на стороне песочницы на стороне клиента в любом браузере. CERPX включает в себя компилятор JIT x86-to-webassembly, файловую систему на основе виртуального блока и эмулятор Linux Syscall.

Включить сеть

Современные браузеры не предоставляют API для непосредственного использования TCP или UDP. WebVM обеспечивает сетевую поддержку, интегрируя с Tailscale, сетью VPN, которая поддерживает WebSockets в качестве транспортного уровня.

• Откройте панель «сетевой» с боковой палочки
• Нажмите «Подключиться к хвостовой клетке» с панели
• Войдите в Tailscale (создайте учетную запись, если у вас ее нет)
• Нажмите «Подключите», когда будет предложено Tailscale
• Если вы не знакомы с хвостом или хотите дополнительную информацию, см. WebVM и Tailscale.

Вилка, развернуть, настраивать

• Вилка репозитория.
• Включить страницы GitHub в настройках.
  • Нажмите на Settings .
  • Перейдите в раздел Pages .
  • Выберите Github Actions в качестве источника.
    • Если вы используете пользовательский домен, убедитесь, Enforce HTTPS включено.
• Запустите рабочий процесс.
  • Нажмите на Actions .
  • Принять подсказку. Это требуется только один раз, чтобы включить действия для вашей вилки.
  • Нажмите на рабочий процесс с именем Deploy .
  • Нажмите Run workflow , а затем снова Run workflow в меню.
• Через несколько секунд начнется новый рабочий процесс Deploy , нажмите на него, чтобы увидеть детали.
• После завершения рабочего процесса, который займет несколько минут, он покажет URL -адрес ниже задания deploy_to_github_pages .

Теперь вы можете настроить dockerfiles/debian_mini в соответствии с вашими потребностями, или сделать новый Dockerfile с нуля. Используйте параметр рабочего процесса Path to Dockerfile чтобы выбрать его.

Местное развертывание

От местного git clone

• Скачать изображение debian_mini Ext2 с https://github.com/leaningtech/webvm/releases/
  • Вы также можете создать свой собственный, выбрав вариант рабочего процесса «Загрузить GitHub».
  • Поместите изображение в корневую папку репозитория
• Редактировать config_github_terminal.js
  • Неудовлетворенные значения по умолчанию для CMD , ARGS , ENV и CWD
  • Замените IMAGE_URL на URL (абсолютный или относительный) для изображения EXT2. Например "/debian_mini_20230519_5022088024.ext2"
• Создайте WebVM с использованием npm , вывод будет размещен в каталоге build
  • npm install
  • npm run build
• Запустить Nginx, он автоматически указывает на только что созданный каталог build
  • nginx -p . -c nginx.conf
• Посетите http://127.0.0.1:8081 и наслаждайтесь местным WebVM

Пример настройки: Python3 Repl

Рабочий процесс Deploy учитывает CMD , указанный в Dockerfile. Чтобы построить реплику, вы можете просто применить этот патч и развернуть.

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

Ошибки и проблемы

Пожалуйста, используйте вопросы, чтобы сообщить о любой ошибке. Или приходите поздороваться / поделитесь своими отзывами о Discord.

Больше ссылок

• WebVM: виртуальные машины x86 без сервера в браузере
• WebVM: виртуализация Linux в Webassembly с полной сетью через Tailscale
• Mini.webvm: ваша собственная коробка Linux от Dockerfile, виртуализированная в браузере через Webassembly
• Справочные страницы GitHub развертывание: mini.webvm
• Создание невозможного: виртуализация x86 в браузере с Webassembly Talk на JSNation 2022

Благодаря...

Этот проект зависит от:

• CERPX, изготовленный с помощью технологий склонности к виртуализации x86 и эмуляции Linux
• XTERM.JS, https://xtermjs.org/, для предоставления веб-эмулятора терминала
• Хвостовой клет, для сетевого компонента
• Lwip, для стека TCP/IP, скомпилирован для Интернета через Carp

Версии

WebVM зависит от технологии виртуализации CERPX x86-to-webassembly, которая включена в проект через NPM.

Пакет NPM обновляется на каждом выпуске.

Каждая сборка неизменна, если конкретная версия подходит для вас сегодня, она будет продолжать работать навсегда.

Лицензия

WebVM выпускается по лицензии Apache, версия 2.0.

Вы можете использовать, изменять и перераспределять содержимое этого репозитория.

Общественное развертывание CERPX предоставляется как есть и может свободно использовать для технологических исследований, тестирования и использования отдельными лицами. Любое другое использование организациями, включая некоммерческие, академические круги и государственный сектор, требует лицензии. Загрузка сборки CERPX с целью размещения ее в другом месте не разрешена без коммерческой лицензии.

Узнайте больше о лицензировании CERPX

Если вы хотите создать продукт на вершине CERPX/WEBVM, свяжитесь с нами: [email protected]