ما ستحصل عليه

• Podman وDocker وLXC - مثبّتة مسبقًا وجاهزة لحظة الإقلاع
• جهاز افتراضي حقيقي - Alpine Linux على نواة مخصصة عبر QEMU، أو AVF المعجّل بالعتاد على أجهزة pKVM المدعومة
• طرفية داخل التطبيق - دعم كامل لـ xterm-256color، و122 سمة لونية، و13 خطًا، وتغيير الحجم المباشر
• سطح مكتب X11 - شغّل تطبيقات Linux الرسومية في عارض مدمج مع اللمس ولوحة المفاتيح والفأرة والصوت
• تمرير USB، وSSH، وإعادة توجيه المنافذ، وجسر من الضيف إلى Android
• نسخ احتياطي للحاويات، وعرض مباشر لحالة الجهاز الافتراضي/الجهاز، ومشاركة مجلد التنزيلات مع الضيف
• الإنجليزية والصينية (中文)، دون صلاحيات root، وعلى أي جهاز arm64 يعمل بنظام Android 8 أو أحدث

البدء السريع

1. نزّل ملف APK وثبّته.
2. اضغط على Start VM، وانتظر ظهور Ready!، ثم افتح الطرفية.

# rootless containers, straight away
podman run --rm alpine echo "hello from a container"
docker run -d -p 8080:80 nginx

# expose that container to your phone and LAN, right from the VM shell
podroid-forward add 8080 8080 tcp     # TCP or UDP, on both the QEMU and AVF backends
curl http://<phone-ip>:8080
podroid-forward clean                 # remove every rule you added, in one go

# SSH in from your laptop (enable SSH in the setup wizard or Settings)
ssh root@<phone-ip> -p 9922        # password: podroid

# read this documentation with no network connection
podroid-forward add 9980 9980 tcp     # forward the docs port to the phone
podroid-docs                          # serves docs/guide at http://127.0.0.1:9980

الإعداد، والواجهتان الخلفيتان، والشبكات، وعارض X11، واستكشاف الأخطاء وإصلاحها كلها موجودة في التوثيق.

البناء

git clone https://github.com/ExTV/Podroid.git
cd Podroid
./build-all.sh all     # kernel, rootfs, QEMU and APK (needs Docker + Android SDK/NDK)

تفاصيل البناء لكل مكوّن وسلسلة الأدوات: CONTRIBUTING.md.

المساهمة

نرحّب بالمساهمات من أي حجم: تقارير الأخطاء، تعديلات إعدادات النواة، سمات جديدة، تحسينات واجهة المستخدم، إصلاحات إدخال X11، أي شيء.

• طلبات السحب: اقرأ CONTRIBUTING.md أولاً. أبقِ التغييرات محدودة النطاق، وشغّل ./build-all.sh test قبل الدفع، واشرح السبب في وصف طلب السحب.
• تقارير الأخطاء: افتح مشكلة مع ذكر جهازك وإصدار Android، وخطوات إعادة إنتاج قصيرة، وسجل التشخيص (الإعدادات ← تصدير سجل التشخيص في التطبيق).

مشاريع ذات صلة

RikkaHub Agent هو تفرّع من RikkaHub، عميل الدردشة LLM الأصلي لنظام Android، يحوّله إلى وكيل حقيقي على الجهاز: أكثر من 80 أداة للجهاز، ومهام مجدولة، ومتصفح مدعوم بالذكاء الاصطناعي، ومساحة عمل Linux، وSSH، وأتمتة الشاشة، وبوت Telegram عن بُعد، وكل ذلك اختياري. يمكن لأداة SSH الخاصة به تسجيل الدخول إلى جهاز Podroid VM قيد التشغيل (localhost:9922)، بحيث يستطيع وكيل على هاتفك بناء الحاويات وتشغيلها وفحصها دون أن تكتب أمرًا واحدًا.

شكر وتقدير

QEMU	محاكاة الآلة
Termux	محرك محاكي الطرفية
Alpine Linux	توزيعة الضيف

القائمة الكاملة في CREDITS.md.

الترخيص

GPLv2. إذا كان Podroid مفيدًا لك، فإن نجمة تساعد الآخرين على العثور عليه.