webvm

WebVM

يستضيف هذا المستودع الكود المصدري لـ https://webvm.io ، وهو جهاز افتراضي Linux يعمل في متصفحك.

جرب البيئة الرسومية Alpine/Xorg/I3 الجديدة: https://webvm.io/alpine.html

WebVM هي بيئة افتراضية أقل من الخادم تعمل من جانب العميل بالكامل في HTML5/Webassembly. إنه مصمم ليكون متوافقًا مع Linux ABI. يدير توزيع Debian غير المعدل بما في ذلك العديد من أدوات التنمية الأصلية.

يتم تشغيل WebVM بواسطة محرك المحاكاة الافتراضية Cheerpx ، ويمكّن من التنفيذ الآمن من جانب العميل من جانب العميل من ثنائيات X86 على أي متصفح. يتضمن Cheerpx مترجم X86 إلى Webassembly JIT ، ونظام ملفات قائم على الكتلة الظاهرية ، ومحاكي Linux Syscall.

تمكين الشبكات

لا توفر المتصفحات الحديثة واجهات برمجة التطبيقات لاستخدام TCP أو UDP مباشرة. يوفر WebVM دعم الشبكات من خلال الاندماج مع Tailscale ، وهي شبكة VPN التي تدعم WebSockets كطبقة نقل.

• افتح لوحة "الشبكات" من الشريط الجانبي
• انقر فوق "الاتصال بـ Tailscale" من اللوحة
• قم بتسجيل الدخول إلى Tailscale (قم بإنشاء حساب إذا لم يكن لديك حساب)
• انقر فوق "الاتصال" عندما تتم مطالبته بواسطة 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 Workflow لتحديدها.

النشر المحلي

من git clone محلي

• قم بتنزيل صورة debian_mini Ext2 من https://github.com/leaningtech/webvm/release/
  • يمكنك أيضًا إنشاء خيار سير العمل "تحميل GitHub Element"
  • ضع الصورة في مجلد جذر المستودع
• تحرير config_github_terminal.js
  • Uncomment القيم الافتراضية لـ 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

بفضل ...

يعتمد هذا المشروع على:

• Cheerpx ، مصنوعة من تقنيات الميل من أجل المحاكاة الافتراضية X86 ومضاهاة Linux
• Xterm.JS ، https://xtermjs.org/ ، لتوفير محاكي الطرفية المستندة إلى الويب
• Tailscale ، لمكون الشبكات
• LWIP ، لمكدس TCP/IP ، تم تجميعه للويب عبر Cheerp

الإصدار

يعتمد WebVM على تقنية المحاكاة الافتراضية لـ Cheerpx X86 إلى Webassembly ، والتي يتم تضمينها في المشروع عبر NPM.

يتم تحديث حزمة NPM على كل إصدار.

كل بناء غير قابل للتغيير ، إذا كان هناك إصدار محدد يعمل بشكل جيد لك اليوم ، فسيستمر في العمل إلى الأبد.

رخصة

يتم إصدار WebVM ضمن ترخيص Apache ، الإصدار 2.0.

اهلا وسهلا بكم في استخدام محتويات هذا المستودع وتعديله وإعادة توزيعه.

يتم توفير نشر CHERPX العام كما هو مجاني في الاستخدام للاستكشاف التكنولوجي والاختبار والاستخدام من قبل الأفراد. أي استخدام آخر من قبل المنظمات ، بما في ذلك الأوساط الأكاديمية غير الربحية والقطاع العام ، يتطلب ترخيصًا. لا يُسمح بتنزيل بناء Cheerpx لغرض استضافته في مكان آخر بدون ترخيص تجاري.

اقرأ المزيد عن ترخيص Chepx

إذا كنت ترغب في إنشاء منتج فوق Cheerpx/WebVM ، فيرجى الاتصال: [email protected]